Read one route over time
Returns one route's request rate, 5xx rate and duration quantiles at each step of the range. `route` and `method` name the route as readServiceRoutes lists it. `serviceName` is a compose service.
Authorization
cloady Personal API token (cldy_…)
In: header
Path Parameters
Query Parameters
Value in
- "production"
- "preview"
- "development"
How far back to look; the answer has 30 to 96 points across it
"1h"Value in
- "15m"
- "1h"
- "6h"
- "24h"
- "7d"
The route, exactly as the routes listing names it
1 <= length <= 400The method; every method of the route when absent
length <= 16Where the numbers come from: ingress reads the access log of the service the app's address routes to, traces reads the OpenTelemetry server spans the service sends. Defaults to ingress for that service and traces for every other one
Value in
- "ingress"
- "traces"
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/workspaces/string/apps/string/services/string/routes/series?route=string"{ "start": 0, "step": 0, "rps": [ 0 ], "errors": [ 0 ], "p50": [ 0 ], "p95": [ 0 ], "p99": [ 0 ]}Read a service's routes GET
Returns one row per route over the range, the busiest 100: requests, requests per second, the share answered 5xx, requests per status class and code, duration quantiles, total time spent and a request-rate trend. For the service the app's address routes to, rows come from the ingress access log, which records every request for seven days; route templates there are inferred from paths. Every other service needs the app to send OpenTelemetry spans, whose own routes are used. Filters take the fields `route`, `method` and `status` (a code such as `404` or a class such as `5xx`). `serviceName` is a compose service.
Search a service's log by category GET
Reads the service's log the way its software writes it and sorts the lines into categories: for the service the app's address routes to, the ingress access log by status class beside the service's own errors; for PostgreSQL, slow statements, lock waits, deadlocks, errors, connections, autovacuum, checkpoints and temporary files; likewise for MySQL, MongoDB, ClickHouse, Redis, RabbitMQ, Postfix, Sidekiq and Celery; other services by level. Returns each category's line count and volume per step, and the newest 200 lines of the requested categories with the fields parsed from them and, for PostgreSQL, the statement logged with them. Filters take the fields `level` and, on access logs, `route`. Logs are kept for seven days. `serviceName` is a compose service.