Node Agent Configuration

The NudgeBee Node Agent can be finely tuned using a set of environment variables that control its behavior. These are exposed as flags internally but can be set through the Helm values.yaml under the nodeAgent.env section.

This document lists the relevant configuration flags, what they do, and how to set them.

🌐 Network & Listening

Flag	Description	Default
`LISTEN`	Address the agent listens on (`ip:port` or `:port`)	`0.0.0.0:80`
`CGROUPFS_ROOT`	Path to cgroup filesystem mount	`/sys/fs/cgroup`
`EPHEMERAL_PORT_RANGE`	Skip tracking these TCP port ranges	`32768-60999`
`TRACK_PUBLIC_NETWORK`	Whitelisted public IP networks to track	`0.0.0.0/0`

🔍 Metrics & Logs

Flag	Description	Default
`DISABLE_LOG_PARSING`	Disable container log parsing	`false`
`DISABLE_L7_TRACING`	Disable Layer 7 (application-level) tracing	`false`
`DISABLE_PINGER`	Disable upstream pinging	`true`
`LOG_PER_SECOND`	Max number of logs processed per second	`10.0`
`LOG_BURST`	Max log burst capacity (tokens)	`100`
`MAX_LABEL_LENGTH`	Maximum length for any metric label value	`4096`
`EXCLUDE_HTTP_REQUESTS_BY_PATH`	Skip HTTP metrics by path (comma-separated)	(none)

🛡 Sensitive Handling

Flag	Description	Default
`SANITIZE_HEADERS`	Enable header sanitization	`true`
`SENSITIVE_HEADERS`	List of sensitive header names to sanitize (comma-separated)	`Authorization, Cookie, X-Action-Token`
`DISABLE_SENSITIVE_LOG_PARSING`	Disable sensitive log parsing, default is disabled	`true`

☁ Cloud Labels

These enrich the node_cloud_info metric:

Flag	Description
`PROVIDER`	Cloud provider name
`REGION`	Cloud region
`AVAILABILITY_ZONE`	Availability zone
`ACCOUNT_ID`	Cloud account ID
`INSTANCE_TYPE`	Instance type
`INSTANCE_LIFE_CYCLE`	Instance lifecycle (spot/on-demand)

🔗 External Endpoints

Flag	Description
`COLLECTOR_ENDPOINT`	Base endpoint for all telemetry
`API_KEY`	Coroot API key (if applicable)
`METRICS_ENDPOINT`	Specific metrics push endpoint
`TRACES_ENDPOINT`	Specific traces push endpoint
`LOGS_ENDPOINT`	Specific logs push endpoint
`PROFILES_ENDPOINT`	Specific profiles push endpoint
`INSECURE_SKIP_VERIFY`	Skip TLS verification (not recommended)

🔄 Scraping & Storage

Flag	Description	Default
`SCRAPE_INTERVAL`	How often to gather metrics	`15s`
`WAL_DIR`	Where to store Write-Ahead Logs	`/tmp/coroot-node-agent`

🔧 Other Useful Flags

Flag	Description	Default
`RESOLVE_DNS`	Enable DNS resolution	`false`
`IGNORE_CONTROL_PLANE`	Ignore these control plane components	`karpenter,loki,prometheus,grafana,kubelet,etcd,apiserver,victoria,nudgebee-agent,kube-system`
`TRACE_ID_HEADERS`	Headers to extract trace IDs	`Traceparent,X-Request-Id`

🚀 Applying Configurations

Here’s an example values.yaml with common flags explicitly set:

nodeAgent:
  env:
    - name: LISTEN
      value: ":8080"
    - name: DISABLE_LOG_PARSING
      value: "true"
    - name: LOG_PER_SECOND
      value: "20"
    - name: SANITIZE_HEADERS
      value: "true"
    - name: SENSITIVE_HEADERS
      value: "Authorization,Proxy-Authorization,Cookie,X-Auth-Token"
    - name: PROVIDER
      value: "aws"
    - name: REGION
      value: "us-east-1"
    - name: ACCOUNT_ID
      value: "123456789"
    - name: SCRAPE_INTERVAL
      value: "30s"

To apply these settings, run:

helm upgrade --install nudgebee-agent nudgebee-agent/nudgebee-agent \
  --namespace nudgebee-agent --create-namespace \
  -f values.yaml

🌐 Network & Listening​

🔍 Metrics & Logs​

🛡 Sensitive Handling​

☁ Cloud Labels​

🔗 External Endpoints​

🔄 Scraping & Storage​

🔧 Other Useful Flags​

🚀 Applying Configurations​