generated: '2026-08-30'
method: searched
source: https://docs.aklivity.io/latest/reference/2.x/config/telemetry/events.html
provider: Aklivity
providerId: aklivity
format: named-telemetry-events
summary: >-
  Zilla's published failure surface is a catalog of NAMED TELEMETRY EVENTS, not
  an HTTP error-code registry and not RFC 9457 problem documents. Every event
  below is emitted by the engine and can be routed to stdout, syslog, AWS
  CloudWatch, OTLP or Prometheus via a telemetry exporter, which makes this the
  artifact an operator or an agent actually watches to know why a request was
  refused. Names are transcribed verbatim from the 2.x reference; no severity,
  remediation text or HTTP status is asserted here because the provider
  publishes none. The event set is scoped to the gateway a customer runs —
  Aklivity operates no hosted API, so there is no upstream error envelope of
  its own to document.
exporters:
  - stdout
  - syslog
  - aws-cloudwatch
  - otlp
  - prometheus
observed_via: zilla logs -f --format <format>
event_count: 46
events:
  - name: BINDING_HTTP_REQUEST_ACCEPTED
    family: binding
  - name: BINDING_KAFKA_API_VERSION_REJECTED
    family: binding
  - name: BINDING_KAFKA_AUTHORIZATION_FAILED
    family: binding
  - name: BINDING_KAFKA_CLUSTER_AUTHORIZATION_FAILED
    family: binding
  - name: BINDING_MCP_AUTHORIZATION_FAILED
    family: binding
  - name: BINDING_MCP_ELICITATION_TIMEOUT
    family: binding
  - name: BINDING_MCP_SESSION_CLOSED
    family: binding
  - name: BINDING_MCP_SESSION_ESTABLISHED
    family: binding
  - name: BINDING_MQTT_CLIENT_CONNECTED
    family: binding
  - name: BINDING_MQTT_KAFKA_NON_COMPACT_SESSIONS_TOPIC
    family: binding
  - name: BINDING_TCP_DNS_FAILED
    family: binding
  - name: BINDING_TLS_HANDSHAKE_FAILED
    family: binding
  - name: BINDING_TLS_KEY_REJECTED
    family: binding
  - name: BINDING_TLS_PEER_NOT_VERIFIED
    family: binding
  - name: BINDING_TLS_PROTOCOL_REJECTED
    family: binding
  - name: BINDING_TLS_TLS_FAILED
    family: binding
  - name: CATALOG_APICURIO_REGISTRY_RETRIEVED_ARTIFACT_ID
    family: catalog
  - name: CATALOG_APICURIO_REGISTRY_RETRIEVED_ARTIFACT_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_APICURIO_REGISTRY_UNRETRIEVABLE_ARTIFACT_ID
    family: catalog
  - name: CATALOG_APICURIO_REGISTRY_UNRETRIEVABLE_ARTIFACT_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_APICURIO_REGISTRY_UNRETRIEVABLE_ARTIFACT_SUBJECT_VERSION_STALE_ARTIFACT
    family: catalog
  - name: CATALOG_CONFLUENT_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_ID
    family: catalog
  - name: CATALOG_CONFLUENT_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_CONFLUENT_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_ID
    family: catalog
  - name: CATALOG_CONFLUENT_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_CONFLUENT_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION_STALE_SCHEMA
    family: catalog
  - name: CATALOG_FILESYSTEM_FILE_NOT_FOUND
    family: catalog
  - name: CATALOG_KARAPACE_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_ID
    family: catalog
  - name: CATALOG_KARAPACE_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_KARAPACE_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_ID
    family: catalog
  - name: CATALOG_KARAPACE_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_KARAPACE_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION_STALE_SCHEMA
    family: catalog
  - name: CATALOG_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_ID
    family: catalog
  - name: CATALOG_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_ID
    family: catalog
  - name: CATALOG_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION
    family: catalog
  - name: CATALOG_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION_STALE_SCHEMA
    family: catalog
  - name: GUARD_AWS_COGNITO_AUTHORIZATION_FAILED
    family: guard
  - name: GUARD_AWS_COGNITO_DISCOVERY_FAILED
    family: guard
  - name: GUARD_AZURE_AD_AUTHORIZATION_FAILED
    family: guard
  - name: GUARD_JWT_AUTHORIZATION_FAILED
    family: guard
  - name: MODEL_AVRO_VALIDATION_FAILED
    family: model
  - name: MODEL_CORE_VALIDATION_FAILED
    family: model
  - name: MODEL_JSON_VALIDATION_FAILED
    family: model
  - name: MODEL_PROTOBUF_VALIDATION_FAILED
    family: model
  - name: VAULT_AWS_SECRETS_KEY_PAIR_INVALID
    family: vault
related:
  - conformance/aklivity-conformance.yml
  - conventions/aklivity-conventions.yml
  - https://docs.aklivity.io/latest/support/troubleshooting-guides/
  - https://docs.aklivity.io/latest/support/collect-diagnostic/