Skip to main content
Version: nightly

Prometheus

GreptimeCloud with GreptimeDB is fully compatible with Prometheus. This ensures a seamless transition, allowing you to use GreptimeCloud as a direct replacement for Prometheus. For more details, please refer to the Prometheus documentation in the GreptimeDB user guide.

Prometheus Remote Write

GreptimeCloud instance can be configured as a Prometheus remote write endpoint.

Append the following section to your Prometheus configuration.

remote_write:
- url: https://<host>/v1/prometheus/write?db=<dbname>
basic_auth:
username: <username>
password: <password>

Prometheus HTTP API and PromQL

Directly access this database through Prometheus API endpoint:

  • URL root: https://<host>/v1/prometheus
  • Database name: include HTTP header x-greptime-db-name with value <dbname>
  • Authentication: utilize Basic authentication using the instance's username and password

This is an example of invoking the Prometheus HTTP API to ping:

curl -X GET \
-H "x-greptime-db-name: <dbname>" \
-u "<username>:<password>" \
"https://<host>/v1/prometheus/api/v1/query?query=1"

GreptimeDB supports PromQL (Prometheus Query Language). This means that you can use GreptimeDB as a drop-in replacement for Prometheus, with Grafana or any other tools.

Please refer to PromQL for more details.