Gnatsd

Check de l'Agent

Supported OS:

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

Implémentation

Installation

Si vous utilisez la version 6.8 ou ultérieure de l’Agent, suivez les instructions ci-dessous pour installer le check Gnatsd sur votre host. Consultez notre 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 :

Installez le kit de développement.

Clonez le dépôt integrations-extras :

git clone https://github.com/DataDog/integrations-extras.git.

Mettez à jour votre configuration ddev avec le chemin integrations-extras/ :
```
ddev config set extras ./integrations-extras
```
Pour générer le paquet gnatsd, exécutez :
```
ddev -e release build gnatsd
```
Téléchargez et lancez l’Agent Datadog.
Exécutez la commande suivante pour installer le wheel de l’intégration à l’aide de l’Agent :
```
datadog-agent integration install -w <PATH_OF_GNATSD_ARTIFACT_>/<GNATSD_ARTIFACT_NAME>.whl
```
Configurez votre intégration comme n’importe quelle autre intégration du paquet.

Configuration

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