Kong
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Kong

Agent Check Check de l'Agent

Supported OS: Linux Mac OS Windows

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 paquet de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos serveurs Kong.

Configuration

Host

Suivez les instructions ci-dessous pour configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la section Environnement conteneurisé pour en savoir plus sur les environnements conteneurisés.

Collecte de métriques
  1. 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/
  2. 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.

  1. La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :

    logs_enabled: true
  2. 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.

  3. 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ètreValeur
<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ètreValeur
<CONFIG_LOG>{"source": "kong", "service": "<NOM_SERVICE>"}

Validation

Lancez la sous-commande status de l’Agent et cherchez kong dans la section Checks.

Données collectées

Métriques

kong.table.count
(gauge)
Total number of tables in the database.
Shown as table
kong.table.items
(gauge)
Number of items in each table of the database.
Shown as row
kong.connections_accepted
(gauge)
Total number of accepted client connections.
Shown as connection
kong.connections_active
(gauge)
Current number of active client connections including Waiting connections.
Shown as connection
kong.connections_handled
(gauge)
Total number of handled connections. (Same as accepts unless resource limits were reached).
Shown as connection
kong.connections_reading
(gauge)
Current number of connections where Kong is reading the request header.
Shown as connection
kong.connections_waiting
(gauge)
Current number of idle client connections waiting for a request.
Shown as connection
kong.connections_writing
(gauge)
Current number of connections where nginx is writing the response back to the client.
Shown as connection
kong.total_requests
(gauge)
Total number of client requests.
Shown as request

É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.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin