prysm-pulse/shared/prometheus
terence tsao eea0160dd4
Reformat healthz message by adding a comma (#8472)
* Add comma

* Update shared/prometheus/service.go

Co-authored-by: Nishant Das <nishdas93@gmail.com>

* Update tests

* Apply suggestions from code review

* Update shared/prometheus/service_test.go

Co-authored-by: Nishant Das <nishdas93@gmail.com>
Co-authored-by: Raul Jordan <raul@prysmaticlabs.com>
Co-authored-by: prylabs-bulldozer[bot] <58059840+prylabs-bulldozer[bot]@users.noreply.github.com>
2021-02-18 16:31:16 +00:00
..
BUILD.bazel Stream Validator and Beacon Logs via gRPC Streams (#8150) 2020-12-18 18:03:24 +00:00
content_negotiation.go Update error usage patterns to go1.13+ (#7529) 2020-10-14 17:39:52 +00:00
logrus_collector_test.go Revert "Rename NewService to New (#8337)" (#8440) 2021-02-12 17:45:22 +00:00
logrus_collector.go Enforce error handling and checking type assertions (#5403) 2020-04-13 04:11:09 +00:00
README.md Added Prometheus Client and p2p Metrics (#673) 2018-11-15 07:54:45 -05:00
service_test.go Reformat healthz message by adding a comma (#8472) 2021-02-18 16:31:16 +00:00
service.go Reformat healthz message by adding a comma (#8472) 2021-02-18 16:31:16 +00:00
simple_server.go Properly log and handle HTTP server error (#2685) 2019-06-12 19:58:49 -04:00

How to monitor with prometheus

Prerequisites:

Start scrapping services

To start scrapping with prometheus you must create or edit the prometheus config file and add all the services you want to scrap, like these:

global:
  scrape_interval:     15s # By default, scrape targets every 15 seconds.

  # Attach these labels to any time series or alerts when communicating with
  # external systems (federation, remote storage, Alertmanager).
  external_labels:
    monitor: 'codelab-monitor'

# A scrape configuration containing exactly one endpoint to scrape:
# Here it's Prometheus itself.
scrape_configs:
  # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
  - job_name: 'prometheus'

    # Override the global default and scrape targets from this job every 5 seconds.
    scrape_interval: 5s

    static_configs:
      - targets: ['localhost:9090']
+  - job_name: 'beacon-chain'
+    static_configs:
+      - targets: ['localhost:8080']

After creating/updating the prometheus file run it:

$ prometheus --config.file=your-prometheus-file.yml

Now, you can add the prometheus server as a data source on grafana and start building your dashboards.

How to add additional metrics

The prometheus service export the metrics from the DefaultRegisterer so just need to register your metrics with the prometheus or promauto libraries. To know more Go application guide