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_ID—Cluster ID (set during enrollment)
ZEN_TENANT_ID—Tenant 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 (now Target)​

A delivery target (URL + cluster + adapter mapping). The CRD name Destination is a legacy wire name; the current product term is Target.

EndpointConfig​

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

Ingester​

An event intake point with its routing rules.