Gnatsd

Gnatsd

Agent Check Check de l'Agent

Linux Mac OS Windows OS Supported

Présentation

Recueillez des métriques du service Gnatsd en temps réel pour :

  • Visualiser et surveiller les états de Gnatsd
  • Être informé des failovers et des événements de Gnatsd

Configuration

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 Gnatsd 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 et lancez 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-gnatsd==<INTEGRATION_VERSION>
    
  3. Configurez votre intégration comme n’importe quelle autre intégration fournie avec l’Agent.

Configuration

  1. Modifiez le fichier gnatsd.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos métriques Gnatsd. Consultez le fichier d’exemple gnatsd.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 gnatsd dans la section Checks.

Compatibilité

Le check gnatsd est compatible avec toutes les principales plates-formes.

Données collectées

Métriques

gnatsd.connz.connections.in_bytes
(count)
The number of bytes incoming
Shown as byte
gnatsd.connz.connections.in_msgs
(count)
The number of messages received
Shown as unit
gnatsd.connz.connections.out_bytes
(count)
The number of bytes outgoing
Shown as byte
gnatsd.connz.connections.out_msgs
(count)
The number of messages sent
Shown as unit
gnatsd.connz.connections.pending_bytes
(gauge)
The number of bytes pending ack on a subscription
Shown as unit
gnatsd.connz.connections.subscriptions
(gauge)
The number of subscriptions on a connection
Shown as unit
gnatsd.connz.num_connections
(gauge)
The number of current connections to the NATS broker
Shown as unit
gnatsd.connz.total
(count)
The number of connections ever to the NATS broker
Shown as unit
gnatsd.routez.num_routes
(gauge)
The number of routes in the cluster
Shown as unit
gnatsd.routez.routes.in_bytes
(count)
The number of bytes incoming
Shown as byte
gnatsd.routez.routes.in_msgs
(count)
The number of messages received
Shown as unit
gnatsd.routez.routes.out_bytes
(count)
The number of bytes outgoing
Shown as byte
gnatsd.routez.routes.out_msgs
(count)
The number of messages sent
Shown as unit
gnatsd.routez.routes.pending_bytes
(gauge)
The number of bytes pending
Shown as unit
gnatsd.routez.routes.subscriptions
(gauge)
The number of subscriptions on a connection
Shown as unit
gnatsd.varz.connections
(gauge)
The number of connections to the NATS broker
Shown as unit
gnatsd.varz.in_bytes
(count)
Amount of traffic sent into the cluster
Shown as byte
gnatsd.varz.in_msgs
(count)
The number of messages passed into the cluster
Shown as unit
gnatsd.varz.mem
(gauge)
Amount of memory currently used by the process
Shown as byte
gnatsd.varz.out_bytes
(count)
Amount of traffic sent from the cluster
Shown as byte
gnatsd.varz.out_msg
(count)
The number of messages sent out of the cluster
Shown as unit
gnatsd.varz.remotes
(gauge)
The number of currently connected remotes
Shown as unit
gnatsd.varz.routes
(gauge)
The number of current routes
Shown as unit
gnatsd.varz.slow_consumers
(count)
The number of slow consumers ever connected
Shown as unit
gnatsd.varz.subscriptions
(gauge)
The number of subscriptions currently handled
Shown as unit

Remarque : si vous utilisez des noms de cluster Nats personnalisés, vos métriques présentent le format suivant : gnatsd.connz.connections.nom_cluster.in_msgs

Événements

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

Checks de service

Ce check gnatsd applique les tags suivants à l’ensemble des checks de service recueillis ;

  • server_name:<nom_serveur_en_yaml>
  • url:<host_en_yaml>

gnatsd.can_connect : Renvoie CRITICAL si l’Agent ne reçoit pas de réponse 200 depuis l’endpoint de surveillance. Si ce n’est pas le cas, renvoie OK.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.