Logs

Kafka Gateway logs provide detailed event tracking for system activities, enabling better monitoring and debugging.

Format

Each log entry contains a timestamp, namespace, binding, event name, and other relevant details.

<namespace>.<binding> <timestamp> <event name> - <other details>

For example:

http-kafka-proxy.north_http_server [22/Nov/2024:10:28:11 +0000] BINDING_HTTP_REQUEST_ACCEPTED - POST https://localhost:7143/events

Events by Component

Named events are grouped by the internal component that raises them. Any of these events can be collected and exported via exporters, for example by adding the stdout exporter to zilla.yaml.

Binding

Event	Description
BINDING_HTTP_REQUEST_ACCEPTED	The server received a valid HTTP request.
BINDING_KAFKA_API_VERSION_REJECTED	A Kafka protocol API version mismatch occurred in the kafka binding.
BINDING_KAFKA_AUTHORIZATION_FAILED	An authorization failure happened in the http, mqtt, or kafka binding.
BINDING_KAFKA_CLUSTER_AUTHORIZATION_FAILED	A Kafka protocol API cluster authorization failed.
BINDING_MQTT_CLIENT_CONNECTED	An MQTT session was successfully authorized and connected.
BINDING_MQTT_KAFKA_NON_COMPACT_SESSIONS_TOPIC	The sessions topic declared in the mqtt-kafka binding is required to be log compacted.
BINDING_TCP_DNS_FAILED	A DNS resolution failure.
BINDING_TLS_HANDSHAKE_FAILED	A client could not negotiate the desired level of security with the server.
BINDING_TLS_KEY_REJECTED	A client or server has a misconfiguration of the server or client SSL certificate and private key.
BINDING_TLS_PEER_NOT_VERIFIED	A peer's identity could not be verified.
BINDING_TLS_PROTOCOL_REJECTED	An error in the operation of the SSL protocol.
BINDING_TLS_TLS_FAILED	A generic error detected by an SSL subsystem.

Catalog

Event	Description
CATALOG_APICURIO_REGISTRY_RETRIEVED_ARTIFACT_ID	Fetching the Apicurio artifact was successful.
CATALOG_APICURIO_REGISTRY_RETRIEVED_ARTIFACT_SUBJECT_VERSION	Fetching the Apicurio artifact by version was successful.
CATALOG_APICURIO_REGISTRY_UNRETRIEVABLE_ARTIFACT_ID	Fetching the Apicurio artifact was unsuccessful.
CATALOG_APICURIO_REGISTRY_UNRETRIEVABLE_ARTIFACT_SUBJECT_VERSION_STALE_ARTIFACT	Fetching the Apicurio artifact by version was unsuccessful, but a previously fetched artifact is still being used.
CATALOG_APICURIO_REGISTRY_UNRETRIEVABLE_ARTIFACT_SUBJECT_VERSION	Fetching the Apicurio artifact by version was unsuccessful.
CATALOG_CONFLUENT_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_ID	Fetching the registry schema was successful.
CATALOG_CONFLUENT_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_SUBJECT_VERSION	Fetching the registry schema by version was successful.
CATALOG_CONFLUENT_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_ID	Fetching the registry schema was unsuccessful.
CATALOG_CONFLUENT_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION_STALE_SCHEMA	Fetching the registry schema by version was unsuccessful, but a previously fetched schema is still being used.
CATALOG_CONFLUENT_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION	Fetching the registry schema by version was unsuccessful.
CATALOG_FILESYSTEM_FILE_NOT_FOUND	No file was found at the specified location.
CATALOG_KARAPACE_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_ID	Fetching the Karapace schema was successful.
CATALOG_KARAPACE_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_SUBJECT_VERSION	Fetching the Karapace schema by version was successful.
CATALOG_KARAPACE_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_ID	Fetching the Karapace schema was unsuccessful.
CATALOG_KARAPACE_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION_STALE_SCHEMA	Fetching the Karapace schema by version was unsuccessful, but a previously fetched schema is still being used.
CATALOG_KARAPACE_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION	Fetching the Karapace schema by version was unsuccessful.
CATALOG_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_ID	Fetching the registry schema was successful.
CATALOG_SCHEMA_REGISTRY_RETRIEVED_SCHEMA_SUBJECT_VERSION	Fetching the registry schema by version was successful.
CATALOG_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_ID	Fetching the registry schema was unsuccessful.
CATALOG_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION_STALE_SCHEMA	Fetching the registry schema by version was unsuccessful, but a previously fetched schema is still being used.
CATALOG_SCHEMA_REGISTRY_UNRETRIEVABLE_SCHEMA_SUBJECT_VERSION	Fetching the registry schema by version was unsuccessful.

Guard

Event	Description
GUARD_AZURE_AD_AUTHORIZATION_FAILED	A client failed authorization for an Azure AD guarded route.
GUARD_JWT_AUTHORIZATION_FAILED	A client failed authorization for a JWT guarded route.
GUARD_AWS_LAMBDA_AUTHORIZATION_FAILED	A client failed authorization for an AWS Lambda guarded route.

Model

Event	Description
MODEL_AVRO_VALIDATION_FAILED	A payload did not match the required Avro model schema.
MODEL_CORE_VALIDATION_FAILED	A payload did not match the required model schema.
MODEL_JSON_VALIDATION_FAILED	A payload did not match the required JSON model schema.
MODEL_PROTOBUF_VALIDATION_FAILED	A payload did not match the required Protobuf model schema.

Vault

Event	Description
VAULT_AWS_SECRETS_KEY_PAIR_INVALID	A TLS key verification failed because the key pair is missing or invalid.

For the complete, always up to date event reference, see Telemetry Events.