> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Kg Queue Health

> Return the live snapshot of consolidation queue health.

Polled by the frontend EventQueueTab at 2s intervals (TR10). Safe to
invoke at any frequency — counts are SQL aggregates and in-process
sliding windows; no Kùzu I/O.



## OpenAPI

````yaml /openapi.json get /api/v1/kg/queue/health
openapi: 3.1.0
info:
  description: >-
    Okto Pulse REST API schema generated from okto-pulse-core 0.2.0 source for
    docs.oktolabs.ai.
  title: Okto Pulse
  version: 0.2.0
servers: []
security: []
paths:
  /api/v1/kg/queue/health:
    get:
      tags:
        - queue-health
      summary: Get Kg Queue Health
      description: |-
        Return the live snapshot of consolidation queue health.

        Polled by the frontend EventQueueTab at 2s intervals (TR10). Safe to
        invoke at any frequency — counts are SQL aggregates and in-process
        sliding windows; no Kùzu I/O.
      operationId: get_kg_queue_health_api_v1_kg_queue_health_get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QueueHealthResponse'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    QueueHealthResponse:
      description: Live consolidation queue health snapshot.
      properties:
        alert_active:
          title: Alert Active
          type: boolean
        alert_fired_total:
          title: Alert Fired Total
          type: integer
        alert_threshold:
          title: Alert Threshold
          type: integer
        claimed_boards:
          items:
            type: string
          title: Claimed Boards
          type: array
        claimed_count:
          title: Claimed Count
          type: integer
        claims_per_min_1m:
          title: Claims Per Min 1M
          type: integer
        claims_per_min_5m:
          title: Claims Per Min 5M
          type: integer
        dead_letter_count:
          title: Dead Letter Count
          type: integer
        kuzu_lock_retries_5m:
          title: Kuzu Lock Retries 5M
          type: integer
        oldest_pending_age_s:
          title: Oldest Pending Age S
          type: number
        queue_depth:
          title: Queue Depth
          type: integer
        workers_active:
          title: Workers Active
          type: integer
        workers_draining_count:
          title: Workers Draining Count
          type: integer
        workers_idle:
          title: Workers Idle
          type: integer
      required:
        - queue_depth
        - oldest_pending_age_s
        - claimed_count
        - claimed_boards
        - dead_letter_count
        - claims_per_min_1m
        - claims_per_min_5m
        - alert_threshold
        - alert_active
        - alert_fired_total
        - workers_active
        - workers_idle
        - workers_draining_count
        - kuzu_lock_retries_5m
      title: QueueHealthResponse
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http

````