Quick Setup

GreptimeCloud with GreptimeDB is fully compatible with Prometheus. This means that you can seamlessly use GreptimeCloud as a replacement for Prometheus. For more information, please refer to the Prometheus documentation in the GreptimeDB user guide.

Remote Write and Read

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

Add the following section to your prometheus configuration.

  1. remote_write:
  2. - url: https://<host>/v1/prometheus/write?db=<dbname>
  3. basic_auth:
  4. username: <username>
  5. password: <password>
  6. remote_read:
  7. - url: https://<host>/v1/prometheus/read?db=<dbname>
  8. basic_auth:
  9. username: <username>
  10. password: <password>

Rule Management

Each GreptimeCloud service comes with a git repository for storing prometheus rules and configurations. By checking your rules, GreptimeCloud’s prometheus-compatible rule engine evaluates your rules against data stored in the database and emits alert when matches. For more details, please refer to Rule Management.

  1. git clone https://<host>/promrules/git/<dbname>.git
  2. # Copy your prometheus.yml and rules into this repo, and commit them
  3. git add .
  4. git commit -m "sync prometheus configuration"
  5. git push

PromQL

GreptimeDB supports PromQL (Prometheus Query Language). This means that you can use GreptimeDB as a drop-in replacement for Prometheus. Please refer to PromQL for more details.