mirror of
				https://github.com/traefik/traefik.git
				synced 2025-10-31 16:31:16 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			159 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			159 lines
		
	
	
		
			2.7 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| ---
 | |
| title: "Traefik Datadog Metrics Documentation"
 | |
| description: "Traefik Proxy supports Datadog for backend metrics. Read the technical documentation to enable Datadog for observability."
 | |
| ---
 | |
| 
 | |
| # Datadog
 | |
| 
 | |
| To enable the Datadog:
 | |
| 
 | |
| ```yaml tab="File (YAML)"
 | |
| metrics:
 | |
|   datadog: {}
 | |
| ```
 | |
| 
 | |
| ```toml tab="File (TOML)"
 | |
| [metrics]
 | |
|   [metrics.datadog]
 | |
| ```
 | |
| 
 | |
| ```bash tab="CLI"
 | |
| --metrics.datadog=true
 | |
| ```
 | |
| 
 | |
| #### `address`
 | |
| 
 | |
| _Required, Default="127.0.0.1:8125"_
 | |
| 
 | |
| Address instructs exporter to send metrics to datadog-agent at this address.
 | |
| 
 | |
| This address can be a Unix Domain Socket (UDS) in the following format: `unix:///path/to/datadog.socket`.
 | |
| When the prefix is set to `unix`, the socket type will be automatically determined. 
 | |
| To explicitly define the socket type and avoid automatic detection, you can use the prefixes `unixgram` for `SOCK_DGRAM` (datagram sockets) and `unixstream` for `SOCK_STREAM` (stream sockets), respectively.
 | |
| 
 | |
| ```yaml tab="File (YAML)"
 | |
| metrics:
 | |
|   datadog:
 | |
|     address: 127.0.0.1:8125
 | |
| ```
 | |
| 
 | |
| ```toml tab="File (TOML)"
 | |
| [metrics]
 | |
|   [metrics.datadog]
 | |
|     address = "127.0.0.1:8125"
 | |
| ```
 | |
| 
 | |
| ```bash tab="CLI"
 | |
| --metrics.datadog.address=127.0.0.1:8125
 | |
| ```
 | |
| 
 | |
| #### `addEntryPointsLabels`
 | |
| 
 | |
| _Optional, Default=true_
 | |
| 
 | |
| Enable metrics on entry points.
 | |
| 
 | |
| ```yaml tab="File (YAML)"
 | |
| metrics:
 | |
|   datadog:
 | |
|     addEntryPointsLabels: true
 | |
| ```
 | |
| 
 | |
| ```toml tab="File (TOML)"
 | |
| [metrics]
 | |
|   [metrics.datadog]
 | |
|     addEntryPointsLabels = true
 | |
| ```
 | |
| 
 | |
| ```bash tab="CLI"
 | |
| --metrics.datadog.addEntryPointsLabels=true
 | |
| ```
 | |
| 
 | |
| #### `addRoutersLabels`
 | |
| 
 | |
| _Optional, Default=false_
 | |
| 
 | |
| Enable metrics on routers.
 | |
| 
 | |
| ```toml tab="File (TOML)"
 | |
| [metrics]
 | |
|   [metrics.datadog]
 | |
|     addRoutersLabels = true
 | |
| ```
 | |
| 
 | |
| ```yaml tab="File (YAML)"
 | |
| metrics:
 | |
|   datadog:
 | |
|     addRoutersLabels: true
 | |
| ```
 | |
| 
 | |
| ```bash tab="CLI"
 | |
| --metrics.datadog.addrouterslabels=true
 | |
| ```
 | |
| 
 | |
| #### `addServicesLabels`
 | |
| 
 | |
| _Optional, Default=true_
 | |
| 
 | |
| Enable metrics on services.
 | |
| 
 | |
| ```yaml tab="File (YAML)"
 | |
| metrics:
 | |
|   datadog:
 | |
|     addServicesLabels: true
 | |
| ```
 | |
| 
 | |
| ```toml tab="File (TOML)"
 | |
| [metrics]
 | |
|   [metrics.datadog]
 | |
|     addServicesLabels = true
 | |
| ```
 | |
| 
 | |
| ```bash tab="CLI"
 | |
| --metrics.datadog.addServicesLabels=true
 | |
| ```
 | |
| 
 | |
| #### `pushInterval`
 | |
| 
 | |
| _Optional, Default=10s_
 | |
| 
 | |
| The interval used by the exporter to push metrics to datadog-agent.
 | |
| 
 | |
| ```yaml tab="File (YAML)"
 | |
| metrics:
 | |
|   datadog:
 | |
|     pushInterval: 10s
 | |
| ```
 | |
| 
 | |
| ```toml tab="File (TOML)"
 | |
| [metrics]
 | |
|   [metrics.datadog]
 | |
|     pushInterval = "10s"
 | |
| ```
 | |
| 
 | |
| ```bash tab="CLI"
 | |
| --metrics.datadog.pushInterval=10s
 | |
| ```
 | |
| 
 | |
| #### `prefix`
 | |
| 
 | |
| _Optional, Default="traefik"_
 | |
| 
 | |
| The prefix to use for metrics collection.
 | |
| 
 | |
| ```yaml tab="File (YAML)"
 | |
| metrics:
 | |
|   datadog:
 | |
|     prefix: traefik
 | |
| ```
 | |
| 
 | |
| ```toml tab="File (TOML)"
 | |
| [metrics]
 | |
|   [metrics.datadog]
 | |
|     prefix = "traefik"
 | |
| ```
 | |
| 
 | |
| ```bash tab="CLI"
 | |
| --metrics.datadog.prefix=traefik
 | |
| ```
 |