README
¶
Prometheus Scaleway SD
This project provides a server to automatically discover nodes within your Scaleway account in a Prometheus SD compatible format.
Install
You can download prebuilt binaries from our GitHub releases, or you can use our Docker images published on Docker Hub.
Integration
Available labels
The following list of meta labels can be used to relabel your scrape results entirely. Hopefully the names are self-explaining, that's why I have skipped a description for each label.
__meta_scaleway_name__meta_scaleway_id__meta_scaleway_arch__meta_scaleway_image_id__meta_scaleway_image_name__meta_scaleway_public_ipv4__meta_scaleway_state__meta_scaleway_private_ipv4__meta_scaleway_hostname__meta_scaleway_org__meta_scaleway_commercial_type__meta_scaleway_platform__meta_scaleway_hypervisor__meta_scaleway_node__meta_scaleway_blade__meta_scaleway_chassis__meta_scaleway_cluster__meta_scaleway_zone
Prometheus config
Here you get a snippet for the Prometheus scrape_config that configures Prometheus to scrape node_exporter assuming that it is deployed on all your servers.
- job_name: node
file_sd_configs:
- files: [ "/etc/prometheus/scw.json" ]
relabel_configs:
- source_labels: [__meta_scaleway_public_ipv4]
replacement: "${1}:9100"
target_label: __address__
- source_labels: [__meta_scaleway_zone]
target_label: datacenter
- source_labels: [__meta_scaleway_name]
target_label: instance
Development
Make sure you have a working Go environment, for further reference or a guide take a look at the install instructions. This project requires Go >= v1.8.
go get -d github.com/promhippie/prometheus-scw-sd
cd $GOPATH/src/github.com/promhippie/prometheus-scw-sd
# install retool
make retool
# sync dependencies
make sync
# generate code
make generate
# build binary
make build
./bin/prometheus-scw-sd -h
Security
If you find a security issue please contact thomas@webhippie.de first.
Contributing
Fork -> Patch -> Push -> Pull Request
Authors
License
Apache-2.0
Copyright
Copyright (c) 2018 Thomas Boerger <thomas@webhippie.de>
Directories