StatsD

Supported OS Linux Mac OS Windows

Intégration1.10.0

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.can_connect
Returns Critical if the Agent cannot send data to the StatsD endpoint, OK otherwise.
Statuses: ok, critical

statsd.is_up
Returns Critical if the Agent cannot connect to the StatsD url, OK otherwise.
Statuses: ok, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles :