Metrics

List metric streams and query data points from the AgentVista metrics API.

AgentVista stores metrics ingested via the OTLP endpoint as named metric streams with typed data points. You can query those streams and filter by labels and time range through the dashboard API.

To ingest metrics data, use the OTLP ingestion endpoint. The endpoints on this page are read-only dashboard endpoints.

---

List metric streams

cURL

curl https://api.agentvista.dev/api/v1/dashboard/metrics/ \
  -H "Authorization: Bearer av_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET /dashboard/metrics/

Returns all named metric streams owned by the authenticated user, including the total number of data points stored for each metric. Results are ordered alphabetically by name.

Response — 200

An array of metric stream objects.

name · string

Metric name (e.g. "system.cpu.utilization").

metric_type · string

OTLP metric type (e.g. "gauge", "sum", "histogram").

unit · string

Unit of measurement (e.g. "1", "ms", "By").

description · string

Human-readable description from the OTLP payload.

data_point_count · number

Total number of data points stored for this metric stream.

Example response

[
  {
    "name": "system.cpu.utilization",
    "metric_type": "gauge",
    "unit": "1",
    "description": "CPU utilization as a fraction of capacity",
    "data_point_count": 14400
  },
  {
    "name": "http.server.request.duration",
    "metric_type": "histogram",
    "unit": "ms",
    "description": "HTTP server request duration",
    "data_point_count": 8291
  }
]

---

Query metric data points

cURL

curl "https://api.agentvista.dev/api/v1/dashboard/metrics/query?name=system.cpu.utilization&start=2024-01-15T00:00:00Z&end=2024-01-15T23:59:59Z&limit=500" \
  -H "Authorization: Bearer av_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

GET /dashboard/metrics/query

Queries data points for a named metric stream with optional label and time range filters. Returns 404 if no metric with the given name exists for the authenticated user.

Query parameters

name · string · required

Metric name to query (e.g. "system.cpu.utilization").

labels · string

JSON-encoded label filter object (URL-encoded). Only data points whose labels contain all specified key-value pairs are returned. Example: {"host":"web-1"}. Uses subset matching — a data point with labels {"host":"web-1","region":"us-east"} matches a filter of {"host":"web-1"}.

start · string

ISO 8601 datetime. Only data points at or after this time are returned.

end · string

ISO 8601 datetime. Only data points at or before this time are returned.

limit · number · default: "1000"

Maximum number of data points to return. Data points are ordered newest-first.

Response — 200

name · string

Metric name.

metric_type · string

Metric type (e.g. "gauge", "sum", "histogram").

unit · string

Unit of measurement.

data_points · object[]

Matching data points ordered newest-first.

Show data point fields

value · number

Numeric value of the data point.

timestamp · string

ISO 8601 timestamp when the data point was recorded.

labels · object

Key-value label pairs attached to this data point (e.g. {"host": "web-1", "region": "us-east"}).

Example response

{
  "name": "system.cpu.utilization",
  "metric_type": "gauge",
  "unit": "1",
  "data_points": [
    {
      "value": 0.72,
      "timestamp": "2024-01-15T12:05:00Z",
      "labels": { "host": "web-1", "region": "us-east" }
    },
    {
      "value": 0.65,
      "timestamp": "2024-01-15T12:04:00Z",
      "labels": { "host": "web-1", "region": "us-east" }
    }
  ]
}