mirror of
https://github.com/hyperledger/fabric-samples.git
synced 2026-06-20 16:45:09 +00:00
77431f5b39
Signed-off-by: fraVlaca <ocsenarf@outlook.com> added promethesus-grafana server to test-network Signed-off-by: fraVlaca <ocsenarf@outlook.com> changed image for cadvisor to version that works on Linux Signed-off-by: fraVlaca <ocsenarf@outlook.com> improved documentation on README and tweaked docker-compose file Signed-off-by: fraVlaca <ocsenarf@outlook.com> updated and fixed documentation for the prometheus/grafana sample for the test-network Signed-off-by: fraVlaca <ocsenarf@outlook.com> final modification to grafana dashboard and prom/graf docs Signed-off-by: fraVlaca <ocsenarf@outlook.com>
49 lines
2.8 KiB
Markdown
49 lines
2.8 KiB
Markdown
# Description
|
|
|
|
This sample provides an environment to display and capture metrics from the test-network in real time. It consists of a docker-compose file that starts a prometheus and grafana server setup configured to collect and display metrics for the test network.
|
|
|
|
# Requirements
|
|
|
|
This sample has been tested and is recomended to be used on **linux** in order to fully benefit from its capabilities, however it can be deployed and works on MacOS-intel machine as well (some modification to the cadvisor docker image and related queries are required to show docker containers metrics).
|
|
You will need to have installed **docker-compose with version 1.29 or above** (note that this is higher than the v1.14 requirement requested for the test-network).
|
|
|
|
# How to use
|
|
|
|
1. Go to the test-network directory and run bring up the test-network **./network.sh up createChannel**
|
|
2. Bring up the Prometheus/Grafana network in the test-network/prometheus-grafana directory and run **docker-compose up -d**
|
|
3. Log in: type “localhost:3000” on your web browser -> username=“admin”, password=“admin” -> set a new password
|
|
4. Browse dashboard and analyse results
|
|
- The default dashboard "HLF Performances Review" can be found and displayed by hovering over the dashboard menu and clicking on the browse button.
|
|
![picture alt]("https://user-images.githubusercontent.com/86831094/149115445-5e5f6d95-ecc3-4b46-aadb-5c01148770b3.png "Title is optional")
|
|
Once opened the dashboard, to display the collected metrics and data, adjust the timeframe on the top right to focus on the latest timespan when the network was up.
|
|
5. Deploy a chaincode (i.e. "./network.sh deployCC -ccn basic -ccp ../asset-transfer-basic/chaincode-go -ccl go"), start using the test-network and use the grafana dashboard to analyse and assess your network performances.
|
|
Extras: add new queries, modify dashboard & add relevant changes to main repo --> extract json and add it to "grafana/dashboards/hlf-performances.json".
|
|
Metrics can also be displayed directly from Prometheus by going to "localhost:9090".
|
|
|
|
# Docker Compose
|
|
|
|
Brings up
|
|
- a prometheus sever (port 9090) -> pulls metrics from peers, orderer, system(node exporter) and containers(cadvisor)
|
|
- grafana sever (port 3000) -> collects and display data from prometheus
|
|
- node exporter (port 9100) -> exposes systems metrics
|
|
- cadvisor (port 8080) -> exposes docker containers metrics
|
|
|
|
# Prometheus "configuration file"
|
|
|
|
**Prometheus.yml**
|
|
|
|
Fabric metrics targets:
|
|
- peer0.org1.example.com:9444
|
|
- peer0.org2.example.com:9445
|
|
- orderer.example.com:9443
|
|
|
|
System and docker metrics targets:
|
|
- cadvisor:8080
|
|
- node-exporter:9100
|
|
|
|
Check the state of the connections with targets on http://localhost:9090/targets.
|
|
|
|
# Sources
|
|
|
|
Prometheus docs: https://prometheus.io/docs/introduction/overview/
|
|
Grafana docs: https://grafana.com/docs/
|