> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ajouter une instrumentation OpenTelemetry supplémentaire

OpenTelemetry fournit une instrumentation étendue pour de nombreuses bibliothèques et frameworks populaires. Lors de l'installation d'AppSignal et d'OpenTelemetry, vous avez peut-être déjà installé certains packages d'instrumentation, mais il se peut que vous deviez ajouter des packages d'instrumentation supplémentaires pour surveiller des bibliothèques spécifiques utilisées par votre application.

Ce guide explique comment identifier, installer et configurer des packages d'instrumentation OpenTelemetry supplémentaires pour une meilleure couverture d'observabilité.

## 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

Ajouter une instrumentation pour ces bibliothèques fournit une configuration de surveillance plus complète pour tous les composants de votre application.

## É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](#language-specific-instructions) 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 :

1. **Packages OpenTelemetry officiels** — maintenus par la communauté OpenTelemetry
2. **Packages OpenTelemetry contrib** — instrumentation contribuée par la communauté
3. **Packages tiers** — assurez-vous de faire confiance au mainteneur et examinez le code

Consultez le [registre OpenTelemetry](https://opentelemetry.io/ecosystem/registry/) pour les packages d'instrumentation disponibles.

Notez que certaines bibliothèques peuvent inclure leur propre instrumentation OpenTelemetry et qu'aucune configuration supplémentaire n'est nécessaire.

### 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 :

<CodeGroup>
  ```sh Go theme={null}
  go get go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp
  ```

  ```sh PHP theme={null}
  composer require open-telemetry/opentelemetry-auto-guzzle
  ```
</CodeGroup>

### 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

Pour certains langages, comme PHP et Java utilisant des auto-instrumentations, cette étape n'est pas nécessaire. L'instrumentation sera automatiquement configurée, sauf indication contraire.

### 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 :

* [Instrumentations Go](/go/instrumentations)
* [Instrumentations Java](/java/instrumentations)
* [Instrumentations PHP](/php/instrumentations)

## 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 :

1. Consultez la documentation du package d'instrumentation
2. Contactez [l'assistance AppSignal](mailto:support@appsignal.com) pour obtenir de l'aide