Configuration Library

The Sysdig configuration library lists all the major configuration supported by the Sysdig agent components. This document is evolving and will be updated as new configurations are added to the product.

Sysdig Agent

Generic Configuration

Configuration	dragent.yaml	Helm	Description	Default and Example
Cluster	`k8s_cluster_name`	`global.clusterConfig.name`	Identifier for the Kubernetes cluster where you install the agent. For more information, see Agent Configuration.	For example, `ec2_cluster`
Access Key	`customerid`	global.sysdig.accessKey	See Sysdig Agent Access Keys to learn how to retrieve the agent keys.
Secret	N/A	`global.sysdig.accessKeySecret`	The name of a Kubernetes secret containing an access-key entry.
Region	N/A	`global.sysdig.region`	The SaaS region where the agent is installed. Possible values: `us1`, `us2`, `us3`, `us4`, `eu1`, `au1`, and `custom`. See Regions and IP Ranges for more information.	`us1`
Global Tags	`tags`	`global.sysdig.tags`	Sets the global tags which can override agent tags. See Quick Install Sysdig Agent for more information
Agent Tags	`tags`		The list of tags to identify the host where the agent is installed. For example: `role:webserver`, `location:europe`, `role:webserver`. See Quick Install Sysdig Agent for more information.
Proxy	`http_proxy`	`global.proxy.httpProxy`	Allows the agent to communicate with Sysdig collector through an`http_proxy`. See Enable HTTP Proxy for Agents for more information.
HTTP Proxy Host	`http_proxy.proxy_host`		The host IP of the proxy server.
HTTP Proxy Port	`http_proxy.proxy_port`		See Enable HTTP Proxy for Agents for more information.
	`http_proxy.proxy_user`		See Enable HTTP Proxy for Agents for more information.
	`http_proxy.proxy_password`		See Enable HTTP Proxy for Agents for more information.
	`http_proxy.ssl`		See Enable HTTP Proxy for Agents for more information.
	`http_proxy.ssl_verify_certificate`		See Enable HTTP Proxy for Agents for more information.
	`http_proxy.ca_certificate`		See Enable HTTP Proxy for Agents for more information.
Collector		`collectorSettings.collectorHost`	Enter the host name or IP address of the Sysdig collector service. Note that when used within `dragent.yaml`, must be lowercase collector. See On-Premises Installation for more information.
Collector Port			On-prem only. The port used by the Sysdig collector service.	6443

Monitor-Specific Configuration

Configuration	dragent.yaml	Helm	Description	Default and Example
StatsD	`statsd`		Controls StatsD metric collection.	`enabled`
	`statsd: blacklisted_ports`		See StatsD for more information.
	`statsd: tcp_port`		See StatsD for more information.
	`statsd: udp_port`		See StatsD for more information.
Events	`events: docker`		Controls Event Collection metric collection.
	`events: kubernetes`
Log	`log: event_priority`		Allows you to configure log levels metric collection.
	`log: console_priority`
	`log: file_priority`
Prometheus	`prometheus: enabled`		Controls Prometheus Native Service Discovery.
JMX	`jmx: enabled`		Controls JMX metrics collection.
App Checks	`app_checks: enabled`		Controls monitoring capabilities using App Checks.
KSM	`k8s_extra_resources: - include ...`		Enable and disable Kube State Metrics collection.	`enabled`
Go Events	`go_k8s_user_events`		Streamline Sysdig agent processing times and reduce CPU load.	`false`
Agent Console	`command_line: enabled`		Enable Agent Console to interact with the Sysdig agent to troubleshoot and investigate agent configuration problems quickly.	`enabled`

Secure-Specific Configuration

Configuration	dragent.yaml	Helm	Description	Default and Example
Falco Baseline	`falcobaseline`	`falcobaseline`		`enabled`
Secure Audit Streams	`secure_audit_streams`	`secure_audit_streams`		`enabled`

Feedback

Was this page helpful?

Glad to hear it! Please tell us how we can improve.

Sorry to hear that. Please tell us how we can improve.