Dépannage de la distribution de l' Instana Collector d' OpenTelemetry
Consultez les solutions aux problèmes courants que vous pourriez rencontrer lors de l'utilisation de la distribution Instana de OpenTelemetry Collector.
Le collecteur ne parvient pas à se connecter
Le collecteur ne parvient pas à se connecter au backend d' Instana.
Solution : vérifiez votre configuration réseau et assurez-vous que le collecteur peut atteindre le backend Instana. Vérifiez les règles du pare-feu, les paramètres du proxy et les configurations des ports, puis assurez-vous que la clé d' Instana ation correcte est utilisée.
Le collecteur ne parvient pas à se connecter à la plateforme Red Hat OpenShift avec l'édition personnalisée auto-hébergée d' Instana
Si vous utilisez la plateforme Red Hat OpenShift avec l'édition personnalisée auto-hébergée d' Instana et que vous rencontrez des erreurs de connexion ou des défaillances du point de terminaison OTLP (comme indiqué dans les journaux du pod otlp-collector), vous devez créer manuellement les routes sur Red Hat OpenShift. Pour plus d'informations sur la création d'itinéraires, consultez la section Configuration des points de terminaison sur le backend Instana sur Red Hat OpenShift. La création d'itinéraires ne se fait pas automatiquement.
Le collecteur ne démarre pas
Le collecteur ne démarre pas en raison d'erreurs de configuration.
Solution : validez votre fichier de configuration à l'aide du --config-check drapeau avant de démarrer le collecteur. Exemple :./otelcol --config config.yaml --config-check
Le service Collector ne démarre pas
Le service Collector ne démarre pas après l'installation.
Solution : vérifiez les journaux de service pour détecter les erreurs et vérifiez que les paramètres de configuration dans config.env sont corrects.
Le collecteur n'apparaît pas dans l'interface utilisateur d' Instana
Le collecteur fonctionne, mais n'apparaît pas dans l'interface utilisateur d' Instana.
Solution : la page des entités de l'interface utilisateur Instana répertorie les composants en fonction de l'attribut entity.type resource. Si votre collecteur n'est pas visible, vérifiez que entity.type l'attribut est correctement configuré dans votre fichier de configuration. Assurez-vous que le collecteur est correctement connecté au backend de l' Instana et vérifiez qu'il n'y a pas de problèmes d'authentification ou de connectivité.
Exemple de configuration des attributs de ressource :
telemetry:
resource:
entity.type: otel-collector
Problèmes liés au service de supervision
- Le collecteur redémarre à plusieurs reprises malgré l'exécution du service de supervision.
Solution : vérifiez les journaux du superviseur pour détecter les erreurs et vérifiez que la configuration du collecteur est valide.
- Le service de supervision ne démarre pas.
Solution : vérifiez que la configuration du superviseur dans config.env est correcte et consultez les journaux système pour détecter d'éventuelles erreurs.
Emplacements des journaux pour l' Linux
Journaux du collecteur : par défaut, /opt/instana/collector/logs/collector.log.
Journaux du superviseur : Par défaut, /opt/instana/collector/logs/supervisor.log.
Le collecteur ne peut pas accéder aux métriques système ni aux fichiers journaux
Le collecteur ne peut pas accéder aux métriques système ni aux fichiers journaux.
Solution : assurez-vous que le processus de collecte dispose des autorisations appropriées. Vous devrez peut-être l'exécuter avec des privilèges élevés ou l'ajouter à des groupes spécifiques.
Comportement étrange du collecteur
Les journaux du collecteur affichent des données télémétriques anormales.
Solution : redémarrez le service Collector à l'aide de ./instana_collector_service.sh restart dans votre chemin d'installation afin d'éliminer tout problème potentiel. Si le problème persiste, vérifiez les journaux du collecteur pour détecter toute anomalie.
Problèmes liés aux certificats auto-signés dans les environnements auto-hébergés
Le collecteur ne peut pas se connecter au backend Instana en raison d'échecs de validation des certificats dans les environnements auto-hébergés avec des certificats auto-signés.
Solution : exportez le certificat depuis votre serveur Instana et ajoutez-le au magasin de certificats approuvés de votre système :
- Exportez le fichier PEM depuis le serveur Instana.
- Convertissez le fichier en fichier
.crtsi nécessaire. - Ajoutez le certificat au magasin de certificats approuvés de votre système. Copiez votre
.crtfichier aux emplacements suivants en fonction de votre système d'exploitation :- RHEL, CentOS, ou Fedora : Copiez le
.crtfichier à/usr/share/pki/ca-trust-source/anchors/l'emplacement. - Debian ou Ubuntu : Copiez le
.crtfichier à/usr/local/share/ca-certificates/l'emplacement.
- RHEL, CentOS, ou Fedora : Copiez le
- Redémarrez le service Collector.
Problèmes liés au statut Span : HTTP 4xx codes de statut marqués comme erreurs
Problème : les spans avec les codes d'état HTTP 4xx (par exemple, 400 Bad Request) sont marqués comme des erreurs, mais il s'agit d'un comportement attendu dans votre application.
Solution : la spécification OpenTelemetry permet aux instrumentations de définir plus précisément le statut de la portée en fonction du contexte. Si vous souhaitez filtrer les réponses spécifiques de l' 4xx qui ne constituent pas de véritables erreurs dans votre cas d'utilisation, configurez le transform bloc processeur dans la configuration de votre collecteur afin qu'il contienne les paramètres suivants, puis ajoutez-le au pipeline.
transform/span_parse:
error_mode: ignore
trace_statements:
- context: span
statements:
- set(status.code, STATUS_CODE_OK) where attributes["http.status_code"] >= 400 and attributes["http.status_code"] < 500Avec cette configuration, vous pouvez définir le statut de la portée sur OK pour des codes de statut d' HTTP s spécifiques.