Surveillance du proxy Envoy
Instana peut vous aider à collecter à la fois les métriques d'infrastructure provenant des instances du proxy d' Envoy, ainsi que les traces distribuées des requêtes qui les traversent.
Une fois l'agent hôte d' Instana s installé, le capteur de proxy d' Envoy est automatiquement installé et configuré. Vous pouvez consulter les indicateurs liés au proxy d' Envoy s dans l'interface utilisateur d' Instana à l'aide d'un widget de tableau de bord personnalisé. Vous ne pouvez consulter ces indicateurs qu'après avoir configuré le capteur Proxy d' Envoy, comme indiqué dans la section « Configuration de la surveillance du Proxy d' Envoy ».
Pour les versions d' Envoy antérieures à 1.30, vous pouvez utiliser la fonctionnalité de traçage distribué d' Instana. Pour utiliser la fonctionnalité de traçage distribué, vous devez suivre les étapes de configuration décrites dans la section « Configuration du traçage distribué » de la section « Proxy d' Envoy ».
Si vous utilisez Envoy 1.30 ou une version ultérieure, vous devez utiliser la fonctionnalité de traçage de EnvoyOTel et la configurer pour qu'elle se connecte au backend Instana. Pour plus d'informations, consultez la section « Configuration de l'ingestion de données d' OpenTelemetry ».
Pour vous aider à configurer Envoy OTel, consultez le dépôt de démonstration sur Envoy Proxy Instana OTel Tracing Demo. Ces instructions s'appliquent uniquement aux déploiements autonomes d' Envoy. Configurez les instances d' Envoy s gérées par Istio à l'aide de l'assistance Istio OpenTelemetry.
Informations complémentaires
Systèmes d'exploitation pris en charge
Pour le capteur proxy d' Envoy, les systèmes d'exploitation pris en charge correspondent aux exigences des agents hôtes; vous pouvez les consulter dans la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, par exemple « Systèmes d'exploitation pris en charge pour Linux ».
Pour le traçage des proxys d' Envoy, les systèmes d'exploitation suivants sont pris en charge :
| Système d'exploitation | Architecture | Nombre de bits |
|---|---|---|
| Debian : 12, 11 | x86_64 | 64 bits |
| Ubuntu : LTS 24.04, 22.04 | x86_64 | 64 bits |
La prise en charge de la fonction ` Ubuntu ` ( 20.04 ) n'est plus disponible dans la version 1.12.0 et les versions ultérieures du capteur CPP.
La prise en charge d'Amazon (2, 2022 et 2023), d' CentOS 7, d' Ubuntu d' 18.04 et d' Debian 10 n'est plus assurée dans CPP Sensor 1.11.0 et les versions ultérieures.
Versions et plateformes prises en charge de Proxy d' Envoy
Envoy Le capteur de proxy et l' Envoy Le traçage de proxy ont des exigences différentes en matière de version et de plate-forme.
Envoy Proxy Sensor prend en charge les métriques et les données de configuration pour Envoy Proxy 1.14.1 et les versions ultérieures, avec les distributions Linux fonctionnant sur l'architecture x86_64.
Envoy Les indicateurs de proxy ne sont disponibles que dans les widgets de tableau de bord personnalisés.
Instana prend en charge le traçage distribué pour les versions suivantes d' Envoy Proxy et les systèmes d'exploitation suivants, avec une politique de prise en charge de 45 jours :
Versions OS Version ENVOY Tracer 1.1.12.x et 1.13.x Linux basé sur la Glibc, Linux Alpine(musl libc) seulement 1.3.0 >=1.15.x et <=11.21.1 Linux basées sur la glibc >= 1.5.0 1.1.21.2, 1.21.3 et 1.22.0 Linux basées sur la glibc >= 1.7.0 >=11.21.4 et <=11.21.6, >=11.22.0 et <=11.22.6, >=11.23.0 et <=11.23.3, 1.24.0 et 1.24.1 Linux basées sur la glibc >= 1.8.0 1.1.22.7, 1.22.8, 1.23.4, 1.23.5, 1.24.2, 1.24.3, 1.25.1, 1.25.2, >=11.26.0 et <=1.1.26.2 Linux basées sur la glibc >= 1.8.1 >=11.22.9 et <=11.22.11, >=11.23.5 et <=11.23.10, >=11.24.4 et <=11.24.8, >=11.25.3 et <=11.25.7, >=11.26.3 et <=11.26.6, 1.27.0, 1.28.0 Linux basées sur la glibc >= 1.8.2 1.1.23.11, 1.23.12, >=11.24.9 et <=11.24.12, >=11.25.8 et <=11.25.11, 1.27.1 Linux basées sur la glibc >= 1.8.3 1.26.7, 1.27.2, 1.27.3, 1.28.1, 1.29.0, 1.29.1 Linux basées sur la glibc >= 1.9.0 1.1.26.8, >=11.27.4 et <=11.27.7, >=11.28.2 et <=11.28.6, >=11.29.2 et <=11.29.8 Linux basées sur la glibc >= 1.9.1 >= 1.29.9 et <= 1.29.12 Linux basées sur la glibc >= 1.12.0 Remarques :
- En ce qui concerne le traçage distribué, les proxys Envoy 1.12 et 1.13 ne sont pris en charge que par le capteur de proxy Envoy 1.3.0. Envoy Le capteur de proxy 1.5.0 et les versions ultérieures prennent uniquement en charge Envoy. Le proxy 1.15 doit être remplacé par 1.29.x. Nous vous recommandons vivement de mettre à jour Envoy Proxy si vous utilisez encore ses anciennes versions, car aucune nouvelle fonctionnalité n'est développée pour les anciennes versions de Envoy Proxy.
- La prise en charge de la propagation des en-têtes de contexte de trace d' W3C est disponible sur Envoy Tracer 1.8.0.
Scénarios de traçabilité pris en charge et non pris en charge
Passez en revue les scénarios suivants afin de déterminer si votre déploiement d' Envoy. est pris en charge pour le traçage d' Instana.
Scénarios pris en charge
Instana prend en charge le traçage d' Envoy s dans les scénarios de déploiement suivants :
Déploiements autonomes d' Envoy : instances proxy d' Envoy déployées de manière indépendante (non gérées par Istio ou d'autres plans de contrôle de maillage de services).
- Pour les versions d' Envoy antérieures à 1.30, utilisez le traçage distribué natif d' Instana avec le binaire de traçage Instana.
- Pour l' Envoy 1.30 ou les versions ultérieures, la prise en charge du traçage est assurée par le projet CCNF OpenTelemetry Envoy Gateway. Vous devez utiliser la prise en charge du traçage Envoy OTel configurée pour se connecter au backend Instana. Pour plus d'informations, consultez la section « Configuration de l'ingestion des données d' OpenTelemetry ».
Déploiement direct sur des hôtes ou des machines virtuelles : instances d' Envoy s s'exécutant directement sur des hôtes ou des machines virtuelles d' Linux.
Envoy autonome en conteneurs : Envoy s'exécute dans des conteneurs (pods Docker ou Kubernetes ) en tant que proxy autonome, sans être géré par un plan de contrôle de maillage de services.
Scénarios non pris en charge
Les scénarios de déploiement d' Envoy. suivants ne sont pas pris en charge pour le traçage d' Instana :
Envoy déployées dans le cadre du service mesh d' Istio : Envoy Les instances de proxy déployées et gérées par Istio ne sont pas prises en charge pour le traçage natif d' Instana. Cela inclut :
- Envoy sidecars intégrés par Istio
- Istio passerelles d'accès
- Istio passerelles de sortie
- Toute instance d' Envoy gérée par le plan de contrôle d' Istio (istiod)
Envoy en tant que passerelle d' API s dans le cadre de services gérés : instances d' Envoy déployées dans le cadre de services gérés de passerelle d' API s, pour lesquelles vous n'avez pas de contrôle direct sur la configuration d' Envoy.
Configuration de la surveillance du proxy d' Envoy
Pour collecter les métriques d' Envoy, Instana utilise l'interface d'administration. Pour activer cette interface d'administration, configurez votre serveur proxy Envoy en utilisant une adresse d'interface d'administration conformément au document relatif à l'interface d'administration. Démarrez le serveur à l'aide de l'argument de ligne de commande -c <envoy-config-file-path>.yaml ou --config-path <envoy-config-file-path>.yaml . Par exemple, -c /etc/envoy/envoy.yaml. Les environnements conteneurisés et l'analyse de la configuration d' YAML s sont pris en charge depuis la version Envoy du capteur Proxy 1.1.0.
Configuration de la surveillance avec le capteur proxy d' Envoy 1.0.2 ou une version antérieure
Envoy Les versions 1.0.2 ou antérieures de Proxy Sensor nécessitent en outre l'argument --admin-address-path <path-to-file-envoy-can-write-to> de ligne de commande. Par exemple, --config-path /etc/envoy/envoy.yaml --admin-address-path /tmp/envoy-admin.address. Pour que la surveillance fonctionne, l'agent d' Instana et le proxy d' Envoy doivent s'exécuter dans le même espace de noms, et l'adresse IP de 127.0.0.1 l'administrateur doit être configurée. Il est recommandé de mettre à niveau le capteur proxy d' Envoy.
Affichage des mesures
Une fois que vous avez suivi les étapes de configuration décrites dans la section « Configuration de la surveillance du proxy d' Envoy », vous pouvez consulter les métriques relatives au proxy d' Envoy dans l'interface utilisateur d' Instana.
Pour afficher les métriques, procédez comme suit:
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
- Cliquez sur un hôte surveillé spécifique.
Vous pouvez ensuite voir un tableau de bord hôte avec toutes les métriques collectées et les processus surveillés.
Configuration du traçage distribué du proxy d' Envoy
Pour utiliser le traçage distribué du proxy d' Envoy, procédez comme suit :
Téléchargez les fichiers binaires d' Instana s pour les distributions prises en charge d' Envoy Proxy sur la page des fichiers binaires d' Envoy Distributed Tracing.
Une fois le fichier binaire du traceur téléchargé, placez-le dans un emplacement accessible au proxy d' Envoy, par exemple
/opt/envoy/libcxx-libinstana_sensor.so. Ajoutez ensuite unetracingsection au fichier de configuration YAML du proxy Envoy, comme suit :static_resources: listeners: - address: ... filter_chains: - filters: - name: envoy.filters.network.http_connection_manager typed_config: "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager ...Configurez le chemin d'accès au fichier binaire de traceur avec la clé
libraryet configurez votre nom de service avec la cléservicecomme suit:tracing: provider: name: envoy.tracers.dynamic_ot typed_config: "@type": type.googleapis.com/envoy.config.trace.v3.DynamicOtConfig library: /opt/envoy/libcxx-libinstana_sensor.so config: service: your-service-name
Pour plus d'informations, consultez la documentation officielle sur le proxy d' Envoy.
Pour savoir comment utiliser Distributed Tracing, consultez les exemples de configuration sur la page Envoy-tracing repository .
Envoy Exemple de traçage
Instana met à disposition un référentiel public permettant de tester la fonctionnalité de traçage du capteur Proxy d' Envoy. Pour plus d'informations, voir Envoy-tracing.
Traitement des incidents
Type de problème de surveillance : envoy_access_metrics_endpoint_failed
Pour résoudre ce problème, configurez une interface d'administration comme indiqué dans le document consacré à l'interface d'administration.
Type de problème de surveillance : envoy_missing_configuration_admin_address_path
Pour résoudre ce problème, mettez à jour le capteur Proxy d' Envoy de l'agent Instana vers la dernière version. La prise en charge des environnements conteneurisés et l'analyse de la configuration du fichier ` YAML ` sont disponibles depuis la version 1.1.0.