Hyperledger Fabric是强调运维的区块链,Fabric自1.4版本开始就包含了用于peer和orderer节点运维的特性。本教程将介绍如何配置Fabric网络节点的运维管理服务,以及如何使用Prometheus和statsD/Graphite来可视化监控Hyperledger Fabric网络中各节点的实时运行指标。linux
相关教程: Fabric区块链Java开发详解 | Fabric区块链Node.JS开发详解git
Hyperledger Fabric 1.4提供了以下的特性用于peer和orderer节点的运维服务API:github
配置Fabric区块链节点的运维服务虽然不是尖端的火箭科技,可是若是你漏掉了某些细节也会以为不那么容易。docker
首先修改core.yaml来配置peer节点的运维服务,主要包括监听地址的配置和TLS的配置(咱们先暂时禁用这部分)。json
用编辑器打开core.yaml:api
$ vi ~/fabric-samples/config/core.yaml
下图显示了peer节点的运维服务监听地址listenAddress
的默认值:bash
如今让咱们启动BYFN网络,并试着访问日志等级api。网络
$ cd ~/fabric-samples/first-network $ ./byfn.sh -m up $ docker exec -it cli bash # curl peer0.org1.example.com:9443/logspec
不幸的是,curl命令返回以下错误:app
curl: (7) Failed to connect to peer0.org1.example.com port 9443: Connection refused
让咱们看看究竟是什么缘由。运维
首先检查咱们的运维服务配置,打开core.yaml文件:
# vi /etc/hyperledger/fabric/core.yaml
可能你还记得,咱们使用127.0.0.1做为listenAddress的值,这意味着 从外部没法访问运维api。
让咱们在peer容器内进行必要的操做以再次检查。此次咱们将使用wget代替 curl,由于在容器内没有安装curl。
$ docker exec -it peer0.org1.example.com bash # wget peer0.org1.example.com:9443/logspec
和预期的同样,错误信息再次出现:
Connecting to peer0.org1.example.com (peer0.org1.example.com)… failed: Connection refused
可是若是用127.0.0.1来链接就会成功:
# wget 127.0.0.1:9443/logspec
结果以下:
这标明咱们须要设置运维的监听地址。
为此,修改docker-compose文件,为每一个peer指定CORE_OPERATIONS_LISTENADDRESS环境变量。
$ vi ~/fabric-samples/first-network/base/docker-compose-base.yaml
参考下图进行修改:
如今让咱们再次尝试访问/logspec这个API,别忘了从新启动BYFN网络。
$ docker exec -it cli bash # curl peer0.org1.example.com:9443/logspec
输出结果以下:
相似的,咱们能够检查节点健康情况:
# curl peer1.org1.example.com:9443/healthz
输出结果以下:
最后,让咱们在docker-compose-base.yaml中为每一个peer设置ORE_METRICS_PROVIDER=prometheus
来启用prometheus指标,并修改core.yaml来声明指标提供器为prometheus:
若是配置正确,在cli容器内执行以下命令后将会输出一组监控指标的当前值:
首先下载最新版本的Prometheus并解压:
$ curl -LO https://github.com/prometheus/prometheus/releases/download/v2.7.1/prometheus-2.7.1.linux-amd64.tar.gz \ $ tar -xvzf prometheus-2.7.1.linux-amd64.tar.gz
在prometheus文件夹中能够找到prometheus.yml文件。咱们须要修改这个文件以便抓取Hyperledger Fabric的运行指标数据:在scrape_configs部分添加job_name和targets。
如今咱们能够用docker来运行prometheus:
$ sudo docker run -d --name prometheus-server -p 9090:9090 \ --restart always \ -v /home/mccdev/prometheus/prometheus/prometheus.yml:/prometheus.yml \ prom/prometheus \ --config.file=/prometheus.yml
注意因为docker老是在专用网络启动容器,咱们须要将prometheus容器加入fabric网络。用以下命令查看fabric网络:
$ docker inspect peer1.org1.example.com
将prometheus容器接入fabric网络:
$ sudo docker network connect net_byfn 5b8cbf9d8fa6
能够在以下地址访问统计信息:http://localhost:9090/
要检查是否成功抓取了peer的运行指标,输入scrape_samples_scraped查看结果表,内容应该非空。
如今咱们换StatsD来可视化监控Fabric网络的运行指标,Prometheus是pull方式,而StatsD则采用push方式。
首先,咱们须要先从这里获取Graphite和StatsD的docker镜像。
而后,启动graphite容器:
$ docker run -d\ --name graphite\ --restart=always\ -p 80:80\ -p 2003-2004:2003-2004\ -p 2023-2024:2023-2024\ -p 8125:8125/udp\ -p 8126:8126\ graphiteapp/graphite-statsd
如今该修改docker-copose-base.yaml了。每一个peer都应该设置以下的环境变量:
CORE_OPERATIONS_LISTENADDRESS CORE_METRICS_PROVIDER CORE_METRICS_STATSD_ADDRESS CORE_METRICS_STATSD_NETWORK CORE_METRICS_STATSD_PREFIX
咱们也应当确保指定端口8125。peer的配置示例以下:
peer0.org1.example.com: container_name: peer0.org1.example.com extends: file: peer-base.yaml service: peer-base environment: - CORE_PEER_ID=peer0.org1.example.com - CORE_PEER_ADDRESS=peer0.org1.example.com:7051 - CORE_PEER_GOSSIP_BOOTSTRAP=peer1.org1.example.com:7051 - CORE_PEER_GOSSIP_EXTERNALENDPOINT=peer0.org1.example.com:7051 - CORE_PEER_LOCALMSPID=Org1MSP # metrics - CORE_OPERATIONS_LISTENADDRESS=peer0.org1.example.com:8125 - CORE_METRICS_PROVIDER=statsd - CORE_METRICS_STATSD_ADDRESS=graphite:8125 - CORE_METRICS_STATSD_NETWORK=udp - CORE_METRICS_STATSD_PREFIX=PEER_01 volumes: - /var/run/:/host/var/run/ - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/msp:/etc/hyperledger/fabric/msp - ../crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls:/etc/hyperledger/fabric/tls - peer0.org1.example.com:/var/hyperledger/production ports: - 7051:7051 - 7053:7053 - 8125:8125
须要留意使用的端口:对于peer0,端口应当是8125:8125,peer1则应当使用9125:8125,依此类推。
Orderer应当按以下配置:
- ORDERER_OPERATIONS_LISTENADDRESS=orderer.example.com:8125 - ORDERER_METRICS_PROVIDER=statsd - ORDERER_METRICS_STATSD_ADDRESS=graphite:8125 - ORDERER_METRICS_STATSD_NETWORK=udp - ORDERER_METRICS_STATSD_PREFIX=ORDERER ports: - 7125:8125
如今让咱们启动BYFN网络。
记得将graphite容器接入BYFN网络,不然你会看到以下错误:
Error: error getting endorser client for channel: endorser client failed to connect to peer0.org1.example.com:7051: failed to create new connection: context deadline exceeded
peer容器的日志将显示在网络中没有找到graphite:
Error: failed to initialize operations subystems: dial udp: lookup graphite on 127.0.0.11:53: no such host
使用以下命令将graphite容器接入fabric网络:
$ sudo docker network connect net_byfn graphite
一切正常的话,你应该能够在以下地址看到运行指标:
http://localhost/metrics/index.json
结果以下:
访问以下地址来查看可视化的数据:
http://localhost/
结果页面以下:
在这个教程中,咱们学习了如何配置hyperledger Fabric的节点的运维服务API,以及如何使用Prometheus或StatsD来可视化监控Hyperledger Fabric的运行状况。若是你但愿继续深刻学习Hyperledger Fabric区块链链码及应用的开发,能够参考这两个在线互动教程: