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

# Infrastructure Metrics

> Returns aggregated infrastructure health metrics from all cluster
collectors: Kafka broker and topic status, Flink job states, OpenSearch
cluster health, and External Secrets sync status.




## OpenAPI

````yaml GET /api/agent/metrics
openapi: 3.1.0
info:
  title: LogClaw API
  description: >
    LogClaw Cloud API for log ingestion, API key management, incident
    monitoring,

    and infrastructure health. All endpoints are authenticated via the

    `x-logclaw-api-key` header.


    Generate an API key from your project dashboard at

    [console.logclaw.ai](https://console.logclaw.ai) under **Settings → API
    Keys**.
  version: 1.0.0
  contact:
    name: LogClaw
    url: https://docs.logclaw.ai
servers:
  - url: https://otel.logclaw.ai
    description: LogClaw Cloud
security:
  - apiKey: []
tags:
  - name: Ingestion
    description: OTLP log ingestion
  - name: API Keys
    description: API key management
  - name: Bridge
    description: ETL pipeline health and configuration
  - name: Ticketing
    description: Incident management and runtime config
  - name: Infrastructure
    description: Cluster health monitoring
  - name: OpenSearch
    description: Log storage and search
paths:
  /api/agent/metrics:
    get:
      tags:
        - Infrastructure
      summary: Infrastructure Metrics
      description: |
        Returns aggregated infrastructure health metrics from all cluster
        collectors: Kafka broker and topic status, Flink job states, OpenSearch
        cluster health, and External Secrets sync status.
      operationId: agentMetrics
      responses:
        '200':
          description: Infrastructure metrics
          content:
            application/json:
              example:
                kafka:
                  status: healthy
                  brokers: 3
                  topics:
                    raw-logs:
                      partitions: 6
                      consumerLag: 150
                    enriched-logs:
                      partitions: 6
                      consumerLag: 0
                flink:
                  status: healthy
                  jobs:
                    - name: logclaw-anomaly-detection
                      state: RUNNING
                      taskManagers: 2
                      uptime: 48h30m
                opensearch:
                  status: green
                  nodes: 6
                  indices: 15
                  totalDocs: 1542000
                  totalSizeBytes: 2147483648
                eso:
                  status: healthy
                  externalSecrets:
                    - name: logclaw-ticketing-credentials
                      status: SecretSynced
                      lastSyncTime: '2024-03-01T15:00:00Z'
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-logclaw-api-key
      description: Your project API key (starts with `lc_proj_`)

````