Variables d'environnement

Les variables d'environnement suivantes s'appliquent à tous les agents (qu'ils soient hébergés sur un hôte ou en conteneur).

Variable d"environnement	Obligatoire	Valeur par défaut	Description
JAVA_OPTS	Non	Aucun	Configurations supplémentaires de la machine virtuelle d' Java® s que vous pourriez souhaiter transmettre au démarrage de l'agent hôte. Par exemple, vous pouvez utiliser-Xms<value> « and »-Xmx<value> pour définir respectivement la taille minimale et maximale de la mémoire dynamique mise à la disposition de l'agent.
ENABLE_AGENT_SOCKET	Non	true	Variable permettant de définir le sens de communication entre l'agent d' Instana et les JVM. Pour que les communications soient acheminées vers l'agent, définissez cette variable surtrue. Pour diriger la communication vers l' JVM, définissez cette variable surfalse.
INSTANA_AGENT_MAX_MEM	Non	Aucun	Définit la quantité maximale de mémoire disponible pour l'agent. Par défaut, la limite de mémoire est déterminée automatiquement en fonction des limites de ressources du conteneur.INSTANA_AGENT_MAX_MEM est ignoré siINSTANA_AGENT_USE_MEMORY_CALCULATOR est défini surfalse.
INSTANA_AGENT_TLS_1_0	Non	false	Activer TLS v1.0.
INSTANA_AGENT_TLS_1_1	Non	false	Activer TLS v1.1.
INSTANA_AGENT_USE_MEMORY_CALCULATOR	Non	true	Détermine si l'agent tente d'utiliser son calculateur de mémoire intégré pour définir automatiquement les limites de mémoire de l'agent.
INSTANA_JVM_BYTEBUDDY_ATTACHMENT_ENABLED	Non	true	Cette variable active ou désactive l'ajout d'un fichier « JVM » à l'aide de Byte Buddy.
INSTANA_JVM_HANDLING_REQUIRE_ATTACH_FILES	Non	false	Détermine si l'agent se connecte uniquement aux JVM disposant de fichiers de connexion valides. Définir cettetrue option pour empêcher l'association à des processus non liés à Java que l'agent pourrait identifier à tort comme des JVM lors des transitions de processus. Par défaut, le comportement actuel des pièces jointes estfalse conservé.
INSTANA_AGENT_OTEL_GRPC	Non	false	Activer le serveur GRPC OTEL.
INSTANA_AGENT_OTEL_HTTP	Non	false	Activer le serveur d' HTTP s OTEL.
INSTANA_AGENT_OTEL_GRPC_PORT	Non	4317	Remplacer le numéro de port GRPC de l'OTEL.
INSTANA_AGENT_OTEL_HTTP_PORT	Non	4318	Remplacer le numéro de port de l' HTTP OTEL.
INSTANA_AGENT_OTEL_GRPC_LEGACY_PORT_ENABLED	Non	true pour les versions de l'agent antérieures à 1.310.0 false pour les versions de l'agent 1.310.0 et ultérieures	Activer ou désactiver le port gRPC ( OTLP55680) hérité.
INSTANA_APPEND_FQDN_TO_AGENT_ID	Non	false	Ajoute le nom d'hôte à l'identifiant de l'agent afin de garantir l'unicité entre les hôtes identiques. Pour plus d'informations, consultez la section « Conflits d'identifiant d'agent dus à des adresses MAC identiques »
IN_MEMORY_CLASSLOADER	Non	false	Utilise la commandein-memory-classloader « for » pour charger les agents JVM Java à l'intérieur des conteneurs, au lieu d'utiliser des fichiers JAR. Lorsque cette option est activée, l'espace de stockage libre requis est réduit à 3.5 Mo, mais cela entraîne une consommation supplémentaire de mémoire du tas.
INSTANA_GIT_REMOTE_REPOSITORY	Non	Aucun	Git URL s à distance destinées à être utilisées par l'agent pour la gestion de la configuration via l' Git. La variable doit être définie siINSTANA_GIT_REMOTE_BRANCH est définie.
INSTANA_GIT_REMOTE_BRANCH	Non	Aucun	Git branche distante à suivre par l'agent pour la gestion de configuration basée sur l' Git. La variable doit être définie siINSTANA_GIT_REMOTE_REPOSITORY est définie.
INSTANA_GIT_REMOTE_USERNAME	Non	Aucun	Facultatif : le nom d'utilisateur ou le jeton d'accès à utiliser pour l'authentification de base lors des opérations sur Git.
INSTANA_GIT_REMOTE_PASSWORD	Non	Aucun	Facultatif : mot de passe à utiliser pour l'authentification de base lors des opérations sur Git.
INSTANA_AGENT_UPDATES_VERSION	Non	Aucun	Associe les versions du capteur à un SHA spécifique. À partir d'Agent Bootstrap1.2.49, cette variable d'environnement peut également servir à définir la version de l'agent.

Les variables d'environnement suivantes sont spécifiques à l'agent conteneurisé.

Variable d"environnement	Obligatoire	Valeur par défaut	Description
INSTANA_AGENT_BACKCHANNEL_ENABLED	Non	Aucun	Permet à l'agent de traiter les commandes provenant de l'interface utilisateur d' Instana, telles que le redémarrage de l'agent ou le téléchargement des journaux depuis l'agent.
INSTANA_AGENT_HTTP_LISTEN	Non	Aucun	Définit les adresses IP des interfaces réseau sur lesquelles l'agent écoute le trafic entrant provenant des applications surveillées. Pour plus d'informations, consul tez la documentation sur le réseau.
INSTANA_AGENT_HTTP_THREADS	Non	Aucun	Définit le nombre de threads chargés de traiter le trafic entrant sur le port HTTP provenant des applications surveillées.
INSTANA_LOG_LEVEL	Oui	INFOS	Permet de définir le niveau de journalisation des paquets d' com.instana. Valeurs possibles :INFO,DEBUG,TRACE,WARN,ERROR, ouOFF.
INSTANA_ROOT_LOGGER_LOG_LEVEL	Non	INFOS	Définit le niveau de journalisation de tous les autres paquets qui ne sont pas concernés par cette INSTANA_LOG_LEVELoption. Valeurs possibles : INFO, DEBUG, TRACE, WARN, ERROR, ouOFF.
INSTANA_ROOT_LOGGER_CONSOLE_APPENDER_LOG_LEVEL	Non	INFOS	Définit le niveau de journalisation qui s'affiche sur la console (stdout) et qui est collecté par le système de journalisation du conteneur. Valeurs possibles :INFO,DEBUG,TRACE,WARN,ERROR, ouOFF.
INSTANA_AGENT_KEY	Oui	Aucun	Votre clé d'agent d' Instana.
INSTANA_AGENT_ENDPOINT	Non	Aucun	Le point de terminaison de l'agent hôte.
INSTANA_AGENT_ENDPOINT_PORT	Non	Aucun	Le port de terminaison de l'agent hôte.
INSTANA_AGENT_ZONE	Non	Aucun	La zone où placer l'agent hôte.
INSTANA_AGENT_TAGS	Non	Aucun	Liste de balises séparées par des virgules associées à l'hôte sur lequel l'agent est exécuté, par exemplemy_tag=myvalue,my_other_tag.
INSTANA_AGENT_MAX_MEM	Non	Aucun	Définit la quantité maximale de mémoire disponible pour l'agent. Par défaut, la limite de mémoire est déterminée automatiquement en fonction des limites de ressources du conteneur.INSTANA_AGENT_MAX_MEM est ignoré siINSTANA_AGENT_USE_MEMORY_CALCULATOR est défini surfalse.
INSTANA_AGENT_MODE	Non	APM	Le mode agent. Les valeurs disponibles sont APM:,INFRASTRUCTURE, AWS, ouOFF.
INSTANA_DOWNLOAD_KEY	Non	Aucun	Votre clé de téléchargement d' Instana.
INSTANA_AGENT_MODE_WEB_OVERRIDE_ALLOWED	Non	Aucun	Vous permet de modifier le mode de l'agent depuis l'interface utilisateur d' Instana.
INSTANA_AGENT_SCHEDULER_THREADS	Non	Aucun	Définit le nombre de threads disponibles pour les différentes tâches planifiées ou asynchrones exécutées par l'agent.
INSTANA_AGENT_SOURCE_DOWNLOAD_ENABLED	Non	Aucun	Permet à l'agent de télécharger le code source des processus surveillés vers Instana afin que ce code puisse être associé aux données de traçage.
INSTANA_AGENT_UNIQUE_AGENT_ID	Non	Aucun	Définit un identifiant d'agent statique. Pour plus d'informations, consul tez la section « Conflits d'identifiant d'agent dus à des adresses MAC identiques ».
INSTANA_AGENT_USE_CLOUD_PROVIDER_ID	Non	Aucun	Indique à l'agent d'utiliser l'identifiant du fournisseur de services cloud comme identifiant d'agent.
INSTANA_AGENT_USE_MEMORY_CALCULATOR	Non	Aucun	Détermine si l'agent tente d'utiliser son calculateur de mémoire intégré pour définir automatiquement les limites de mémoire de l'agent.
INSTANA_AGENT_UPDATES_FREQUENCY	Non	JOUR	Détermine la fréquence à laquelle les mises à jour du capteur sont récupérées. Pour plus d'informations, consultez la section « Mises à jour et verrouillage de version ».
INSTANA_AGENT_UPDATES_TIME	Non	04:30	Détermine à quel moment les mises à jour du capteur sont récupérées. Pour plus d'informations, consultez la section « Mises à jour et verrouillage de version ».
INSTANA_AGENT_PROXY_HOST	Non	Aucun	Le nom d'hôte ou l'adresse d'un proxy.
INSTANA_AGENT_PROXY_PORT	Non	Aucun	Le port d'un proxy.
INSTANA_AGENT_PROXY_PROTOCOL	Non	Aucun	Le protocole proxy, par exemplehttp.
INSTANA_AGENT_PROXY_USER	Non	Aucun	Le nom d'utilisateur pour l'authentification du proxy.
INSTANA_AGENT_PROXY_PASSWORD	Non	Aucun	Le mot de passe pour l'authentification du proxy.
INSTANA_AGENT_PROXY_USE_DNS	Non	false	Valeur booléenne indiquant si le proxy utilise également l' DNS
INSTANA_REPOSITORY_PROXY_ENABLED	Non	Aucun	Permet de remplacer les paramètres du proxy spécifiquement pour les mises à jour des capteurs.
INSTANA_REPOSITORY_PROXY_HOST	Non	Aucun	Le nom d'hôte ou l'adresse d'un serveur proxy pour le référentiel des capteurs d' Maven.
INSTANA_REPOSITORY_PROXY_PORT	Non	Aucun	Le port d'un proxy pour le référentiel des capteurs de l' Maven.
INSTANA_REPOSITORY_PROXY_PROTOCOL	Non	Aucun	Le protocole de proxy pour le référentiel de capteurs de l' Maven.
INSTANA_REPOSITORY_PROXY_USER	Non	Aucun	Le nom d'utilisateur pour l'authentification par proxy du référentiel des capteurs d' Maven.
INSTANA_REPOSITORY_PROXY_PASSWORD	Non	Aucun	Le mot de passe d'authentification du proxy pour le référentiel des capteurs Maven.
INSTANA_MVN_REPOSITORY_URL	Non	Aucun	Le nom d'hôte du référentiel Maven pour le téléchargement dynamique des agents et des ensembles de capteurs. Pour plus d'informations, consultez la section « Configuration d'un miroir du référentiel d'agents ».
INSTANA_MVN_REPOSITORY_FEATURES_PATH	Non	Aucun	Chemin d'accès au référentiel « Maven » pour les mises à jour de fonctionnalités. Il s'agit d'une fonctionnalité héritée. Pour plus d'informations, consultez la section « Configuration d'un miroir du référentiel d'agents ».
INSTANA_MVN_REPOSITORY_SHARED_PATH	Non	Aucun	Chemin d'accès au référentiel « Maven » pour les mises à jour dynamiques des agents et des ensembles de capteurs. Pour plus d'informations, consultez la section « Configuration d'un miroir du référentiel d'agents ».
AGENT_RELEASE_REPOSITORY_MIRROR_URL	Non	Aucun	URL s relatives au miroir du référentiel de publication de l'agent. Il s'agit d'une fonctionnalité héritée. Pour plus d'informations, consultez la section « Configuration du référentiel Legacy Maven ».
AGENT_RELEASE_REPOSITORY_MIRROR_USERNAME	Non	Aucun	Le nom d'utilisateur permettant d'accéder au miroir du référentiel de versions de l'agent. Il s'agit d'une fonctionnalité héritée. Pour plus d'informations, consultez la section « Configuration du référentiel Legacy Maven ».
AGENT_RELEASE_REPOSITORY_MIRROR_PASSWORD	Non	Aucun	Le mot de passe permettant d'accéder au miroir du référentiel de versions de l'agent. Il s'agit d'une fonctionnalité héritée. Pour plus d'informations, consultez la section « Configuration du référentiel Legacy Maven ».
INSTANA_SHARED_REPOSITORY_MIRROR_URL	Non	Aucun	L' URL e du miroir du référentiel partagé. Pour plus d'informations, consultez la section « Configuration des miroirs du référentiel d' Maven ».
INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME	Non	Aucun	Le nom d'utilisateur permettant d'accéder au miroir du référentiel partagé. Pour plus d'informations, consultez la section « Configuration des miroirs du référentiel d' Maven ».
INSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD	Non	Aucun	Le mot de passe permettant d'accéder au miroir du référentiel partagé. Pour plus d'informations, consultez la section « Configuration des miroirs du référentiel d' Maven ».

Pour plus d'informations, consultez la documentation relative à la configuration des agents ainsi que celle concernant la configuration des agents via l' git.

Variable d'environnement	Valeur	Description
INSTANA_ENDPOINT_URL	Chaîne	Le point de terminaison backend de l' Instana, auquel vos agents sans serveur se connectent. Il dépend de votre région et est différent du noeud final d'arrière-plan de l'agent hôte. Ça commence parhttps://serverless-.
INSTANA_AGENT_KEY	Chaîne	Votre clé d'agent d' Instana. La même clé d'agent peut être utilisée pour les agents hôte et la surveillance sans serveur.
INSTANA_TIMEOUT	Entier	Délai d'expiration, en millisecondes, pour les requêtes d' HTTP s transmettant des données au backend Instana.
INSTANA_ENDPOINT_PROXY	URL	Définissez cette variable surhttp://my-proxy.tld ouhttp://user:password@my-proxy.tld pour acheminer la transmission des données vers le serveur de base « Instana » via un ou plusieurs serveurs proxy ( HTTP ).
INSTANA_EXTRA_HTTP_HEADERS	Chaîne, séparée par un point-virgule	Liste d'en-têtes HTTP à capturer séparés par des points-virgules.
INSTANA_SERVICE_NAME	Chaîne	Nom du service personnalisé.
INSTANA_LOG_LEVEL	debug,info,warn, ouerror	Le niveau de journalisation du paquet « Instana ». Par défaut, c'est le casinfo.
INSTANA_LOG_SPANS	true oufalse	Définissez cette variable pourtrue récupérer les intervalles générés par l'instrumentation d' Instana, qui sont affichés sur la sortie standard. Ce paramètre est utile pour le débogage des problèmes de kit SDK et d'instrumentation automatique.
INSTANA_DEBUG	Chaîne	Définissez cette variable sur la valeur de votre choix pour définir le niveau de debugjournalisation.
INSTANA_DISABLE_CA_CHECK	true oufalse	Définissez cette variable pourtrue désactiver la vérification du certificat du serveur par rapport à la liste des autorités de certification intégrée au runtime Lambda lors de la connexion au backend Instana. L'activation de cette fonctionnalité rend votre fonction Lambda vulnérable aux attaques de type « MITM » pour cette connexion. N'utilisez ce paramètre que si vous utilisez une instance auto-hébergée d' Instana et que vous ne parvenez pas à faire fonctionner le backend Instana avec un certificat dont l'autorité de certification racine est connue.
INSTANA_SECRETS	Chaîne	La valeur doit être structurée comme suit,<matcher>:<secret>[,<secret>] par exemple contains-ignore-case:key,password,secret: Pour plus d'informations sur les sélecteurs, consultez la documentation de Secrets.
INSTANA_TAGS	Chaîne, séparée par des virgules	Une liste de balises, séparées par des virgules, associées au composant surveillé, par exemplemy_tag=myvalue,my_other_tag.
INSTANA_ZONE	Chaîne	Zone où placer ce composant surveillé.
INSTANA_DISABLE_USE_OPENTELEMETRY	true oufalse	Définissez cette variable surtrue pour désactiver l'intégration d'OpenTelemetry. La valeur par défaut est false.
INSTANA_STACK_TRACE	all,error, ounone	Définissez cette variable surerror pour ne capturer les traces de pile que pour les segments présentant des erreurs, ou surnone pour désactiver la capture des traces de pile. La valeur par défaut estall.
INSTANA_STACK_TRACE_LENGTH	Entier	Définissez cette variable pour limiter le nombre de cadres de trace de pile capturés dans une plage.

Les détecteurs de langage dynamiques proposés par Instana respectent un ensemble commun de variables d'environnement. Le tableau suivant présente cet ensemble commun.

Pour plus d'informations sur Java, Scala, .NET, .NET Core ou PHP, consultez les pages de documentation correspondantes.

Variable d'environnement	Valeur	Description
INSTANA_AGENT_HOST	Adresse IP ou nom DNS	Permet aux utilisateurs de spécifier manuellement l'emplacement de l'agent hôte Instana.
INSTANA_AGENT_PORT	Numéro de port	Spécification manuelle du port de l'agent hôte Instana.
INSTANA_DISABLE_AUTO_INSTR	true oufalse	Désactive l'instrumentation automatique.
INSTANA_SERVICE_NAME	Chaîne	Définit le nom du service pour l'ensemble de l'application.
INSTANA_PROCESS_NAME	Chaîne	Définit une étiquette personnalisée pour l'entité d'infrastructure qui représente cet environnement d'exécution. [1]
INSTANA_DEBUG	Toute valeur	Active la journalisation de débogage. N'utilisez cette fonction que pendant une durée limitée afin d'éviter toute surcharge et tout envoi excessif de journaux.
INSTANA_DISABLE_USE_OPENTELEMETRY	true oufalse	Définissez cette variable surtrue pour désactiver l'intégration d'OpenTelemetry. La valeur par défaut est false.
INSTANA_STACK_TRACE	all,error, ounone	Définissez cette variable surerror pour ne capturer les traces de pile que pour les segments présentant des erreurs, ou surnone pour désactiver la capture des traces de pile. La valeur par défaut estall.
INSTANA_STACK_TRACE_LENGTH	Entier	Définissez cette variable pour limiter le nombre de cadres de trace de pile capturés dans une plage.

Pour plus d'informations sur Java, Scala, .NET, .NET Core ou PHP, consultez les pages de documentation correspondantes.

Langue	Crystal	Go	Haskell	NGINX	Node.js	PHP	Python	Ruby	.NET Core	.NET
INSTANA_AGENT_HOST	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_AGENT_PORT	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_AUTO_INSTR	Non disponible	Non disponible	Non disponible	Non disponible	✅	❌	✅	✅	❌	❌
INSTANA_SERVICE_NAME	❌	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_PROCESS_NAME	✅	✅	✅	✅	✅	✅	✅	✅	❌	❌
INSTANA_DEBUG	✅	✅	❌	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_USE_OPENTELEMETRY	❌	❌	❌	❌	✅	❌	❌	❌	❌	❌
INSTANA_STACK_TRACE	❌	❌	❌	❌	✅	✅	✅	✅	❌	❌
INSTANA_STACK_TRACE_LENGTH	❌	❌	❌	❌	✅	✅	✅	✅	❌	❌