SLOs

Get SLO Hourly Counts History

Get hourly-bucketed total and error event counts for an SLO from the persistent historical store. Use this endpoint to retrieve completed historical hours; pair with the Get SLO Realtime Counts endpoint for the current in-progress hour.

Requirements:

  • Available on the Enterprise plan only.
  • This feature must be enabled for your team. Contact your account team to request access.

Partial buckets: The most recent bucket may be marked is_partial: true if it covers the current in-progress hour. Counts for that bucket will increase until the hour completes.

Budget resets: This endpoint returns raw counts that don't account for budget resets, so failures from before a reset still appear in the counts. For reporting data that reflects budget resets, use the Get an SLO endpoint with the detailed parameter.

get/1/slos/{datasetSlug}/{sloId}/counts/history

Request

  • Base URL
    https://api.honeycomb.io
  • URL
    https://api.honeycomb.io/1/slos/{datasetSlug}/{sloId}/counts/history
  • Auth
    API key in header X-Honeycomb-Team

Query parameters

start_timeinteger required

Start of the time range as a Unix timestamp (seconds).

end_timeinteger required

End of the time range as a Unix timestamp (seconds). Must be greater than start_time.

Response

Success

slo_idstring

The unique identifier of the SLO.

resolution_secondsinteger

The width of each bucket in seconds. Always 3600.

Example response

{
  "slo_id": "bZ1aRHAUsjG",
  "resolution_seconds": 3600,
  "buckets": [
    {
      "start_time": 1745168400,
      "end_time": 1745172000,
      "total_count": 74520,
      "error_count": 182
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.