Skip to content

Commit 6b599ae

Browse files
committed
Updates to containers documentation
1 parent eefb105 commit 6b599ae

File tree

1 file changed

+17
-14
lines changed
  • content/en/infrastructure/containers

1 file changed

+17
-14
lines changed

content/en/infrastructure/containers/_index.md

+17-14
Original file line numberDiff line numberDiff line change
@@ -35,23 +35,25 @@ Coupled with [Docker][2], [Kubernetes][3], [ECS][4], and other container technol
3535

3636
## Setup
3737

38-
To display data on the Containers view, enable the Process Agent.
38+
To display data on the Containers view, ensure that container collection is enabled.
3939

4040
{{< tabs >}}
4141
{{% tab "Docker" %}}
4242

43-
Set the `DD_PROCESS_AGENT_ENABLED` env variable to `true`.
43+
The Datadog Agent enables container collection in Docker environments by default.
44+
45+
For verification, ensure that `DD_PROCESS_CONFIG_CONTAINER_COLLECTION_ENABLED` is set to `true`.
4446

4547
For example:
4648

4749
```
4850
-v /etc/passwd:/etc/passwd:ro
49-
-e DD_PROCESS_AGENT_ENABLED=true
51+
-e DD_PROCESS_CONFIG_CONTAINER_COLLECTION_ENABLED=true
5052
```
5153
{{% /tab %}}
5254
{{% tab "Datadog Operator" %}}
5355

54-
The Datadog Operator enables the Process Agent by default.
56+
The Datadog Operator enables container collection by default.
5557

5658
For verification, ensure that `features.liveContainerCollection.enabled` is set to `true` in your `datadog-agent.yaml`:
5759

@@ -73,38 +75,40 @@ spec:
7375
{{% /tab %}}
7476
{{% tab "Helm" %}}
7577
76-
If you are using the [official Helm chart][1], enable the `processAgent.enabled` parameter in your [`values.yaml`][2] file:
78+
If you are using the [official Helm chart][1], container collection is enabled by default.
79+
80+
For verification, ensure that the `processAgent.containerCollection` parameter is set to `true` in your [`values.yaml`][2] file:
7781

7882
```yaml
7983
datadog:
8084
# (...)
8185
processAgent:
82-
enabled: true
86+
containerCollection: true
8387
```
8488

8589
Then, upgrade your Helm chart.
8690

87-
In some setups, the Process Agent and Cluster Agent cannot automatically detect a Kubernetes cluster name. If this happens, the feature does not start, and the following warning displays in the Cluster Agent log: `Orchestrator explorer enabled but no cluster name set: disabling.` In this case, you must set `datadog.clusterName` to your cluster name in `values.yaml`.
91+
In some setups, the Cluster Agent cannot automatically detect a Kubernetes cluster name. If this happens, the feature does not start, and the following warning displays in the Cluster Agent log: `Orchestrator explorer enabled but no cluster name set: disabling.` In this case, you must set `datadog.clusterName` to your cluster name in `values.yaml`.
8892

8993
```yaml
9094
datadog:
9195
#(...)
9296
clusterName: <YOUR_CLUSTER_NAME>
9397
#(...)
9498
processAgent:
95-
enabled: true
99+
containerCollection: true
96100
```
97101

98102
[1]: https://github.com/DataDog/helm-charts
99103
[2]: https://github.com/DataDog/helm-charts/blob/master/charts/datadog/values.yaml
100104
{{% /tab %}}
101105
{{% tab "Amazon ECS" %}}
102106

103-
Update your Task Definitions with the following environment variable:
107+
Update your task definitions with the following environment variable:
104108

105109
```json
106110
{
107-
"name": "DD_PROCESS_AGENT_ENABLED",
111+
"name": "DD_PROCESS_CONFIG_CONTAINER_COLLECTION_ENABLED",
108112
"value": "true"
109113
}
110114
```
@@ -169,14 +173,13 @@ ECS containers are tagged by:
169173
Kubernetes containers are tagged by:
170174

171175
* `pod_name`
172-
* `kube_pod_ip`
173176
* `kube_service`
174177
* `kube_namespace`
175178
* `kube_replica_set`
176179
* `kube_daemon_set`
177180
* `kube_job`
178181
* `kube_deployment`
179-
* `kube_cluster`
182+
* `kube_cluster_name`
180183

181184
If you have a configuration for [Unified Service Tagging][7] in place, Datadog automatically picks up `env`, `service`, and `version` tags. Having these tags available lets you tie together APM, logs, metrics, and container data.
182185

@@ -194,7 +197,7 @@ You can switch between the "Scatter Plot" and "Timeseries" tabs in the collapsib
194197

195198
By default, the graph groups by the `short_image` tag key. The size of each dot represents the number of containers in that group, and clicking on a dot displays the individual containers and hosts that contribute to the group.
196199

197-
The query at the top of the scatter plot analytic allows you to control your scatter plot analytic:
200+
The options at the top of the graph allows you to control your scatter plot analytic:
198201

199202
* Selection of metrics to display.
200203
* Selection of the aggregation method for both metrics.
@@ -226,7 +229,7 @@ You can see indexed logs that you have chosen to index and persist by selecting
226229

227230
{{< img src="infrastructure/livecontainers/errorlogs.png" alt="Preview Logs Side panel" style="width:100%;">}}
228231

229-
## Notes and known issues
232+
## Additional information
230233

231234
* Real-time (2s) data collection is turned off after 30 minutes. To resume real-time collection, refresh the page.
232235
* RBAC settings can restrict Kubernetes metadata collection. See the [RBAC entities for the Datadog Agent][14].

0 commit comments

Comments
 (0)