- Une intégration AppSignal : installez un seul package. Il instrumente votre application et inclut son propre agent, ou envoie ses données via le collector.
- Un SDK OpenTelemetry : instrumentez vous-même votre application, et envoyez les données via l’AppSignal collector.
Langages et frameworks
Ruby
Intégration AppSignal. Instrumente Rails, Sinatra, Sidekiq et d’autres bibliothèques Ruby sans modification du code.
Elixir
Intégration AppSignal. Instrumente Phoenix, Ecto, Oban et d’autres bibliothèques Elixir sans modification du code.
Node.js
Intégration AppSignal, basée sur OpenTelemetry. Instrumente Express, Fastify, NestJS, Prisma et d’autres packages.
Python
Intégration AppSignal, basée sur OpenTelemetry. Surveille Django, Flask, Celery et d’autres applications Python.
PHP
Intégration AppSignal, basée sur OpenTelemetry. Instrumente Laravel et Symfony, et envoie les données via l’AppSignal collector.
Go
SDK OpenTelemetry. Envoie les données via l’AppSignal collector.
Java
SDK OpenTelemetry. Envoie les données via l’AppSignal collector.
JavaScript (navigateur)
Suivez les erreurs front-end et mesurez les Core Web Vitals d’utilisateurs réels. Les breadcrumbs et les vitals ne demandent aucune configuration.
JavaScript
Suivez les erreurs dans les applications JavaScript front-end, avec des plugins pour les breadcrumbs et des intégrations de frameworks.
Autres langages
Utilisez le SDK OpenTelemetry de votre langage, et envoyez les données via l’AppSignal collector.
Comment les données parviennent à AppSignal
Les données back-end empruntent l’une de ces trois voies :- Une intégration AppSignal avec son agent : Ruby, Elixir, Node.js et Python. Le package démarre l’agent AppSignal, un processus distinct sur le même hôte. L’agent agrège vos données avant de les envoyer, et lit les métriques d’hôte. Lorsque AppSignal est injoignable, il stocke les payloads sur disque et réessaie.
- Une intégration AppSignal via le collector : PHP envoie toujours ses données de cette façon. Ruby (gem 5.0) et Python (1.8) peuvent basculer vers cette voie, nécessaire au tracing distribué. Vous conservez l’instrumentation de l’intégration, et les données transitent au format OpenTelemetry.
- Un SDK OpenTelemetry via le collector : Go, Java et tout autre langage. Vous ajoutez le SDK et ses packages d’instrumentation, et le collector prépare les données.
Choisir une voie
- Si votre langage dispose d’une intégration AppSignal, installez-la.
- Si vous utilisez Ruby ou Python et avez besoin du tracing distribué, passez l’intégration en mode collector. Le tracing distribué suit une requête à travers vos services, et affiche chaque trace sous forme de carte des services et de chronologie.
- Si vous utilisez Go, Java ou un autre langage, utilisez le SDK OpenTelemetry avec le collector.
- Si vous instrumentez déjà avec OpenTelemetry, conservez cette instrumentation et faites pointer le SDK vers le collector.
Ce que font l’agent et le collector
Quelle que soit la voie, un agent ou le collector prépare vos données avant qu’elles n’atteignent AppSignal. Les intégrations apportent des fonctionnalités supplémentaires.L’AppSignal collector
L’AppSignal collector reçoit les données de n’importe quel SDK OpenTelemetry. Avant d’envoyer vos données à AppSignal, le collector :- Regroupe les spans en traces, et nomme chaque trace selon son namespace et son action. Express, NestJS, Next.js, Django, Flask, Celery et Sidekiq reçoivent des noms propres à chaque framework.
- Calcule les métriques de throughput, de durée et d’erreurs à partir de chaque trace.
- Supprime les valeurs des requêtes SQL et des commandes Redis.
- Filtre les paramètres de requête, les en-têtes et les données de session, et écarte les erreurs, actions et namespaces que vous choisissez d’ignorer.
- Relie chaque ligne de log à la trace dont elle provient.
- Accepte les métriques OpenTelemetry, que votre SDK les envoie sous forme de valeurs cumulatives ou delta.
- Stocke les données sur disque lorsqu’il ne parvient pas à joindre AppSignal, et les envoie plus tard. Les données en file d’attente sont conservées jusqu’à une heure.
- Peut collecter les métriques d’hôte du serveur Linux sur lequel il s’exécute.
Intégrations AppSignal
Les intégrations se chargent de l’instrumentation pour vous, et collectent des données que les SDK OpenTelemetry ne collectent pas :- Instrumentent les frameworks et bibliothèques sans modification du code.
- Envoient chaque minute des métriques d’exécution, comme le garbage collection de Ruby, les files d’attente Sidekiq, la mémoire de la VM Erlang et la taille du heap Node.js. Ces métriques créent automatiquement des Intelligence dashboards.
- Envoient les métriques d’hôte par défaut, en Ruby, Elixir, Node.js et Python.
- Incluent des helpers pour ajouter des tags, signaler des erreurs, envoyer des métriques personnalisées et envoyer des logs.
- Incluent des outils en ligne de commande pour installer l’intégration, envoyer des données de test et vérifier votre configuration.
- Créent des deploy markers à partir de l’option
revision.
Outils de télémétrie
Des outils autonomes qui surveillent les processus et les hôtes, et collectent la télémétrie en dehors du code de votre application.Wrap
Surveillez n’importe quel processus exécuté sur vos serveurs, comme des tâches cron ou des serveurs de base de données.
Collector
Collectez et traitez les données OpenTelemetry avant de les envoyer à AppSignal.
Agent autonome
Collectez les métriques d’hôte et les données StatsD et NGINX depuis des serveurs qui n’exécutent pas votre application.