Présentation
Ce check permet de surveiller Cilium avec l’Agent Datadog. L’intégration peut recueillir des métriques à partir de cilium-agent ou de cilium-operator.
Configuration
Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions à des environnements conteneurisés.
Installation
Le check Cilium est inclus avec le package de l’Agent Datadog, mais des opérations d’installation supplémentaires sont nécessaires pour l’exposition des métriques Prometheus.
Pour activer les métriques Prometheus dans cilium-agent et cilium-operator, déployez Cilium en définissant la valeur Helm global.prometheus.enabled=true.
Vous pouvez également activer les métriques Prometheus séparément :
Dans le cilium-agent, ajoutez --prometheus-serve-addr=:9090 à la section args de la configuration DaemonSet pour Cilium :
# [...]
spec:
containers:
- args:
- --prometheus-serve-addr=:9090
Sinon, dans le cilium-operator, ajoutez --enable-metrics à la section args de la configuration de déploiement de Cilium :
# [...]
spec:
containers:
- args:
- --enable-metrics
Configuration
Host
Pour configurer ce check lorsque l’Agent est exécuté sur un host :
Modifiez le fichier cilium.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance Cilium. Consultez le fichier d’exemple cilium.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
- Pour recueillir les métriques
cilium-agent activez l’option agent_endpoint. - Pour recueillir les métriques
cilium-operator, activez l’option operator_endpoint.
Redémarrez l’Agent.
Collecte de logs
Cilium génère deux types de logs : cilium-agent et cilium-operator.
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans votre configuration DaemonSet :
# (...)
env:
# (...)
- name: DD_LOGS_ENABLED
value: "true"
- name: DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL
value: "true"
# (...)
Montez le socket Docker sur l’Agent Datadog comme dans ce manifeste. Si vous n’utilisez pas Docker, montez le répertoire /var/log/pods.
Redémarrez l’Agent.
Environnement conteneurisé
Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.
Collecte de métriques
| Paramètre | Valeur |
|---|
<NOM_INTÉGRATION> | cilium |
<CONFIG_INIT> | vide ou {} |
<CONFIG_INSTANCE> | {"agent_endpoint": "http://%%host%%:9090/metrics"} |
Collecte de logs
La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs avec Kubernetes.
| Paramètre | Valeur |
|---|
<CONFIG_LOG> | {"source": "cilium-agent", "service": "cilium-agent"} |
Validation
Lancez la sous-commande status de l’Agent et cherchez cilium dans la section Checks.
Données collectées
Métriques
Checks de service
cilium.prometheus.health :
Renvoie CRITICAL si l’Agent ne parvient pas à se connecter aux endpoints de métriques. Si ce n’est pas le cas, renvoie OK.
Événements
Cilium n’inclut aucun événement.
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
