Passer au contenu principal
L’agent autonome AppSignal exécute par défaut un serveur StatsD sur UDP sur localhost au port 8125. Vous pouvez l’utiliser pour ingérer des métriques d’autres composants de votre infrastructure. Toutes les métriques ajoutées peuvent être utilisées en tant que métriques personnalisées au sein d’AppSignal.
Si vous exécutez plusieurs applications instrumentées avec AppSignal en même temps sur le même serveur, l’option de configuration enable_statsd doit être désactivée pour toutes sauf une, ou l’option de configuration statsd_port doit être utilisée pour exposer chaque serveur StatsD sur un port différent.

Métriques prises en charge

Les métriques StatsD suivantes sont actuellement prises en charge :
  • gauge
  • counter
  • timers
Les autres types de métriques non pris en charge seront ignorés.

Étiquetage

Le serveur StatsD prend en charge l’extension DogStatsD, ce qui signifie que les tags pour les métriques sont pris en charge.

Exemple

L’exemple suivant en Ruby montre comment cela fonctionne en utilisant la gem statsd-instrument.
require 'statsd-instrument'

StatsD.backend = StatsD::Instrument::Backends::UDPBackend.new("localhost:8125", :datadog)

# Gauge
StatsD.gauge 'gauge', 2.0
StatsD.gauge 'gauge_with_tags', 3.0, tags: ['hostname:frontend1'], sample_rate: 0.9

# Counter
10.times do
  StatsD.increment 'counter'
  StatsD.increment 'counter_with_key_value_tags', tags: ['hostname:frontend1']
  StatsD.increment 'counter_with_only_key_tags', tags: ['important']
end

# Timing
10.times do
  StatsD.measure 'timing', 2.55
  StatsD.measure 'timing_with_tags', 3.55, tags: ['hostname:frontend1']
end
Ceci n’est qu’une démonstration ; il est bien plus utile d’utiliser cela depuis d’autres langages qui ne sont pas directement pris en charge par AppSignal. Vous pourriez l’utiliser pour collecter des métriques d’une application PHP ou .NET, par exemple. De nombreux outils sont disponibles pour extraire des métriques StatsD de la JVM, de diverses bases de données ou de serveurs web. Nous sommes curieux de voir les cas d’utilisation que vous trouvez, faites-le-nous savoir !