Gearman

Supported OS Linux Mac OS

Integrationv2.3.0

Présentation

Recueillez des métriques de Gearman pour :

  • Visualiser les performances de Gearman
  • Savoir le nombre de tâches en attente ou en exécution
  • Corréler les performances de Gearman avec le reste de vos applications

Configuration

Installation

Le check Gearman est inclus avec le paquet de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur vos serveurs de jobs Gearman.

Configuration

Host

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

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

    init_config:
    
    instances:
      - server: localhost
        port: 4730
    
  2. 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é.

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

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

    logs:
      - type: file
        path: /var/log/gearmand.log
        source: gearman
    

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

  3. Redémarrez l’Agent.

Consultez la section Collecte de logs Kubernetes pour découvrir comment configurer l’Agent afin de recueillir des logs dans des environnements Kubernetes.

Validation

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

Données collectées

Métriques

gearman.unique_tasks
(gauge)
The number of all functions registered with Gearman.
Shown as task
gearman.running
(gauge)
The total number of running Gearman jobs.
Shown as task
gearman.queued
(gauge)
The total number of jobs in the queue.
Shown as task
gearman.workers
(gauge)
The total number of capable Gearman workers.
Shown as process
gearman.running_by_task
(gauge)
The number of running Gearman jobs by task.
Shown as task
gearman.queued_by_task
(gauge)
The number of jobs in the queue by task.
Shown as task
gearman.workers_by_task
(gauge)
The number of capable Gearman workers by task.
Shown as process

Événements

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

Checks de service

gearman.can_connect
Renvoie CRITICAL si le check de l’Agent n’est pas capable de se connecter à l’instance Gearman qu’il surveille. Si ce n’est pas le cas, renvoie OK.
Statuses: ok, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.