Commit 43ab93fb authored by Patrick Bogen's avatar Patrick Bogen

Update docs for k8s pods sd

parent 7ee4c031
...@@ -309,18 +309,19 @@ feature to replace the special `__address__` label. ...@@ -309,18 +309,19 @@ feature to replace the special `__address__` label.
CAUTION: Kubernetes SD is in beta: breaking changes to configuration are still 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 [Kubernetes'](http://kubernetes.io/) REST API. By default, this discovers API
API servers, nodes, and appropriately annotated services so that metrics from both servers, nodes, pods, and appropriately annotated services so that metrics from
cluster components and deployed applications can be scraped. This will create both cluster components and deployed applications can be scraped. This will
multiple target groups: one for all API servers with each API server as a target, one create multiple target groups: one for all API servers with each API server as a
for all nodes with each node as a target, and one for each service containing target, one for all nodes with each node as a target, one for each service
each service endpoint as a target. containing each service endpoint as a target; and one for all pods with each
(Pod,ContainerPort) tuple as a target, both with and without HTTPS.
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 `apiserver`, `node` * `__meta_kubernetes_role`: the role of the target: one of `apiserver`,
or `service` `endpoint`, `node`, `pod` or `service`
* `__meta_kubernetes_node_label_<labelname>`: each node label from the * `__meta_kubernetes_node_label_<labelname>`: each node label from the
Kubernetes API Kubernetes API
* `__meta_kubernetes_service_namespace`: the namespace of the service * `__meta_kubernetes_service_namespace`: the namespace of the service
...@@ -329,6 +330,13 @@ Kubernetes API ...@@ -329,6 +330,13 @@ Kubernetes API
Kubernetes API Kubernetes API
* `__meta_kubernetes_service_annotation_<annotationname>`: each service * `__meta_kubernetes_service_annotation_<annotationname>`: each service
annotation from the Kubernetes API annotation from the Kubernetes API
* `__meta_kubernetes_pod_name`: the name of the pod
* `__meta_kubernetes_pod_namespace`: the namespace of the service
* `__meta_kubernetes_pod_address`: the PodIP of the pod
* `__meta_kubernetes_pod_label_<labelname>`: each pod label from the Kubernetes
API
* `__meta_kubernetes_pod_annotation_<annotationname>`: each pod annotation from
the Kubernetes API
In addition, the `instance` label for node metrics will be set to the node name In addition, the `instance` label for node metrics will be set to the node name
as retrieved from the API server. as retrieved from the API server.
......
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