prometheus-packet-sd

A service discovery for the Packet platform compatible with Prometheus.

It's based on the Scaleway adapter.

How it works

This service gets the list of servers from the Packet API and generates a file which is compatible with the Prometheus file_sd mechanism.

Pre-requisites

You need your Packet Auth token. You can create the token in the Packet web app, click on your profile photo and navigate to "API Keys".

Make sure the Packet Auth Token is in envvar PACKET_AUTH_TOKEN.

Installing it

Download the binary from the Releases page.

Running it

$ ./prometheus-packet-sd --packet.projectid 508b7fd3-0df2-4837-b0df-65aaf09f642a

You can also pass the project ID in envvar PACKET_PROJECT_ID.

Integration with Prometheus

Here is a Prometheus scrape_config snippet that configures Prometheus to scrape node_exporter assuming that it is deployed on all your Packet servers.

TODO: update this section

- job_name: node

  # Assuming that prometheus and prometheus-packet-sd are started from the same directory.
  file_sd_configs:
  - files: [ "./packet.json" ]

  # The relabeling does the following:
  # - overwrite the scrape address with the node_exporter's port.
  # - strip leading commas from the tags label.
  # - save the facility label
  # - save the hostname label
  relabel_configs:
  - source_labels: [__meta_packet_public_ipv4]
    replacement: "${1}:9100"
    target_label: __address__
  - source_labels: [__meta_packet_tags]
    regex: ",(.+),"
    target_label: tags
  - source_labels: [__meta_packet_facility]
    target_label: facility
  - source_labels: [__meta_packet_hostname]
    target_label: hostname

The following meta labels are available on targets during relabeling at the moment:

• __meta_packet_billing_cycle
• __meta_packet_facility
• __meta_packet_hostname
• __meta_packet_plan
• __meta_packet_private_ipv4
• __meta_packet_public_ipv4
• __meta_packet_public_ipv6
• __meta_packet_state
• __meta_packet_tags
• __meta_packet_project_id
• __meta_packet_project_name
• __meta_packet_organization_id
• __meta_packet_organization_name
• __meta_packet_operating_system

Contributing

PRs and issues are welcome.

License

Apache License 2.0, see LICENSE.