Heplon

Connect Prometheus

This guide covers what to put into the connector form for Prometheus.

1. Find the API URL

Use the base URL of the Prometheus HTTP API, with no path. Heplon appends /api/v1/... itself.

https://prometheus.example.com

The URL must be reachable from the internet.

2. Decide whether you need to set a bearer token

Prometheus has no bearer-token authentication of its own. Leave the field blank when the URL points at Prometheus.

Since the Prometheus endpoint is reachable from the internet, the URL likely points at a proxy in front of Prometheus and it requires a bearer token. For example:

  • an authenticating reverse proxy (nginx, Envoy, oauth2-proxy) in front of Prometheus,
  • Thanos Query or Grafana Mimir behind such a proxy,

Heplon sends the token as Authorization: Bearer <token>. A service that expects basic auth or AWS SigV4 (Grafana Cloud, Amazon Managed Service for Prometheus) is currently not supported. We will add support once the first customer asks for it.

3. Fill in the form

In Heplon, open Connectors, select Add connector, then Prometheus.

FieldValue
Namean arbitrary name
API URLthe URL from step 1
Bearer tokenthe token (if any) from step 2

Prometheus is now connected to Heplon.