Présentation
Le check Kong de l’Agent surveille le nombre total de requêtes, les codes de réponse, les connexions client et bien plus encore.
Configuration
Installation
Le check Kong est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos serveurs Kong.
Configuration
Host
Pour configurer ce check lorsque l’Agent est exécuté sur un host :
Collecte de métriques
Ajoutez le bloc de configuration suivant à votre fichier kong.d/conf.yaml
dans le dossier conf.d/
à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos métriques Kong. Consultez le fichier d’exemple kong.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
init_config:
instances:
## @param kong_status_url - string - required
## URL where Kong exposes its status.
#
- kong_status_url: http://localhost:8001/status/
Avec l’Agent 7+, il est également possible d’utiliser une implémentation plus moderne :
init_config:
instances:
## @param openmetrics_endpoint - string - required
## The URL exposing metrics in the OpenMetrics format.
#
- openmetrics_endpoint: http://localhost:8001/metrics
Redémarrez l’Agent.
Collecte de logs
Disponible à partir des versions > 6.0 de l’Agent
Les logs d’accès Kong sont générés par NGINX. L’emplacement par défaut est donc identique à celui des fichiers NGINX.
La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml
:
Ajoutez ce bloc de configuration à votre fichier kong.d/conf.yaml
pour commencer à recueillir vos logs Kong :
logs:
- type: file
path: /var/log/nginx/access.log
service: '<SERVICE>'
source: kong
- type: file
path: /var/log/nginx/error.log
service: '<SERVICE>'
source: kong
Modifiez les valeurs des paramètres path
et service
et configurez-les pour votre environnement. Consultez le fichier d’exemple kong.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
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> | kong |
<CONFIG_INIT> | vide ou {} |
<CONFIG_INSTANCE> | {"kong_status_url": "http://%%host%%:8001/status/"} |
Collecte de logs
Disponible à partir des versions > 6.0 de l’Agent
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": "kong", "service": "<NOM_SERVICE>"} |
Validation
Lancez la sous-commande de statut de l’Agent et cherchez kong
dans la section Checks.
Données collectées
Métriques
Événements
Le check Kong n’inclut aucun événement.
Checks de service
kong.can_connect :
Renvoie CRITICAL
si l’Agent ne parvient pas à se connecter à Kong pour recueillir des métriques. Si ce n’est pas le cas, renvoie OK
.
Lorsque vous utilisez l’implémentation de l’Agent 7+ en définissant openmetrics_endpoint
:
kong.openmetrics.health :
Renvoie CRITICAL
si l’Agent ne parvient pas à se connecter à l’endpoint OpenMetrics. Si ce n’est pas le cas, renvoie OK
.
kong.datastore.reachable :
Renvoie CRITICAL
si Kong ne parvient pas à se connecter au datastore. Si ce n’est pas le cas, renvoie OK
.
kong.upstream.target.health :
Renvoie CRITICAL
lorsque la cible n’est pas saine. Si ce n’est pas le cas, renvoie OK
.
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
Pour aller plus loin