Get resource metrics by service
Returns time-series resource data for one service. Each timestamp contains per-instance metrics. Filter results using aggs[] (min, max, avg, stddev, p50, p95-p99) and types[] (cpu, memory, swap, disk, inodes, pressure metrics). Response grouped by timestamp then instance ID (e.g., “app.0”). All aggregations nullable when insufficient data exists.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The unique identifier of the Upsun project
[a-z0-9]+"abc123def456"
The environment identifier
.+"main"
The service name to retrieve metrics for (e.g., "app", "database", "admin-pipeline--kafka-profile-payloads")
"app"
Query Parameters
Start timestamp for the time range (Unix timestamp in seconds)
1704067200
End timestamp for the time range (Unix timestamp in seconds)
1704153600
Statistical aggregations to include in the response. Can be specified multiple times. Available values: avg, stddev, max, min, p50, p95, p96, p97, p98, p99. Specify parameter multiple times for multiple values (e.g., ?aggs[]=avg&aggs[]=p50).
avg, stddev, max, min, p50, p95, p96, p97, p98, p99 Metric types to include in the response. Can be specified multiple times. Available values: cpu, memory, disk, inodes, swap, memory_pressure, cpu_pressure, io_pressure, irq_pressure. Specify parameter multiple times for multiple values (e.g., ?types[]=cpu&types[]=memory).
cpu, memory, disk, inodes, swap, memory_pressure, cpu_pressure, io_pressure, irq_pressure Response
Successfully retrieved service-specific resource metrics with time-series data
Data granularity in seconds
5
Query start timestamp
1704067200
Query end timestamp
1704153600
Project identifier
"abc123def456"
Environment identifier
"main"
Branch machine name
"main-bvxea6i"
Service name
"admin-pipeline--kafka-profile-payloads"
Time-series resource utilization data organized by timestamp with instance-level metrics
DG2 host type mapping per instance. Only present for DG2 environments. Maps instance names to their host type ("web", "unified", or empty string).
{
"app.0": "web",
"app.1": "unified",
"worker.0": ""
}