Enable Kube State Metrics
The latest versions of Sysdig agent collects the following Kube State Metrics (KSM) families out of the box. These can not be disabled as they are required for certain parts of the Sysdig platform to function:
cronjobs
daemonsets
deployments
jobs
namespaces
nodes
pods
replicasets
replicationcontrollers
statefulsets
The following Kube State Metrics familes are collected by default but can be disabled if desired:
services
resourcequotas
persistentvolumes
persistentvolumeclaims
storageclasses
However you can further customize KSM collection for specific metrics as follows:
Customize KSM Collection
Agent Versions 12.9.0 and Above
The following metric familes are available to be scraped by the Sysdig Agent but are not enabled by default.
certificatesigningrequests
horizontalpodautoscalers
ingresses
To enable the agent to collect the above metric families, you must edit the agent configuration file, dragent.yaml
, and include them along with the other resources you would like to collect.
For example, to collect all configurable resources including ingresses
and certificatesigningrequests
, add the following to dragent.yaml
:
k8s_extra_resources:
include:
- ingresses
- certificatesigningrequests
- services
- resourcequotas
- persistentvolumes
- persistentvolumeclaims
- storageclasses
NOTE: When configuring k8s_extra_resources
you must include all configurable Kube State Metrics families in order to collect metrics from those families. If you add ingresses
but remove services
, for example, the Sysdig agent will no longer collect services
metrics. Adding only the ingresses
or certificatesigningrequests
configuration as follows will instruct the Sysdig agent to not collect the other configurable KSM services.
k8s_extra_resources:
include:
- ingresses
- certificatesigningrequests
Therefore, ensure that you include the entire block of configuration corresponding to all the Kubernetes resources you wish to collect.
Agent Versions 12.5.0 and Above
horizontalpodautoscalers
(HPA) kube state metrics are not collected by default. To enable the agent to collect HPA kube state metrics, you must edit the agent configuration file, dragent.yaml
, and include it along with the other resources you would like to collect.
For example, to collect all supported resources including HPAs, add the following to dragent.yaml
:
k8s_extra_resources:
include:
- services
- resourcequotas
- persistentvolumes
- persistentvolumeclaims
- horizontalpodautoscalers
NOTE: When configuring k8s_extra_resources
you must include all configurable Kube State Metrics families in order to collect metrics from those families. If you add horizontalpodautoscalers
but remove services
, for example, the Sysdig agent will no longer collect services
metrics. Adding only the horizontalpodautoscalers
configuration as follows will instruct the Sysdig agent to not collect the other configurable KSM services.
k8s_extra_resources:
include:
- horizontalpodautoscalers
Therefore, ensure that you include the entire block of configuration corresponding to all the Kubernetes resources you wish to collect.
Agent Versions 12.3.x and 12.4.x
The Sysdig agent collects HPA, PVS, PV, Resourcequota, and Services kube state metrics by default.
To disable some of them, you must edit the agent config file, dragent.yaml
, as follows:
k8s_extra_resources:
include:
- services
- resourcequotas
- persistentvolumes
- persistentvolumeclaims
- horizontalpodautoscalers
The above list includes all the supported resources so you must remove the resources you are not interested in.
For example, if you want to disable services
, use the following:
k8s_extra_resources:
include:
- resourcequotas
- persistentvolumes
- persistentvolumeclaims
- horizontalpodautoscalers
For more information, see Understanding the Agent Configuration Files.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.