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

# Dépannage OpenTelemetry

Lorsqu'aucune donnée n'est rapportée depuis votre application vers AppSignal, veuillez vérifier les problèmes courants ci-dessous.

## Aucune donnée n'est rapportée

### L'endpoint d'exportation OpenTelemetry est mal configuré

Les applications OpenTelemetry exportent par défaut les données vers `http://localhost:4318`.
AppSignal nécessite un endpoint personnalisé pour envoyer les données à l'AppSignal collector.

L'AppSignal collector peut s'exécuter en tant que type hébergé ou auto-hébergé. Consultez notre [page Hébergé ou auto-hébergé](/collector/hosted-vs-self-hosted) pour plus d'informations sur la différence entre ces types de collectors.

Suivez l'aide pour le type de collector utilisé par votre application ci-dessous :

* [Collector hébergé](#hosted-collector)
* [Collector auto-hébergé](#self-hosted-collector), installé en tant que [paquet Linux] et [image Docker]

#### Collector hébergé

Lors de l'utilisation du collector hébergé, veillez à utiliser l'URL du collector affichée dans l'[assistant d'ajout d'application](https://appsignal.com/redirect-to/organization?to=sites/new) comme endpoint de l'exportateur OpenTelemetry.

Dans l'assistant d'ajout d'application, sélectionnez le langage utilisé par votre application qu'AppSignal prend en charge pour OpenTelemetry, ou utilisez l'option « More languages », pour afficher l'endpoint du collector hébergé.
Il peut figurer dans un exemple de code, assigné à une variable nommée `endpoint`.

Le format du collector hébergé est le suivant :

* `https://COLLECTOR-ID.REGION.appsignal-collector.net`

L'endpoint de l'exportateur doit être configuré soit via la variable d'environnement `OTEL_EXPORTER_OTLP_ENDPOINT`, soit dans l'application elle-même, là où OpenTelemetry est configuré.
Consultez le [guide d'installation spécifique au langage][install guide] que votre application utilise pour plus de détails.

#### Collector auto-hébergé

Lors de l'utilisation d'un collector auto-hébergé, l'endpoint de l'exportateur OpenTelemetry doit pointer vers l'emplacement où le collector s'exécute.

Si le collector s'exécute sur le même hôte (installé à l'aide du [paquet Linux]), le nom d'hôte est `localhost`.

Si le collector s'exécute dans un [conteneur Docker][image Docker] ou un cluster Kubernetes, le nom d'hôte peut différer en fonction du nom de service spécifié.
Nous recommandons de nommer le service `appsignal` et de mettre à jour l'endpoint de l'exportateur pour qu'il corresponde au nom d'hôte `appsignal`.

* Nom d'hôte, plusieurs valeurs sont possibles :
  * [Paquet Linux]: `localhost:8099`
  * [Image Docker]: `appsignal:8099`
* Exemples :
  * `http://localhost:8099`, ou `http://appsignal:8099` sur Docker.

Pour certains langages, dans le SDK OpenTelemetry, le schéma URI (`http`/`https`) ne doit pas être défini dans l'endpoint de l'exportateur OpenTelemetry. Veuillez vous référer au [guide d'installation](/opentelemetry/installation) pour le langage utilisé par votre application.

L'endpoint de l'exportateur doit être configuré soit via la variable d'environnement `OTEL_EXPORTER_OTLP_ENDPOINT`, soit dans l'application elle-même, là où OpenTelemetry est configuré.
Consultez le [guide d'installation spécifique au langage][install guide] que votre application utilise pour plus de détails.

#### Endpoints de l'exportateur

Certains exportateurs OpenTelemetry peuvent devoir être configurés par type de données OpenTelemetry vers des endpoints spécifiques.

Lorsque vous configurez un exportateur de trace/span, utilisez l'endpoint trace, pour les métriques, utilisez l'endpoint metrics, etc.

Ces endpoints sur l'AppSignal collector sont :

* Données de trace :
  * `/v1/traces` ou,
  * `/v1/traces`
* Données métriques :
  * `/v1/metrics` ou,
  * `/v1/metrics`
* Données de log :
  * `/v1/logs` ou,
  * `/v1/logs`

### Le protocole d'export OpenTelemetry n'est pas défini sur http/protobuf

L'AppSignal collector ne prend en charge que le protocole OpenTelemetry (OTLP) sur HTTP avec encodage Protobuf.

Configuration requise :

* Format de protocole : `http/protobuf`

Si OpenTelemetry dans votre application utilise gRPC ou JSON comme format d'exportation, mettez à jour la configuration pour utiliser le format HTTP/protobuf.

Pour configurer le format de protocole de l'exportateur, suivez [les étapes d'installation](/opentelemetry/installation) pour le langage utilisé par votre application.

### Le collector auto-hébergé n'est pas en cours d'exécution ou est injoignable

Pour envoyer des données à AppSignal, le collector auto-hébergé doit avoir démarré correctement.
Des erreurs d'exportation visibles dans les journaux de l'application peuvent indiquer que le collector n'est pas en cours d'exécution.
Pour vérifier s'il est en cours d'exécution, consultez les journaux du collector.

Les journaux du collector se trouvent dans :

* Les journaux du conteneur pour la [méthode d'installation par conteneur Docker](/collector/installation/docker-image).
  Vérifiez votre gestionnaire de conteneurs pour la meilleure façon d'accéder aux journaux du conteneur.
* Les journaux système pour la [méthode d'installation par paquet Linux](/collector/installation/linux-package#debugging).

Si le collector est en cours d'exécution mais ne peut pas être joint, vérifiez les paramètres réseau internes pour voir si l'application est capable d'atteindre l'hôte du collector.

## Données rapportées manquantes ou incomplètes

Si vous ne voyez que certaines données et qu'il vous manque plus d'informations sur ce que fait votre application, cela est probablement dû à une instrumentation OpenTelemetry manquante dans votre application.

OpenTelemetry n'instrumente pas automatiquement tout dès le départ. Pour collecter des données depuis des frameworks et bibliothèques spécifiques, vous devrez installer et configurer des bibliothèques d'instrumentation supplémentaires.

Pour rapporter plus de données, installez les bibliothèques d'instrumentation OpenTelemetry appropriées pour les bibliothèques correspondantes utilisées dans votre application.

Reportez-vous au guide [ajouter une instrumentation OpenTelemetry supplémentaire](/guides/instrumentation/additional-opentelemetry-instrumentation) pour le langage de votre application sur la manière d'installer plus de paquets d'instrumentation.

[install guide]: /opentelemetry/installation.html

[Linux package]: /collector/installation/linux-package.html

[Docker image]: /collector/installation/docker-image.html

[paquet Linux]: /collector/installation/linux-package.html

[image Docker]: /collector/installation/docker-image.html

[Paquet Linux]: /collector/installation/linux-package.html

[Image Docker]: /collector/installation/docker-image.html
