-
Notifications
You must be signed in to change notification settings - Fork 5.6k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat(kubernetes): Add kubernetes input plugin
closes #1774
- Loading branch information
Jonathan Chauncey
committed
Oct 4, 2016
1 parent
ce5054c
commit 2375690
Showing
6 changed files
with
814 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,179 @@ | ||
| # Kubernetes Input Plugin | ||
| This input plugin talks to the kubelet api using the `/stats/summary` endpoint to gather metrics about the running pods and containers for a single host. It is assumed that this plugin is running as part of a `daemonset` within a kubernetes installation. This means that telegraf is running on every node within the cluster. Therefore, you should configure this plugin to talk to its locally running kubelet. | ||
|
|
||
| To find the ip address of the host you are running on you can issue a command like the following: | ||
| ``` | ||
| $ curl -s $API_URL/api/v1/namespaces/$POD_NAMESPACE/pods/$HOSTNAME --header "Authorization: Bearer $TOKEN" --insecure | jq -r '.status.hostIP' | ||
| ``` | ||
| In this case we used the downward API to pass in the `$POD_NAMESPACE` and `$HOSTNAME` is the hostname of the pod which is set by the kubernetes API. | ||
|
|
||
| ## Summary Data | ||
|
|
||
| ```json | ||
| { | ||
| "node": { | ||
| "nodeName": "node1", | ||
| "systemContainers": [ | ||
| { | ||
| "name": "kubelet", | ||
| "startTime": "2016-08-25T18:46:52Z", | ||
| "cpu": { | ||
| "time": "2016-09-27T16:57:31Z", | ||
| "usageNanoCores": 56652446, | ||
| "usageCoreNanoSeconds": 101437561712262 | ||
| }, | ||
| "memory": { | ||
| "time": "2016-09-27T16:57:31Z", | ||
| "usageBytes": 62529536, | ||
| "workingSetBytes": 62349312, | ||
| "rssBytes": 47509504, | ||
| "pageFaults": 4769397409, | ||
| "majorPageFaults": 13 | ||
| }, | ||
| "rootfs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800 | ||
| }, | ||
| "logs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800 | ||
| }, | ||
| "userDefinedMetrics": null | ||
| }, | ||
| { | ||
| "name": "bar", | ||
| "startTime": "2016-08-25T18:46:52Z", | ||
| "cpu": { | ||
| "time": "2016-09-27T16:57:31Z", | ||
| "usageNanoCores": 56652446, | ||
| "usageCoreNanoSeconds": 101437561712262 | ||
| }, | ||
| "memory": { | ||
| "time": "2016-09-27T16:57:31Z", | ||
| "usageBytes": 62529536, | ||
| "workingSetBytes": 62349312, | ||
| "rssBytes": 47509504, | ||
| "pageFaults": 4769397409, | ||
| "majorPageFaults": 13 | ||
| }, | ||
| "rootfs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800 | ||
| }, | ||
| "logs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800 | ||
| }, | ||
| "userDefinedMetrics": null | ||
| } | ||
| ], | ||
| "startTime": "2016-08-25T18:46:52Z", | ||
| "cpu": { | ||
| "time": "2016-09-27T16:57:41Z", | ||
| "usageNanoCores": 576996212, | ||
| "usageCoreNanoSeconds": 774129887054161 | ||
| }, | ||
| "memory": { | ||
| "time": "2016-09-27T16:57:41Z", | ||
| "availableBytes": 10726387712, | ||
| "usageBytes": 12313182208, | ||
| "workingSetBytes": 5081538560, | ||
| "rssBytes": 35586048, | ||
| "pageFaults": 351742, | ||
| "majorPageFaults": 1236 | ||
| }, | ||
| "network": { | ||
| "time": "2016-09-27T16:57:41Z", | ||
| "rxBytes": 213281337459, | ||
| "rxErrors": 0, | ||
| "txBytes": 292869995684, | ||
| "txErrors": 0 | ||
| }, | ||
| "fs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800, | ||
| "usedBytes": 16754286592 | ||
| }, | ||
| "runtime": { | ||
| "imageFs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800, | ||
| "usedBytes": 5809371475 | ||
| } | ||
| } | ||
| }, | ||
| "pods": [ | ||
| { | ||
| "podRef": { | ||
| "name": "foopod", | ||
| "namespace": "foons", | ||
| "uid": "6d305b06-8419-11e6-825c-42010af000ae" | ||
| }, | ||
| "startTime": "2016-09-26T18:45:42Z", | ||
| "containers": [ | ||
| { | ||
| "name": "foocontainer", | ||
| "startTime": "2016-09-26T18:46:43Z", | ||
| "cpu": { | ||
| "time": "2016-09-27T16:57:32Z", | ||
| "usageNanoCores": 846503, | ||
| "usageCoreNanoSeconds": 56507553554 | ||
| }, | ||
| "memory": { | ||
| "time": "2016-09-27T16:57:32Z", | ||
| "usageBytes": 30789632, | ||
| "workingSetBytes": 30789632, | ||
| "rssBytes": 30695424, | ||
| "pageFaults": 10761, | ||
| "majorPageFaults": 0 | ||
| }, | ||
| "rootfs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800, | ||
| "usedBytes": 57344 | ||
| }, | ||
| "logs": { | ||
| "availableBytes": 84379979776, | ||
| "capacityBytes": 105553100800, | ||
| "usedBytes": 24576 | ||
| }, | ||
| "userDefinedMetrics": null | ||
| } | ||
| ], | ||
| "network": { | ||
| "time": "2016-09-27T16:57:34Z", | ||
| "rxBytes": 70749124, | ||
| "rxErrors": 0, | ||
| "txBytes": 47813506, | ||
| "txErrors": 0 | ||
| }, | ||
| "volume": [ | ||
| { | ||
| "availableBytes": 7903948800, | ||
| "capacityBytes": 7903961088, | ||
| "usedBytes": 12288, | ||
| "name": "volume1" | ||
| }, | ||
| { | ||
| "availableBytes": 7903956992, | ||
| "capacityBytes": 7903961088, | ||
| "usedBytes": 4096, | ||
| "name": "volume2" | ||
| }, | ||
| { | ||
| "availableBytes": 7903948800, | ||
| "capacityBytes": 7903961088, | ||
| "usedBytes": 12288, | ||
| "name": "volume3" | ||
| }, | ||
| { | ||
| "availableBytes": 7903952896, | ||
| "capacityBytes": 7903961088, | ||
| "usedBytes": 8192, | ||
| "name": "volume4" | ||
| } | ||
| ] | ||
| } | ||
| ] | ||
| } | ||
| ``` |
Oops, something went wrong.