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
Le check Gnatsd n’est pas inclus avec le package de l’Agent Datadog : vous devez donc l’installer.
Installation
Pour l’Agent v7.21+/6.21+, suivez les instructions ci-dessous afin d’installer le check Gnatsd sur votre host. Consultez la section Utiliser les intégrations de la communauté pour effectuer une installation avec l’Agent Docker ou avec des versions antérieures de l’Agent.
Exécutez la commande suivante pour installer l’intégration de l’Agent :
datadog-agent integration install -t datadog-gnatsd==<INTEGRATION_VERSION>
Configurez votre intégration comme une intégration de base.
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 |
Note: If you use custom Nats cluster names, your metrics may look like this:
gnatsd.connz.connections.cluster_name.in_msgs
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
gnatsd.can_connect
Returns CRITICAL if the Agent can’t connect to the Gnastd endpoint, OK otherwise
Statuses: ok, critical
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
