Traffic Analytics

Get server-wide top paths

Changed on

Busiest request paths across every app on the box, summed over the range with per-path latency. Rows are keyed by (app, path): the same path served by multiple apps stays a separate entry per app, each labelled with its owning app, giving a correct top-N across all apps that preserves per-app attribution.

Requires Sentinel built with the traffic Cargo feature AND TRAFFIC_ENABLED=true at runtime; returns 404 otherwise.

get/api/traffic/paths

Request

  • The document declares no server URL.
  • Auth: HTTP bearer

Query parameters

fromstring

Start date in ISO 8601 format (UTC). Defaults to the Unix epoch (all recorded history) when omitted.

tostring

End date in ISO 8601 format (UTC). Defaults to now when omitted.

limitstring

A String, not a usize, so ?limit= (empty) can be treated as absent rather than rejected by the extractor — the same courtesy resolve_range extends to ?from=.

Positive integer, max 1000. Defaults to 50.

Response

Server-wide top paths

appstring required

The app (Coolify app UUID, or host for Caddy) that served this path, so a server-wide response can attribute each path back to its owning app/domain. On a per-app endpoint every row carries the queried app.

bytes_outinteger required
p50number double required
p95number double required
pathstring required
requestsinteger required
s4xxinteger required
s5xxinteger required

Changes

  • dbee64925479Revision changes
    • breaking

      for the query request parameter limit, default value 50 was removed

    • breaking

      removed the media type application/json for the response with the status

    • breaking

      removed the media type application/json for the response with the status

    • breaking

      removed the media type application/json for the response with the status

    • breaking

      removed the media type application/json for the response with the status

    • breaking

      the / response's property format changed from float to double for status

    • breaking

      the / response's property format changed from float to double for status

    • info

      api operation id server_paths was added

    • info

      the endpoint scheme security bearerAuth was added to the API

    • info

      for the query request parameter from, the format was generalized from date-time to no format

    • info

      for the query request parameter limit, the type was generalized from integer to string

    • info

      for the query request parameter to, the format was generalized from date-time to no format

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

  • 7e10022366bdRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status