Surveillance de statsd

Modifier en ligne

Grâce à l'Observability d' Instana, vous pouvez surveiller de manière exhaustive vos applications et services qui utilisent le protocole StatsD afin d'obtenir des informations détaillées sur leurs performances et leur état de santé.

Pour commencer, installez l 'agent hôte d' Instana, qui fait office de démon collecteur d' StatsD s et reçoit les métriques, ce qui évite d'avoir à déployer un autre démon d' StatsD. L'agent déploie le capteur « StatsD ». Une fois le capteur configuré comme indiqué dans la section « Configuration », vous pouvez consulter les métriques relatives à vos applications et services dans l'interface utilisateur d' Instana.

Informations de support

Modifier en ligne

Pour vous assurer que le capteur d' StatsD s est compatible avec votre configuration actuelle, consultez les sections d'informations d'assistance suivantes :

Systèmes d'exploitation pris en charge

Modifier en ligne

Les systèmes d'exploitation pris en charge du détecteur StatsD sont compatibles avec les exigences de l'agent hôte. Pour plus d'informations, consultez la section « Systèmes d'exploitation pris en charge » dans la rubrique « Installation des agents hôtes ».

Versions prises en charge et politique d'assistance

Modifier en ligne

Le tableau suivant présente la dernière version prise en charge et la politique d'assistance :

Technologie Politique de support Dernière version technologique Dernière version prise en charge
StatsD 45 jours 0.10.2 0.10.2

Pour plus d'informations sur la politique d'assistance, consultez la section « Stratégie d'assistance pour les capteurs ».

Configuration du capteur d' StatsD

Modifier en ligne

Par défaut, le capteur statsd est désactivé. Pour activer le capteur, modifiez le fichier de <agent_install_dir>/etc/instana/configuration.yaml configuration de l'agent comme indiqué dans l'exemple suivant :

com.instana.plugin.statsd:
  enabled: true
  ports:
    udp: 8125
    mgmt: 8126
  bind-ip: "0.0.0.0" # all IPs by default
  flush-interval: 10 # in seconds

Pour surveiller un ensemble de mesures à l'aide d'une expression régulière, configurez le capteur StatsD à l'aide de la configuration suivante :

com.instana.plugin.statsd:
  metricsRegex: '<OPTIONAL_REGEX_HERE>'
Remarque : n'exécutez pas le service statsd standard, car cela empêche l'agent d'écouter sur ces ports. N'exécutez que l'agent, qui fait office de statsd serveur.

Avant de commencer

Modifier en ligne

Vérifiez si le port UDP est accessible au capteur Instana StatsD en suivant les étapes suivantes :

  1. Désactivez le détecteur StatsD .
  2. Exécutez la commande suivante sur l'hôte sur lequel est installé l'agent « Instana » avec le capteur « StatsD » activé :
    nc -l -u 8125
  3. A partir de tout autre ordinateur, envoyez une commande, telle que:
    echo -n "custom.metric.name-test:1|c" | 34.135.37.172 8125
  4. Vérifiez la sortie du programme d'écoute qui s'exécute sur le port 8125. Le résultat s'affiche sur la console de l'hôte sur lequel l'agent d' Instana s est installé.

Si la métrique est affichée dans la sortie du programme d'écoute, la connexion à StatsD est établie. Sinon, cela signifie que le port UDP n'est pas ouvert sur l'hôte.

Affichage des mesures

Modifier en ligne

Lorsque le protocole standard StatsD d'une bibliothèque cliente est utilisé pour envoyer des données à l'agent Instana via le capteur StatsD, le tableau de bord de l'hôte affiche jusqu'à 3 000 métriques personnalisées. L'agent reçoit les données métriques sur l'hôte.

Le capteur StatsD peut collecter un maximum de 1000 mesures pour chaque type de mesure : compteurs, jauges et minuteries.

Pour afficher les métriques, procédez comme suit:

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur un hôte surveillé.

Vous pouvez voir un tableau de bord hôte avec toutes les métriques collectées. Les données de mesure sont envoyées au port UDP configuré, au format StatsD, via UDP. Pour plus d'informations sur ce format, consultez la page « Types de mesures » sur StatsD.

Le détecteur accepte les métriques envoyées dans les formats StatsD suivants:

  • metric name:value:

    Par exemple, le script suivant augmente d'une unité un compteur appelé hits :

    echo "hits:1|c" | nc -u -w0 127.0.0.1 8125

  • \n comme séparateur pour envoyer plusieurs métriques via UDP vers le port UDP configuré :

    echo "hits:1|c\nlatency:320|ms\nvisits:333|g\nresponse time:765|s" | nc -u -w0 127.0.0.1 8125

  • # Etiquettes :

    echo "host.network_receive_errs_total:10|c|#collector:network,device:utun2,host:testmachine" | nc -u -w0 127.0.0.1 8125