Gnatsd
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Gnatsd

Agent Check Check de l'Agent

Supported OS: Linux Mac OS Windows

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 :

  1. Installez le kit de développement.
  2. Clonez le dépôt integrations-extras :

    git clone https://github.com/DataDog/integrations-extras.git.
  3. Mettez à jour votre configuration ddev avec le chemin integrations-extras/ :

    ddev config set extras ./integrations-extras
  4. Pour générer le paquet gnatsd, exécutez :

    ddev -e release build gnatsd
  5. Téléchargez et lancez l’Agent Datadog.

  6. 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
  7. Configurez votre intégration comme n’importe quelle autre intégration du paquet.

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.