Versión de la integración5.1.0
Este check monitoriza Cilium a través del Datadog Agent. La integración puede recopilar métricas de cilium-agent
o cilium-operator
.
Configuración
Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecuta en un host. Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de estas instrucciones.
Instalación
El check de Cilium está incluido en el paquete del Datadog Agent, pero requiere pasos de configuración adicionales para exponer las métricas de Prometheus.
Comenzando con la versión 1.10.0, esta integración basada en OpenMetrics tiene un modo más reciente (use_openmetrics
: true) y un modo heredado (use_openmetrics
: false). Para obtener todas las funciones más actualizadas, Datadog recomienda habilitar el modo más reciente. Para obtener más información, consulta Versiones más recientes y heredadas de integraciones basadas en OpenMetrics.
- Para habilitar las métricas de Prometheus tanto en
cilium-agent
como en cilium-operator
, despliega Cilium con los siguientes valores de Helm establecidos según tu versión de Cilium:- Versiones de Cilium anteriores a 1.8.x:
global.prometheus.enabled=true
- Versiones de Cilium 1.8.x o posteriores y anteriores a 1.9.x:
global.prometheus.enabled=true
y global.operatorPrometheus.enabled=true
- Versiones de Cilium 1.9.x o posteriores:
prometheus.enabled=true
y operator.prometheus.enabled=true
O bien, habilita métricas de Prometheus por separado en los manifiestos de Kubernetes:
En cilium-agent
, añade --prometheus-serve-addr=:9962
a la sección args
de la configuración de DaemonSet de Cilium:
# [...]
spec:
containers:
- args:
- --prometheus-serve-addr=:9962
En cilium-operator
, añade --enable-metrics
a la sección args
de la configuración de despliegue de Cilium:
# [...]
spec:
containers:
- args:
- --enable-metrics
Configuración
Host
Para configurar este check para un Agent que se ejecuta en un host:
Edita el archivo cilium.d/conf.yaml
, que se encuentra en la carpeta conf.d/
en la raíz del directorio de configuración de tu Agent, para empezar a recopilar los datos de rendimiento de tu Cilium. Para conocer todas las opciones de configuración disponibles, consulta el cilium.d/conf.yaml de ejemplo.
- Para recopilar métricas
cilium-agent
, habilita la opción agent_endpoint
. - Para recopilar métricas
cilium-operator
, habilita la opción operator_endpoint
.
instances:
## @param use_openmetrics - boolean - optional - default: false
## Use the latest OpenMetrics implementation for more features and better performance.
##
## Note: To see the configuration options for the legacy OpenMetrics implementation (Agent 7.33 or older),
## see https://github.com/DataDog/integrations-core/blob/7.33.x/cilium/datadog_checks/cilium/data/conf.yaml.example
#
- use_openmetrics: true # Enables OpenMetrics latest mode
## @param agent_endpoint - string - optional
## The URL where your application metrics are exposed by Prometheus.
## By default, the Cilium integration collects `cilium-agent` metrics.
## One of agent_endpoint or operator_endpoint must be provided.
#
agent_endpoint: http://localhost:9090/metrics
## @param operator_endpoint - string - optional
## Provide instead of `agent_endpoint` to collect `cilium-operator` metrics.
## Cilium operator metrics are exposed on port 6942.
#
operator_endpoint: http://localhost:6942/metrics
Reinicia el Agent.
Recopilación de logs
Cilium contiene dos tipos de logs: cilium-agent
y cilium-operator
.
La recopilación de Logs se encuentra deshabilitada por defecto en el Datadog Agent. Habilítala en tu configuración de DaemonSet:
# (...)
env:
# (...)
- name: DD_LOGS_ENABLED
value: "true"
- name: DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL
value: "true"
# (...)
Monta el socket de Docker en el Datadog Agent a través del manifiesto o monta el directorio /var/log/pods
si no estás usando Docker. Para ver ejemplos de manifiestos, consulta las Instrucciones de instalación de Kubernetes para DaemonSet.
Reinicia el Agent.
Contenedores
Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.
La recopilación de logs se encuentra deshabilitada de manera predeterminada en el Datadog Agent. Para habilitarla, consulta Recopilación de logs de Kubernetes.
Para recopilar métricas cilium-agent
y logs:
Parámetro | Valor |
---|
<INTEGRATION_NAME> | "cilium" |
<INIT_CONFIG> | en blanco o {} |
<INSTANCE_CONFIG> | {"agent_endpoint": "http://%%host%%:9090/metrics", "use_openmetrics": "true"} |
Parámetro | Valor |
---|
<LOG_CONFIG> | {"source": "cilium-agent", "service": "cilium-agent"} |
Para recopilar métricas cilium-operator
y logs:
Parámetro | Valor |
---|
<INTEGRATION_NAME> | "cilium" |
<INIT_CONFIG> | en blanco o {} |
<INSTANCE_CONFIG> | {"operator_endpoint": "http://%%host%%:6942/metrics", "use_openmetrics": "true"} |
Parámetro | Valor |
---|
<LOG_CONFIG> | {"source": "cilium-operator", "service": "cilium-operator"} |
Validación
Ejecuta el subcomando de estado del Agent y busca cilium
en la sección Checks.
Datos recopilados
Métricas
Eventos
La integración Cilium no incluye eventos.
Checks de servicio
Solucionar problemas
¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.