StatsD

StatsD

Agent Check Check de l'Agent

Linux Mac OS Windows OS Supported

Présentation

Ce check surveille la disponibilité et l’uptime des serveurs StatsD hors Datadog. Il permet également de suivre le nombre de métriques, par type de métrique, reçues par StatsD.

Ce check ne transfère PAS les métriques d’application des serveurs StatsD vers Datadog. Il recueille les métriques concernant StatsD même.

Configuration

Installation

Le check StatsD est inclus avec le package de l'Agent Datadog : vous n’avez donc rien d’autre à installer sur les serveurs qui exécutent StatsD.

Configuration

Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

  1. Modifiez le fichier statsd.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple statsd.d/conf.yaml pour découvrir toutes les options de configuration disponibles :

    init_config:
    
    instances:
      - host: localhost
        port: 8126 # or wherever your statsd listens
    
  2. Redémarrez l’Agent pour commencer à envoyer vos métriques et checks de service StatsD à Datadog.

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

ParamètreValeur
<NOM_INTÉGRATION>statsd
<CONFIG_INIT>vide ou {}
<CONFIG_INSTANCE>{"host": "%%host%%", "port":"8126"}

Collecte de logs

  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 statsd.d/conf.yaml pour commencer à recueillir vos logs Supervisord :

    logs:
      - type: file
        path: /path/to/my/directory/file.log
        source: statsd
    

    Modifiez la valeur du paramètre path et configurez-la pour votre environnement. Consultez le fichier d’exemple statsd.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

  3. Redémarrez l’Agent.

Validation

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

Données collectées

Métriques

statsd.counters.count
(gauge)
The number of counter metrics currently seen by StatsD
statsd.gauges.count
(gauge)
The number of gauge metrics currently seen by StatsD
statsd.timers.count
(gauge)
The number of timer metrics currently seen by StatsD

Événements

Le check StatsD n’inclut aucun événement.

Checks de service

statsd.is_up :
Renvoie CRITICAL si le serveur StatsD ne répond à la requête de statut de santé de l’Agent. Si ce n’est pas le cas, renvoie OK.

statsd.can_connect :
Renvoie CRITICAL si l’Agent ne parvient pas à recueillir de métriques à propos de StatsD. Si ce n’est pas le cas, renvoie OK.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin

Si vous ne connaissez pas StatsD et que vous ne savez pas comment il fonctionne, consultez notre article de blog à ce sujet

Pour mieux comprendre comment (ou pourquoi) visualiser les métriques StatsD avec les graphiques de nombres sur Datadog, lisez notre série d’articles de blog à ce sujet.