Quickstart

Ten minutes from an empty org to a dashboard on your phone. You need a Kubernetes cluster with Prometheus already scraping it, Helm 3, and the iOS app.

1. Create your org

Sign in at admin.vedavid.dev with your work email. The org is where teams, dashboards and connector tokens live. The phone app never creates anything. It reads.

Issue an enrollment token for the cluster you are about to connect. Tokens are single-cluster and revocable from the same screen.

2. Install the connector

The connector is one open-source Rust binary that runs next to Prometheus. Read the source before you run it.

# add the chart repo
helm repo add vedavid https://charts.vedavid.dev
helm repo update

# install next to Prometheus
helm install vedavid-connector vedavid/connector \
  --namespace monitoring \
  --set token=$VEDAVID_TOKEN \
  --set prometheus.url=http://prometheus-operated:9090

The pod registers itself with the relay over mTLS and holds the connection open. Confirm it in the admin console, or from the cluster:

kubectl -n monitoring logs deploy/vedavid-connector | tail -3

INFO  connector: resolved prometheus at http://prometheus-operated:9090
INFO  relay: mTLS handshake ok · tenant=acme cluster=prod-east
INFO  relay: registered · holding outbound stream

3. Commit a dashboard

Dashboards are YAML files in a repository you own. Copy one from the library rather than starting from an empty file.

name: gateway-edge
cluster: prod-east
panels:
  - title: Requests
    kind: stat
    unit: short
    query: sum(rate(http_requests_total{job="gateway-edge"}[5m]))
  - title: Errors 5xx
    kind: stat
    compare: 1h
    query: sum(rate(http_requests_total{job="gateway-edge",code=~"5.."}[5m]))

4. Open the app

Sign in with the same email. Your dashboards appear at the next sync, usually within thirty seconds of the merge. If a panel is empty, the query returned nothing. The app does not invent zeroes.