Commit db2869b1 authored by Jimmi Dyson's avatar Jimmi Dyson

Update Kubernetes SD docs

Fixes #202
parent fefdb4eb
...@@ -278,14 +278,17 @@ CAUTION: Kubernetes SD is in beta: breaking changes to configuration are still ...@@ -278,14 +278,17 @@ CAUTION: Kubernetes SD is in beta: breaking changes to configuration are still
likely in future releases. likely in future releases.
Kubernetes SD configurations allow retrieving scrape targets from Kubernetes SD configurations allow retrieving scrape targets from
[Kubernetes'](http://kubernetes.io/) REST API. By default, this discovers nodes [Kubernetes'](http://kubernetes.io/) REST API. By default, this discovers
and appropriately annotated services so that metrics from both cluster masters, nodes, and appropriately annotated services so that metrics from both
components and deployed applications can be scraped. This will create multiple cluster components and deployed applications can be scraped. This will create
target groups: one for all nodes with each node as a target; and one for each multiple target groups: one for all masters with each master as a target, one
service containing each service endpoint as a target. for all nodes with each node as a target, and one for each service containing
each service endpoint as a target.
The following meta labels are available on targets during relabeling: The following meta labels are available on targets during relabeling:
* `__meta_kubernetes_role`: the role of the target: one of `master`, `node` or
`service`
* `__meta_kubernetes_node`: the name of the node from the Kubernetes API * `__meta_kubernetes_node`: the name of the node from the Kubernetes API
* `__meta_kubernetes_node_label_<labelname>`: each node label from the * `__meta_kubernetes_node_label_<labelname>`: each node label from the
Kubernetes API Kubernetes API
...@@ -301,9 +304,10 @@ See below for the configuration options for Kubernetes discovery: ...@@ -301,9 +304,10 @@ See below for the configuration options for Kubernetes discovery:
``` ```
# The information to access the Kubernetes API. # The information to access the Kubernetes API.
# The server address. In a cluster this will normally be # The master addresses. In a cluster this will normally be
# https://kubernetes.default.svc. # `https://kubernetes.default.svc`. Supports multiple HA masters.
server: <host> masters:
- [<host>]
# Run in cluster. This will use the automounted CA certificate and bearer # Run in cluster. This will use the automounted CA certificate and bearer
# token file at /var/run/secrets/kubernetes.io/serviceaccount/ in the pod. # token file at /var/run/secrets/kubernetes.io/serviceaccount/ in the pod.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment