prometheus/

README

Prometheus monitoring for Kitex

English | 中文

Usage Example

Simple mode

Server

See simple/server

Client

See simple/client

Custom mode

Server

See custom/server

Client

See custom/client

HOW-TO-RUN

1. install docker and start docker

2. change {{ INET_IP }} to local ip in prometheus.yml

3. run Prometheus and Grafana
   docker-compose up

4. run Kitex server
   go run simple/server/main.go

5. run Kitex client
   go run simple/client/main.go

6. visit http://localhost:3000, the account password is admin by default

7. configure Prometheus data sources

   1. Connection
   2. Add new connection
   3. Select Prometheus and fill the URL with http://prometheus:9090
   4. click Save & Test after configuration to test if it works

8. add dashboard Create -> dashboard, add monitoring metrics such as throughput and pct99 according to your needs.

   for example:

   • server throughput of succeed requests

   sum(rate(kitex_server_throughput{statusCode="200"}[1m])) by (method)

   • server latency pct99 of succeed requests

   histogram_quantile(0.9,sum(rate(kitex_server_latency_us_bucket{status="succeed"}[1m]))by(le)) / 1000

For more information about kitex monitoring, please click monitoring