The Metrics API provides Prometheus-compatible endpoints for querying your app’s metrics. Use it to build custom monitoring, integrate with external tools, or power your own dashboards.

​
Authentication

All requests require a Miget API token in the Authorization header: 
curl -H "Authorization: Bearer miget_live_your_token_here" \
  "https://metrics.miget.com/prometheus/api/v1/query?query=miget_instance_cpu_usage"
Generate an API token in Settings → API Tokens in your Miget dashboard.

​
Endpoints

The API is hosted at https://metrics.miget.com and supports standard Prometheus query endpoints.

​
Instant Query

GET /prometheus/api/v1/query
ParameterDescription
queryPromQL expression
timeEvaluation timestamp (optional, defaults to now)
curl -H "Authorization: Bearer $TOKEN" \
  "https://metrics.miget.com/prometheus/api/v1/query?query=miget_instance_cpu_usage"

​
Range Query

GET /prometheus/api/v1/query_range
ParameterDescription
queryPromQL expression
startStart timestamp (Unix or RFC3339)
endEnd timestamp
stepQuery resolution step (e.g. 60s, 5m)
curl -H "Authorization: Bearer $TOKEN" \
  "https://metrics.miget.com/prometheus/api/v1/query_range?\
query=rate(miget_instance_cpu_usage[5m])&start=2026-04-07T00:00:00Z&end=2026-04-07T12:00:00Z&step=5m"

​
Label Discovery

GET /prometheus/api/v1/labels
GET /prometheus/api/v1/label/{name}/values

# List all label names
curl -H "Authorization: Bearer $TOKEN" \
  "https://metrics.miget.com/prometheus/api/v1/labels"

# List all apps
curl -H "Authorization: Bearer $TOKEN" \
  "https://metrics.miget.com/prometheus/api/v1/label/app/values"

​
Logs API

Query logs via a Loki-compatible endpoint. 
GET /loki/api/v1/query_range

curl -H "Authorization: Bearer $TOKEN" \
  "https://metrics.miget.com/loki/api/v1/query_range?\
query={app=\"my-app\"}&start=1712448000000000000&end=1712534400000000000&limit=100"

​
Workspace Selection

By default, the API returns data for your default workspace. To query a different workspace, add the X-Workspace-Id header: 
curl -H "Authorization: Bearer $TOKEN" \
     -H "X-Workspace-Id: your-workspace-uuid" \
  "https://metrics.miget.com/prometheus/api/v1/query?query=miget_instance_cpu_usage"

​
Grafana Integration

You can point an external Grafana instance at the Metrics API:
  1. Add a Prometheus datasource with URL: https://metrics.miget.com/prometheus
  2. Under Custom HTTP Headers, add:
    • Header: Authorization, Value: Bearer miget_live_your_token
  3. Click Save & Test
For logs, add a Loki datasource with URL: https://metrics.miget.com (no /loki suffix - Grafana adds it automatically).

​
Rate Limits

The API is subject to fair-use rate limits. If you receive HTTP 429 responses, reduce your query frequency. Typical usage patterns (dashboard refresh every 30s, alerting every 60s) are well within limits.

​
Example Queries

# CPU usage per app (cores)
miget_instance_cpu_usage{app="my-app"}

# Memory usage percentage
miget_instance_memory_used_bytes{app="my-app"}
  / miget_instance_resource_limit{app="my-app", resource="memory"} * 100

# HTTP error rate (5xx responses per second)
sum(rate(miget_app_http_responses_total{app="my-app", status=~"5.."}[5m]))

# p99 response time
histogram_quantile(0.99,
  sum(rate(miget_app_http_response_time_seconds_bucket{app="my-app"}[5m])) by (le))

# Disk IOPS
rate(miget_instance_disk_read_ops_total{app="my-app"}[5m])
  + rate(miget_instance_disk_write_ops_total{app="my-app"}[5m])

# Volume usage percentage
miget_volume_used_bytes{app="my-app"} / miget_volume_size_bytes{app="my-app"} * 100