Puma

Puma

Agent Check Check de l'Agent

Supported OS Linux Mac OS Windows

Présentation

Ce check permet de surveiller Puma avec l’Agent Datadog. Il utilise l’endpoint de métriques Puma fourni par le serveur Control/Status.

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 à un environnement conteneurisé.

Installation

Si vous utilisez la version 6.8 ou une version ultérieure de l’Agent, suivez les instructions ci-dessous pour installer le check Puma sur votre host. Consultez le guide relatif à l'installation d’intégrations développées par la communauté pour installer des checks avec une version < 6.8 de l’Agent ou avec l'Agent Docker :

  1. Téléchargez l’Agent Datadog.

  2. Exécutez la commande suivante pour installer le wheel de l’intégration à l’aide de l’Agent :

       datadog-agent integration install -t datadog-puma==<INTEGRATION_VERSION>
    
  3. Configurez votre intégration comme n’importe quelle autre intégration du paquet.

Configuration

  1. Modifiez le fichier puma.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 Puma. Consultez le fichier d’exemple puma.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

  2. Redémarrez l’Agent.

Validation

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

Données collectées

Métriques

puma.backlog
(gauge)
Pending request backlog
Shown as unit
puma.booted_workers
(gauge)
Number of booted puma workers
Shown as unit
puma.max_threads
(gauge)
Maximum threads
Shown as unit
puma.pool_capacity
(gauge)
Pool capacity
Shown as unit
puma.requests_count
(gauge)
Request count
Shown as unit
puma.running
(gauge)
Running threads
Shown as unit
puma.workers
(gauge)
Total number of puma workers
Shown as unit

Checks de service

puma.connection : renvoie CRITICAL si l’Agent ne parvient pas à se connecter à l’instance Puma qu’il surveille. Si ce n’est pas le cas, renvoie OK.

Événements

Puma n’inclut aucun événement.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.