sla_exporter
- The GitHub repo can be found at: https://github.com/slashdoom/sla_exporter
Prometheus exporter for SLA-like metrics. Currently supported are: cURL (http/https), DNS, Ping (ICMP) and TCPing.
Similar in a lot of way to Blackbox Exporter, and honestly most people will probably be better served by this. This exporter was desgined to be a bit more basic as it was intended to be run on teleoperated forklifts and the operator stations for them.
Flags
| Name | Description | Default |
|---|---|---|
| version | Print version information. | |
| web.listen-address | Address on which to expose metrics and web interface. | :9909 |
| web.telemetry-path | Path under which to expose metrics. | /metrics |
| level | Set logging verbose level. | info |
| timeout | Global default test timeout. | 5 |
| config.file | Path to config file (required). | ./config.yaml |
Install
go get -u github.com/slashdoom/sla_exporter
Usage
Binary
./sla_exporter -config.file=config.yml
Docker
An example Docker compose file is included. It includes services for production, with 2 step build/deploy and Promethus container and one for a dev environment with hot reload. These examples use the golang:alpine image.
Production
docker compose up prometheus sla_exporter
Development
docker compose up prometheus-dev sla_exporter-dev
Config file
The exporter can be configured with a YAML based config file:
---
level: debug
timeout: 5s
web:
listen_address: 9909
metrics_path: "/metrics"
curl_tests:
- url: "http://example.com"
timeout: 5s
- url: "https://example.com"
timeout: 5s
- url: "https://slashdoom.com"
timeout: 5s
dns_tests:
- host: "example.com"
timeout: 5s
- host: "example.com"
server: "9.9.9.9"
timeout: 5s
- host: "example.com"
server: "8.8.8.8"
timeout: 5s
- host: "slashdoom.com"
timeout: 5s
ping_tests:
- host: "example.com"
count: 3
timeout: 5s
- host: "slashdoom.com"
count: 3
timeout: 5s
tcping_tests:
- host: "example.com"
port: 80
timeout: 5s
- host: "example.com"
port: 443
timeout: 5s
- host: "slashdoom.com"
port: 443
timeout: 5s
Third Party Components
This software uses components of the following projects
- Prometheus Go client library (https://github.com/prometheus/client_golang)
- zap Logging library (https://github.com/uber-go/zap)
License
(c) slashdoom (Patrick Ryon), 2024. Licensed under MIT license.