Skip to main content

Configuration

Zen Mesh components are configured via Helm values, environment variables, and CRDs.

Environment Variables

Agent

VariableDefaultDescription
ZEN_SAAS_ENDPOINThttps://api.zen-mesh.ioControl plane API endpoint
ZEN_CLUSTER_IDCluster ID (set during enrollment)
ZEN_TENANT_IDTenant ID (extracted from enrollment bundle)
ZEN_LOG_LEVELinfoLog level: debug, info, warn, error

Egress

VariableDefaultDescription
ZEN_TLS_ENABLEDtrueEnable mTLS for delivery
ZEN_HMAC_ENFORCEtrueEnforce HMAC validation on delivered events

CRDs

DeliveryFlow

Defines how events are routed from an ingester to a destination.

Destination

A delivery target (URL + cluster + adapter mapping).

EndpointConfig

Configuration for delivery endpoints (timeouts, retries, headers).

Ingester

An event intake point with its routing rules.