eos_exporter

CERN EOS metrics exporter for Prometheus

Usage

• Compile (Go >=1.18 environment needed)

cd eos_exporter
./get_build_info.sh
go build

• There is also a Makefile available that can be launched in the following way:

make build

• Run on EOS headnode.

./eos_exporter -eos-instance="<eos_instance>"

This variable is used to populate internal cluster label. Will be deprecated, global labels can serve the same purpose. Actual MGM to connect is gathered from EOS_MGM_URL in EOS configuration.

• By default, the exporter exposes the metrics on the port 9986 and url /metrics.
  • Change the port with the argument -listen-address
  • Change the url with -telemetry-path
• For more options, use --help

Prometheus example configuration

- job_name: eos
  scrape_interval: 30s
  static_configs:
  - targets:
    - eosheadnode.domain.com:9986

CERN Grafana Dashboard

We are providing the dashboard that we use in CERN instances. It is provided as is, so some modifications would be needed to adapt to external deployments. The dashboard expects a variable called instance that is used to filter using the cluster label. Create the variable in Grafana using the query label_values(cluster). It also includes plots for node_exporter metrics, if available.

Troubleshooting

This tool is provided by CERN EOS Operators. Report issues on Github tracker or contact us through the EOS community forum