EN | CN

A blockchain monitoring system for CITA, using Prometheus to store the monitoring and performance metrics and Grafana to visualize these metrics.

Metrics are including blockchain data, process status, host info like CPU/memory/disk usage etc.

Summary Dashboard Demo

CITA Node Info Dashboard Demo

Host Info Dashboard Demo

RabbitMQ Dashboard Demo

• CITA service process monitoring
  • CITA microservices and RabbitMQ process running status, CPU, memory usage, IO
• Blockchain data health monitoring
  • block height history, block interval, block interval history, quota, transaction history volume, TPS, disk occupancy, data size growth trend
• Running environment monitoring
  • System load, CPU, memory, disk space usage, network traffic, TCP connections, etc.
• System warning notification
  • Alert Policies
  • Support email notification, Slack notification, SMS notification (Pro version)
• Node Network Monitoring (Pro version)
  • Number of connected nodes, network topology, geographic location, etc.
• Request Identity Sources & Rate Limiting (Pro version)
  • Identify request sources, tools, user agent; limit the amount of JSONRPC requests by IP address to defence malicious attack.
• JSONRPC interface call analysis (Pro version)
  • Statistical analysis of the request time and number of the RPC method

• Summary Dashboard
  • The latest block height for each node
  • Monitoring process status for each node
  • CPU usage for each node
  • Node list
• CITA Node Info Dashboard
  • CITA Meta Data - Chain configuration information，such as Chain Name, creation time, etc.
  • Chain Info - The latest block height, consensus node number, consensus node block history.
  • Node Info - More detailed about certain node, including block data, running environment, software information
• Host Info Dashboard
  • Host information running on certain node, including system load, CPU, memory, hard disk usage, network traffic
• Process Info Dashboard
  • Running status, CPU, memory, and IO of microservice process for certain node
• RabbitMQ Dashboard
  • Running status, channels, consumers, connections, queues of RabbitMQ

More details can be found in Monitoring Indicator Information

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Independencies and how to install them

• Docker: install Docker guide
• Python: install Python guide

For installing server, read server/README.md

For installing agent, read agent/README.md

• CITA-Monitor server
  • Prometheus Alertmanager: 1917
  • Prometheus Console: 1918
  • Grafana: 1919
• CITA-Monitor agent
  • agent_proxy_exporter：1920

open a new issue: https://github.com/cryptape/cita-monitor/issues/new

with your version info

Read docs/tech_stack.md to know the programming languages, frameworks, and tools that developers use to build this software.

git clone [email protected]:cryptape/cita-monitor.git

• coding style guide: Google Shell Style guide
• code formatter: shfmt -i 2 -ci, vscode extension: shell-format
• linter: ShellCheck, vscode extension: shell-format

• coding style guide: http://google.github.io/styleguide/pyguide.html
• code formatter: yapf
• linter: pylint

• coding style guide: https://github.com/Haufe-Lexware/docker-style-guide
• formatter: https://www.fromlatest.io/
• best-practices: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

• coding style guide: https://style-guides.readthedocs.io/en/latest/makefile.html
• tutorial: https://makefiletutorial.com/
• conventions: https://www.gnu.org/prep/standards/html_node/Makefile-Conventions.html
• best-practices: https://suva.sh/posts/well-documented-makefiles/

• coding style guide: https://prometheus.io/docs/practices/naming/

PENDING: Explain how to run the automated tests for this system

GitHub Flow, Understanding the GitHub flow

use git-style-guide for Branches, Commits,Messages, Merging

We use SemVer for versioning.

This project is licensed under the Apache 2.0 License

• Prometheus: https://prometheus.io/
• Prometheus node-exporter: https://github.com/prometheus/node_exporter
• Prometheus process-exporter: https://github.com/ncabatoff/process-exporter
• Prometheus rabbitmq-exporter: https://github.com/kbudde/rabbitmq_exporter
• CITA: http://docs.citahub.com
• Docker: https://www.docker.com/