Skip to content

Commit e979759

Browse files
committed
expand kubernetes docs
1 parent e3d56aa commit e979759

File tree

1 file changed

+39
-1
lines changed

1 file changed

+39
-1
lines changed

content/integrations/kubernetes.md

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,47 @@ kind: integration
55
git_integration_title: kubernetes
66
---
77

8+
# Overview
9+
810
Get metrics from your Kubelets in real time to:
911

10-
* Visualize your Kubernetes cluster performance
12+
* Vizualize your Kubernetes cluster performance
13+
* Collect performances metrics for your containers, pods, container namespaces
14+
* Create monitors on the status of your Kubelets
15+
* Ingest Kubernetes labels as tags in Datadog.
16+
17+
# Installation
18+
19+
The Kubernetes integration is deployed as a docker container along side your existing workloads.
20+
21+
## Installation via DaemonSets (Kubernetes >=1.1.0)
22+
23+
If you are running Kubernetes >= 1.2.0, you can take advantage of DaemonSets to automatically deploy the Datadog Agent on all your nodes. On clusters running 1.1.x you will need to explicitly [enable the DaemonSets extension](http://kubernetes.io/v1.1/docs/admin/daemons.html#caveats).
24+
25+
1. Download the [dd-agent.yaml](https://app.datadoghq.com/account/settings#agent/kubernetes) manifest file.
26+
1. Launch dd-agent:
27+
kubectl create -f dd-agent.yaml
28+
29+
## Manual Installation
30+
31+
If DaemonSets are not an option for your Kubernetes cluster, you will need to install the Datadog agent as a sidecar container on each Kubernetes node.
32+
33+
docker run -d --name dd-agent -h `hostname` -v /var/run/docker.sock:/var/run/docker.sock -v /proc/:/host/proc/:ro -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro -e API_KEY='YOUR_API_KEY_HERE' datadog/docker-dd-agent:kubernetes
34+
35+
# Configuration
36+
37+
If you would like to customize your Agent configuration, please refer to the Agent [container documentation](https://github.com/DataDog/docker-dd-agent).
38+
39+
# Validation
40+
41+
To verify the Datadog agent is running in your environment as a daemonset, execeute:
42+
43+
$ kubectl get daemonset
44+
45+
If the agent is deployed you will see similar output to the text below, where desired and current are equal to the number of running nodes in your cluster.
46+
47+
NAME DESIRED CURRENT NODE-SELECTOR AGE
48+
dd-agent 3 3 <none> 11h
1149

1250
### Metrics
1351

0 commit comments

Comments
 (0)