Pourquoi ajouter une instrumentation supplémentaire ?
Votre application peut utiliser des bibliothèques qui ne sont pas couvertes par les packages d’instrumentation que vous avez installés lors de la configuration, telles que :- Pilotes de base de données
- Bibliothèques client HTTP
- Systèmes de file d’attente de messages
- Bibliothèques personnalisées ou de niche
Étapes générales
Cette section décrit les étapes nécessaires pour la plupart des langages afin d’instrumenter une bibliothèque supplémentaire. Consultez la section Instructions spécifiques au langage pour les étapes spécifiques à chaque langage.1. Identifier les bibliothèques à instrumenter
Tout d’abord, déterminez quelles bibliothèques votre application utilise et que vous souhaitez surveiller. Les candidats courants incluent :- Clients de base de données (MySQL, PostgreSQL, MongoDB, Redis)
- Clients HTTP
- Files d’attente de messages (RabbitMQ, Kafka, SQS)
- Moteurs de templates
2. Trouver des packages d’instrumentation
Recherchez les packages d’instrumentation dans cet ordre de préférence :- Packages OpenTelemetry officiels — maintenus par la communauté OpenTelemetry
- Packages OpenTelemetry contrib — instrumentation contribuée par la communauté
- Packages tiers — assurez-vous de faire confiance au mainteneur et examinez le code
3. Installer le package
Une fois que vous avez trouvé un package d’instrumentation pertinent, installez-le à l’aide du gestionnaire de packages de votre langage. Par exemple :4. Initialiser l’instrumentation
Selon le langage et la méthode d’instrumentation du SDK, les packages d’instrumentation peuvent nécessiter une initialisation dans le code de démarrage de votre application. Cela implique généralement :- D’importer le package d’instrumentation
- D’appeler une fonction d’initialisation
- De configurer toute option spécifique au package
5. Vérifier les données entrantes
Après l’installation, vérifiez que l’instrumentation fonctionne :- Vérifiez que de nouveaux spans concernant la bibliothèque instrumentée apparaissent dans vos traces rapportées à AppSignal.com.
- Confirmez que les métriques concernant la bibliothèque instrumentée sont rapportées à AppSignal.com.
- Testez des scénarios d’erreur pour vous assurer que les erreurs sont rapportées.
Instructions spécifiques au langage
Pour des instructions détaillées sur l’ajout de packages d’instrumentation pour des langages spécifiques :Dépannage
Problèmes courants
- Traces manquantes : assurez-vous que l’instrumentation est initialisée avant que la bibliothèque ne soit utilisée.
- Données incomplètes : vérifiez si le package d’instrumentation prend en charge la version de votre bibliothèque.
- Spans dupliqués : évitez d’instrumenter la même bibliothèque plusieurs fois.
Obtenir de l’aide
Si vous rencontrez des problèmes :- Consultez la documentation du package d’instrumentation
- Contactez l’assistance AppSignal pour obtenir de l’aide