Skip to main content
What you’ll get: ewake can query your VictoriaMetrics data with PromQL to retrieve metrics, detect anomalies, and correlate data points with alerts and deployments, without requiring manual query construction.

​
Prerequisites

  • A Grafana instance (Cloud or self-hosted) with a VictoriaMetrics data source already configured
  • Admin access to create a Service Account in Grafana
Ewake reads VictoriaMetrics through your Grafana data source proxy, so you connect Grafana once rather than exposing VictoriaMetrics directly. Ewake resolves the data source automatically.

​
Configuration

1

Create a Service Account in Grafana

In Grafana, go to Administration → Service Accounts → click Add service account.Set the role to Viewer, ewake only needs read access.Once the account is created, click Add service account token → copy the token immediately.
Copy the token now, you won’t be able to see it again after closing the modal.
2

Get your Grafana instance URL

Grafana Cloud: Your instance URL follows the format https://yourorg.grafana.net.Self-hosted: Use the base URL of your Grafana instance (e.g. https://grafana.yourcompany.com).
3

Open the VictoriaMetrics integration in ewake

In your ewake dashboard, go to Integrations → VictoriaMetrics → click Connect with API key.Connect to VictoriaMetrics modal in ewake
4

Enter your credentials

5

Test and save

Click Test connection to verify the connection, then click Save.
VictoriaMetrics is connected. Ewake can now query your metrics during investigations.

​
Behind Cloudflare Access or a proxy

If your Grafana instance sits behind an authenticating proxy, add the credentials it expects under Custom headers in the same dialog. For a Cloudflare Access service token that means two headers: Ewake sends these with every request. Values are stored encrypted, and are not shown again after saving, leaving the fields empty when you edit the connection keeps the headers you already saved.
Without this, a connection test against a proxied endpoint fails with an authentication or redirect error even though the URL and API key are both correct. It’s the most common cause of a test failing on a working instance.
Ewake uses read-only PromQL queries. It never writes metrics or modifies your VictoriaMetrics or Grafana configuration.