Compute SLO instance summaries in bulk at a point in time

Base URL: https://{kibana_url}

POST /s/{spaceId}/api/observability/slos/_bulk_snapshot

Compute the summary of multiple SLO instances at a given point in time. The endpoint is synchronous and returns results directly. Each result contains either a summary (on success) or a per-instance error. The list of requests is limited to 100 entries. When instanceId is omitted or set to '*', the API returns a result for each matching instance (up to 1000 per SLO). You must have the read privileges for the SLOs feature in the Observability section of the Kibana feature privileges.

at string · format: date-time required: The point in time at which the summaries were computed
results object[] required: The per-instance computation results

Bad request

application/json

Unauthorized response

application/json

Forbidden response

application/json

Base URL: https://{kibana_url}

Examples

Request Console 1 / 2 languages

Console Kibana Dev Tools

POST kbn:/s/default/api/observability/slos/_bulk_snapshot
{
  "at": "2025-01-12T10:00:00.000Z",
  "requests": [
    {
      "id": "8853df00-ae2e-11ed-90af-09bb6422b258",
      "instanceId": "*"
    },
    {
      "id": "d077e940-1515-11ee-9c50-9d096392f520",
      "instanceId": "host.name:web-01"
    }
  ]
}

Generated from the API spec

curl Shell

curl -X POST "${KIBANA_URL}/s/default/api/observability/slos/_bulk_snapshot" \
  -H "kbn-xsrf: true" \
  -H "Authorization: ApiKey ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "at": "2025-01-12T10:00:00.000Z",
    "requests": [
      {
        "id": "8853df00-ae2e-11ed-90af-09bb6422b258",
        "instanceId": "*"
      },
      {
        "id": "d077e940-1515-11ee-9c50-9d096392f520",
        "instanceId": "host.name:web-01"
      }
    ]
  }'

Generated from the API spec

Response

{
  "at": "2025-01-12T10:00:00.000Z",
  "results": [
    {
      "id": "8853df00-ae2e-11ed-90af-09bb6422b258",
      "instanceId": "*",
      "summary": {
        "errorBudget": {
          "consumed": 0.24,
          "initial": 0.01,
          "remaining": 0.76
        },
        "good": 9976,
        "sliValue": 0.9976,
        "status": "HEALTHY",
        "total": 10000
      }
    },
    {
      "error": {
        "message": "SLO [d077e940-1515-11ee-9c50-9d096392f520] not found",
        "statusCode": 404
      },
      "id": "d077e940-1515-11ee-9c50-9d096392f520",
      "instanceId": "host.name:web-01"
    }
  ]
}

{
  "error": "Bad Request",
  "message": "\u0060requests\u0060 is limited to 100 entries",
  "statusCode": 400
}

{
  "error": "Unauthorized",
  "message": "security_exception: unable to authenticate user for REST request [/api/observability/slos]",
  "statusCode": 401
}

{
  "error": "Forbidden",
  "message": "security_exception: action [slo_read] is unauthorized for user",
  "statusCode": 403
}

Compute SLO instance summaries in bulk at a point in time

Authentication

Path parameters

Header parameters

Request body

Responses

Authentication

Path parameters

Header parameters

Request body { }

Responses

Request body