generated from adoralaura/template-exporter
68 lines
2.3 KiB
Markdown
68 lines
2.3 KiB
Markdown
# Template Exporter
|
|
|
|
This repository is a template repository for @adoralaura. It's used to easily implement (small) Prometheus Exporters.
|
|
|
|
If you run into issues you may inform @adoralaura, but know that you use this template on your own risk!
|
|
|
|
# Usage
|
|
|
|
## Installation
|
|
|
|
Pre-built docker images can be found at [Docker Hub](https://hub.docker.com/r/lauralani/template-exporter). A sample `docker-compose.yml` can be [found here](docker-compose.yml).
|
|
|
|
Binaries can be built by cloning this repository and run `go build main.go` with [Golang](https://go.dev/) installed.
|
|
|
|
## Running
|
|
|
|
Start `template-exporter` as a daemon or from CLI:
|
|
|
|
```sh
|
|
./template-exporter
|
|
```
|
|
|
|
Visit <http://localhost:43609/metrics?target=203.0.113.8> where `203.0.113.8` is the IP
|
|
of the NTP server you want to get the score from.
|
|
|
|
## Prometheus Configuration
|
|
|
|
The URL parameter `target` can be controlled through relabelling.
|
|
|
|
Example config:
|
|
```YAML
|
|
scrape_configs:
|
|
- job_name: 'template'
|
|
static_configs:
|
|
- targets:
|
|
- 203.0.113.8 # change this
|
|
- 2003:db8::1 # change this
|
|
relabel_configs:
|
|
- source_labels: [__address__]
|
|
target_label: __param_target
|
|
- source_labels: [__param_target]
|
|
target_label: instance
|
|
- target_label: __address__
|
|
replacement: 127.0.0.1:43609 # The template exporter's real hostname:port.
|
|
```
|
|
|
|
Similarly to [blackbox_exporter](https://github.com/prometheus/blackbox_exporter),
|
|
`template-exporter` is meant to run on a few central machines and can be thought of
|
|
like a "Prometheus proxy".
|
|
|
|
### TLS and basic authentication
|
|
|
|
The Template Exporter does **not** support TLS and basic authentication yet.
|
|
This may be added in a future release.
|
|
|
|
# Once you have it running
|
|
|
|
It can be opaque to get started with all this. To make it
|
|
easier for others, please consider contributing back your configurations to
|
|
us.
|
|
|
|
# Contributing
|
|
If you have any ideas, enhancements, bug reports or general questions, please don't hesitate to [create a new issue](https://gitlab.com/adoralaura/template-exporter/-/issues/new).
|
|
|
|
If you want to contribute to this project, please read the [Contribution Guidelines](CONTRIBUTING.md)
|
|
|
|
# License
|
|
This project is available under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). See the LICENSE file for more info.
|