Environment & Configuration

This page covers Helm values for controlling agent environment, pipeline configuration, and runtime behavior.

Environment Variables

The Edge Delta Helm charts surface many environment-style toggles as top-level values.yaml fields. Setting these values is the preferred, GitOps-friendly way to control agent behavior rather than editing pod specs by hand.

Leave a value empty ("") to accept the chart’s default behavior.

Use either --set key=value in the CLI or a values file:

Example:

helm upgrade edgedelta edgedelta/edgedelta -i --version v1.17.0 \
  --set secretApiKey.value=<pipeline-id> \
  --set edClusterName="production-us-west-2" \
  --set edBackendDisabled=false \
  -n edgedelta --create-namespace

Edge Delta Custom Tags

Variable: edCustomTags

Description: Custom tags are pipe (|) delimited key:value pairs that are attached to all outgoing data from Edge Delta agents to their configured destinations. These tags can, for example, provide valuable metadata about the data’s origin, such as the cluster name, cloud provider, and region.

Example:

--set edCustomTags="cluster:prod_us_west_2_cluster|provider:aws|region:us_west_2"

To confirm that custom tags have been applied, get the list of pods in the edgedelta namespace:

kubectl get pods -n edgedelta

Describe one of the Edge Delta pods to check for the custom tags:

kubectl describe pod <edge-delta-pod-name> -n edgedelta

Check the Environment section within the edgedelta-agent container:

ED_CUSTOM_TAGS: cluster:prod_us_west_2_cluster|provider:aws|region:us_west_2

Verify logs in Edge Delta: Check the logs in Edge Delta and confirm that they contain the following attributes:

{
  "cluster": "prod_us_west_2_cluster",
  "provider": "aws",
  "region": "us_west_2"
}

Edge Delta Tag Override

Variable: edTagOverride

Description: Specifies a pipeline tag that is different from the one configured in the Web App. Use this option to deploy two pipelines with the same configuration. A best practice is to share pipeline configurations using packs, rather than duplicating pipelines.

Example:

--set edTagOverride=<new name>

Edge Delta Workflows

Variable: edWorkflows

Description: A colon-separated list of workflow names to enable matching workflows in version 2 (deprecated) agents. By default, all other workflow names are enabled when edWorkflows and edWorkflowPrefixes are not configured.

Example: "billing-workflow:error-workflow"

Edge Delta Workflow Prefixes

Variable: edWorkflowPrefixes

Description: A colon-separated list of workflow prefixes to enable all matching workflows in version 2 (deprecated) agents. By default, all other workflow names are enabled when edWorkflows and edWorkflowPrefixes are not configured.

Example: "billing:error"

Force Reinstall Apps

Variable: forceReinstallApplications

Description: Enables (true) or disables (false) the pre-upgrade force-reinstall hook. When enabled, Helm creates a short-lived Job that runs before every upgrade. The Job deletes any existing processor and compactor workloads so the upgrade can recreate them from scratch.

Example:

--set forceReinstallApplications.enabled=true

Docker Container Properties

Variable: dockerContainerProps

Description: This helm value configures the path to Docker container logs on a Kubernetes node. It is used by Edge Delta agents for self-discovery, enabling them to access and analyze Docker container logs.

Available in node chart only.

Example:

--set dockerContainerProps.hostPath="/var/lib/docker/containers"

To confirm the existence of the specified path mount in the agent’s pod:

kubectl get pods -n edgedelta

Retrieve the name of one of the Edge Delta agent pods and replace <edgedelta-agent-pod-name> in the following command:

kubectl describe pod <edgedelta-agent-pod-name> -n edgedelta

Look under the Mounts section for the specified path /var/lib/docker/containers.

Edge Delta Suppression Mode

Variable: edSuppressionMode

Description: The edSuppressionMode Helm value configures version 2 (deprecated) Edge Delta agents to suppress new issue notifications if similar issues have already been reported by the same or other agents.