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

# Instantánea de runtime

> Devuelve una instantánea barata del runtime de Go para triaje de incidentes (conteo de goroutines, ciclos de GC, bytes de heap). Sin datos de tenant ni de alta cardinalidad. Sin autenticación.



## OpenAPI

````yaml es/openapi/v3-current/streaming-hub.yaml get /runtime
openapi: 3.1.0
info:
  title: Lerian Streaming Hub API
  version: v1.0.0
  contact:
    email: contact@lerian.studio
    name: Lerian Studio
    url: https://lerian.studio
  license:
    name: Lerian Studio General License
  description: >-
    La API de control-plane de Streaming Hub. Streaming Hub es el borde
    gestionado de entrega de eventos de Lerian: consume CloudEvents del backbone
    de streaming interno de la plataforma y los distribuye a los destinos
    externos propios de cada tenant — webhooks, Amazon SQS, RabbitMQ, Amazon
    EventBridge o una bandeja de entrada de tipo pull. Esta API permite a un
    tenant explorar el catálogo de eventos alimentado por el manifest, crear y
    gestionar suscripciones de entrega, verificar y rotar sus credenciales, leer
    la salud de entrega y hacer pull de los eventos a los que tiene derecho.


    Los errores usan un envelope plano `{"error":"<token>"}` (un token de baja
    cardinalidad y legible por máquina — nunca RFC 9457 problem+json). Las
    operaciones de mutación requieren un header `X-Idempotency` para semántica
    at-most-once; una petición reproducida (replay) devuelve la respuesta
    original byte a byte con `X-Idempotency-Replayed: true`. El catálogo y la
    superficie de eventos pull están acotados por tenant a través del JWT
    bearer; los endpoints operacionales de sonda (`/healthz`, `/readyz`,
    `/version`, `/runtime`, `/metrics`) no requieren autenticación. Streaming
    Hub es de código cerrado bajo la Lerian Studio General License.
servers:
  - url: https://streaming-hub.sandbox.lerian.net
security:
  - BearerAuth: []
tags:
  - name: Catalog
    description: >-
      Explora el catálogo de tipos de evento disponibles para suscripción,
      alimentado por el manifest.
  - name: Subscriptions
    description: >-
      Crea, lee, actualiza y elimina suscripciones de entrega, y gestiona el
      ciclo de vida de verificación del destino (ping, verify, credential,
      delegated grant, rotación de secreto, health).
  - name: Event Delivery
    description: >-
      Haz pull de los eventos a los que tienes derecho para una suscripción de
      tipo pull (lectura cursor-as-acknowledgment).
  - name: Admin
    description: >-
      Análisis forense de operador entre tenants. Requiere un scope de
      autorización de operador.
  - name: Operational
    description: >-
      Sondas de liveness, readiness, build, runtime y métricas sin
      autenticación.
paths:
  /runtime:
    get:
      tags:
        - Operational
      summary: Instantánea de runtime
      description: >-
        Devuelve una instantánea barata del runtime de Go para triaje de
        incidentes (conteo de goroutines, ciclos de GC, bytes de heap). Sin
        datos de tenant ni de alta cardinalidad. Sin autenticación.
      operationId: getRuntime
      responses:
        '200':
          description: La instantánea de runtime.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuntimeResponse'
      security: []
components:
  schemas:
    RuntimeResponse:
      type: object
      additionalProperties: false
      properties:
        goVersion:
          type: string
          description: The Go runtime version.
          examples:
            - go1.26.5
        goroutines:
          type: integer
          description: The current goroutine count.
          examples:
            - 42
        numGC:
          type: integer
          format: int64
          description: The number of completed GC cycles.
          examples:
            - 17
        heapAlloc:
          type: integer
          format: int64
          description: Heap bytes currently allocated.
          examples:
            - 8388608
        numCPU:
          type: integer
          description: The number of logical CPUs available.
          examples:
            - 8
      required:
        - goVersion
        - goroutines
        - numGC
        - heapAlloc
        - numCPU
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Un JWT bearer emitido por plugin-auth (lib-auth). La identidad del
        tenant se resuelve a partir de los claims validados del token; la
        superficie `/v1` nunca lee un tenant del cuerpo, del path ni de la
        query. Los llamadores de máquina obtienen un token vía el flujo
        client-credentials de plugin-auth. La superficie `/admin` autoriza
        contra un scope de operador y no lleva contexto de tenant.

````