Variáveis de ambiente

As seguintes variáveis de ambiente são válidas para todos os agentes (tanto os instalados no host quanto os em contêineres).

Variável de Ambiente	Obrigatório	Valor Padrão	Descrição
JAVA_OPTS	Não	Nenhum	Configurações adicionais da máquina virtual do Java® que você pode querer passar para a inicialização do agente do host. Por exemplo, você pode usar-Xms<value> `and`-Xmx<value> para definir, respectivamente, o tamanho mínimo e máximo da pilha disponível para o agente.
ENABLE_AGENT_SOCKET	Não	true	A variável que determina a direção da comunicação do agente do ` Instana ` com as JVMs. Para permitir que a comunicação seja direcionada ao agente, defina esta variável comotrue. Para direcionar a comunicação para o JVM, defina esta variável comofalse.
INSTANA_AGENT_MAX_MEM	Não	Nenhum	Define a quantidade máxima de memória disponível para o agente. Por padrão, o limite de memória é determinado automaticamente com base nos limites de recursos do contêiner.INSTANA_AGENT_MAX_MEM é ignorado seINSTANA_AGENT_USE_MEMORY_CALCULATOR estiver definido comofalse.
INSTANA_AGENT_TLS_1_0	Não	false	Ative o TLS v1.0.
INSTANA_AGENT_TLS_1_1	Não	false	Ative o TLS v1.1.
INSTANA_AGENT_USE_MEMORY_CALCULATOR	Não	true	Determina se o agente tenta usar sua calculadora de memória integrada para definir automaticamente os limites de memória do agente.
INSTANA_JVM_BYTEBUDDY_ATTACHMENT_ENABLED	Não	true	Esta variável ativa ou desativa a inclusão de um arquivo ` JVM ` usando o `byte buddy`.
INSTANA_JVM_HANDLING_REQUIRE_ATTACH_FILES	Não	false	Determina se o agente se conecta apenas a JVMs com arquivos de conexão válidos. Defina essatrue opção para impedir a ligação a processos que não sejam do tipo ` Java `, os quais o agente possa identificar erroneamente como JVMs durante as transições de processo. O valor padrão éfalse manter o comportamento atual dos anexos.
INSTANA_JVM_CONCURRENT_ATTACHMENTS	Não	4	Número máximo de subprocessos simultâneos de conexão do ` JVM `.
INSTANA_JVM_CONCURRENT_LOADS	Não	6	Número máximo de operações simultâneas de carregamento do javaagent.
INSTANA_AGENT_OTEL_GRPC	Não	false	Ativar o servidor GRPC do OTEL.
INSTANA_AGENT_OTEL_HTTP	Não	false	Ative o servidor OTEL HTTP.
INSTANA_AGENT_OTEL_GRPC_PORT	Não	4317	Substituir o número da porta GRPC do OTEL.
INSTANA_AGENT_OTEL_HTTP_PORT	Não	4318	Substituir o número de porta do OTEL HTTP.
INSTANA_AGENT_OTEL_GRPC_LEGACY_PORT_ENABLED	Não	true para versões do agente anteriores à 1.310.0 false para versões do agente 1.310.0 e posteriores	Ativar ou desativar a porta legada OTLP gRPC (55680).
INSTANA_APPEND_FQDN_TO_AGENT_ID	Não	false	Acrescenta o nome do host ao ID do agente para garantir a exclusividade entre hosts idênticos. Para obter mais informações, consulte Conflitos de ID de agente devido a endereços MAC idênticos
IN_MEMORY_CLASSLOADER	Não	false	Utiliza oin-memory-classloader para carregar os agentes JVM Java dentro dos contêineres, em vez de JARs baseados em arquivos. Quando ativada, a memória livre necessária é reduzida para 3.5 MB, mas à custa de um consumo adicional de memória do heap.
INSTANA_GIT_REMOTE_REPOSITORY	Não	Nenhum	Git URL remoto a ser utilizado pelo agente para o gerenciamento de configuração baseado em Git. A variável deve ser definida seINSTANA_GIT_REMOTE_BRANCH estiver definida.
INSTANA_GIT_REMOTE_BRANCH	Não	Nenhum	Git ramo remoto a ser monitorado pelo agente para gerenciamento de configuração baseado em Git. A variável deve ser definida seINSTANA_GIT_REMOTE_REPOSITORY estiver definida.
INSTANA_GIT_REMOTE_USERNAME	Não	Nenhum	Opcional: O nome de usuário ou token de acesso a ser usado na autenticação básica para operações do Git.
INSTANA_GIT_REMOTE_PASSWORD	Não	Nenhum	Opcional: A senha a ser usada na autenticação básica para operações do Git.
INSTANA_AGENT_UPDATES_VERSION	Não	Nenhum	Fixa a versão dos sensores (anteriormente denominada “versão do agente” até a versão 321) a um SHA específico. A partir do Agent Bootstrap1.2.49, essa variável de ambiente também pode ser usada para definir a versão dos sensores.

As seguintes variáveis de ambiente são específicas do agente em contêiner.

Variável de Ambiente	Obrigatório	Valor Padrão	Descrição
INSTANA_AGENT_BACKCHANNEL_ENABLED	Não	Nenhum	Permite que o agente processe os comandos da interface do usuário do Instana, como reiniciar o agente ou baixar registros do agente.
INSTANA_AGENT_HTTP_LISTEN	Não	Nenhum	Define os endereços IP das interfaces de rede nas quais o agente escuta o tráfego de entrada proveniente das aplicações monitoradas. Para obter mais informações, consul te a Referência de rede.
INSTANA_AGENT_HTTP_THREADS	Não	Nenhum	Define o número de threads responsáveis pelo tráfego de entrada do HTTP com dados das aplicações monitoradas.
INSTANA_LOG_LEVEL	True	INFO	Controla o nível de registro dos pacotes d com.instana. Valores possíveis:INFO,DEBUG,TRACE,WARN,ERROR, ouOFF.
INSTANA_ROOT_LOGGER_LOG_LEVEL	Não	INFO	Controla o nível de registro de todos os outros pacotes que não estão abrangidos porINSTANA_LOG_LEVEL. Valores possíveis:INFO,DEBUG,TRACE,WARN,ERROR, ouOFF.
INSTANA_ROOT_LOGGER_CONSOLE_APPENDER_LOG_LEVEL	Não	INFO	Define o nível de log que é exibido no console (stdout) e coletado pelo sistema de registro de logs do contêiner. Valores possíveis:INFO,DEBUG,TRACE,WARN,ERROR, ouOFF.
INSTANA_AGENT_KEY	True	Nenhum	Sua chave de agente do Instana.
INSTANA_AGENT_ENDPOINT	Não	Nenhum	O endpoint do agente do host.
INSTANA_AGENT_ENDPOINT_PORT	Não	Nenhum	A porta de destino do agente do host.
INSTANA_AGENT_ZONE	Não	Nenhum	A zona onde o agente anfitrião deve ser colocado.
INSTANA_AGENT_TAGS	Não	Nenhum	Lista de tags separadas por vírgulas associadas ao host que executa o agente, tais comomy_tag=myvalue,my_other_tag.
INSTANA_AGENT_MAX_MEM	Não	Nenhum	Define a quantidade máxima de memória disponível para o agente. Por padrão, o limite de memória é determinado automaticamente com base nos limites de recursos do contêiner.INSTANA_AGENT_MAX_MEM é ignorado seINSTANA_AGENT_USE_MEMORY_CALCULATOR estiver definido comofalse.
INSTANA_AGENT_MODE	Não	APM	O modo agente. Os valores disponíveis sãoAPM:,INFRASTRUCTURE, AWS, ouOFF.
INSTANA_DOWNLOAD_KEY	Não	Nenhum	Sua chave de download do Instana.
INSTANA_AGENT_MODE_WEB_OVERRIDE_ALLOWED	Não	Nenhum	Permite alterar o modo do agente a partir da interface do usuário do Instana.
INSTANA_AGENT_SCHEDULER_THREADS	Não	Nenhum	Define o número de threads disponíveis para várias tarefas agendadas ou assíncronas executadas pelo agente.
INSTANA_AGENT_SOURCE_DOWNLOAD_ENABLED	Não	Nenhum	Permite que o agente envie o código-fonte dos processos monitorados para Instana, para que o código-fonte possa ser associado aos dados de rastreamento.
INSTANA_AGENT_UNIQUE_AGENT_ID	Não	Nenhum	Define um ID de agente estático. Para obter mais informações, consulte Conflitos de ID de agente devido a endereços MAC idênticos.
INSTANA_AGENT_USE_CLOUD_PROVIDER_ID	Não	Nenhum	Instrui o agente a usar o ID do provedor de nuvem como ID do agente.
INSTANA_AGENT_USE_MEMORY_CALCULATOR	Não	Nenhum	Determina se o agente tenta usar sua calculadora de memória integrada para definir automaticamente os limites de memória do agente.
INSTANA_AGENT_UPDATES_FREQUENCY	Não	DIA	Controla a frequência com que as atualizações do sensor são obtidas. Para obter mais informações, consulte Atualizações e fixação de versão.
INSTANA_AGENT_UPDATES_TIME	Não	4h30	Controla o momento em que as atualizações do sensor são obtidas. Para obter mais informações, consulte Atualizações e fixação de versão.
INSTANA_AGENT_PROXY_HOST	Não	Nenhum	O nome do host/endereço de um proxy.
INSTANA_AGENT_PROXY_PORT	Não	Nenhum	A porta de um proxy.
INSTANA_AGENT_PROXY_PROTOCOL	Não	Nenhum	O protocolo de proxy, como, por exemplohttp.
INSTANA_AGENT_PROXY_USER	Não	Nenhum	O nome de usuário para a autenticação do proxy.
INSTANA_AGENT_PROXY_PASSWORD	Não	Nenhum	A senha da autenticação do proxy.
INSTANA_AGENT_PROXY_USE_DNS	Não	Não	Valor booleano indicando se o proxy também utiliza o protocolo DNS.
INSTANA_REPOSITORY_PROXY_ENABLED	Não	Nenhum	Permite substituir as configurações de proxy especificamente para atualizações do sensor.
INSTANA_REPOSITORY_PROXY_HOST	Não	Nenhum	O nome do host/endereço de um proxy para o repositório de sensores Maven.
INSTANA_REPOSITORY_PROXY_PORT	Não	Nenhum	A porta de um proxy para o repositório de sensores Maven.
INSTANA_REPOSITORY_PROXY_PROTOCOL	Não	Nenhum	O protocolo de proxy para o repositório de sensores Maven.
INSTANA_REPOSITORY_PROXY_USER	Não	Nenhum	O nome de usuário da autenticação por proxy para o repositório de sensores Maven.
INSTANA_REPOSITORY_PROXY_PASSWORD	Não	Nenhum	A senha de autenticação do proxy para o repositório de sensores Maven.
INSTANA_MVN_REPOSITORY_URL	Não	Nenhum	O nome do servidor do repositório Maven para downloads dinâmicos de pacotes de agentes e sensores. Para obter mais informações, consulte Configurando o espelho do repositório do agente.
INSTANA_MVN_REPOSITORY_FEATURES_PATH	Não	Nenhum	O caminho do repositório Maven para atualizações de recursos. Este é um recurso antigo. Para obter mais informações, consulte Configurando o espelho do repositório do agente.
INSTANA_MVN_REPOSITORY_SHARED_PATH	Não	Nenhum	O caminho do repositório Maven para atualizações dinâmicas de pacotes de agentes e sensores. Para obter mais informações, consulte Configurando o espelho do repositório do agente.
AGENT_RELEASE_REPOSITORY_MIRROR_URL	Não	Nenhum	O espelho do repositório de lançamentos do agente URL. Este é um recurso antigo. Para obter mais informações, consulte a configuração do repositório do Maven antigo.
AGENT_RELEASE_REPOSITORY_MIRROR_USERNAME	Não	Nenhum	O nome de usuário para acessar o espelho do repositório de versões do agente. Este é um recurso antigo. Para obter mais informações, consulte a configuração do repositório do Maven antigo.
AGENT_RELEASE_REPOSITORY_MIRROR_PASSWORD	Não	Nenhum	A senha para acessar o espelho do repositório de versões do agente. Este é um recurso antigo. Para obter mais informações, consulte a configuração do repositório do Maven antigo.
INSTANA_SHARED_REPOSITORY_MIRROR_URL	Não	Nenhum	O arquivo ` URL ` do espelho do repositório compartilhado. Para obter mais informações, consulte Configurando espelhos do repositório Maven.
INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME	Não	Nenhum	O nome de usuário para acessar o espelho do repositório compartilhado. Para obter mais informações, consulte Configurando espelhos do repositório Maven.
INSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD	Não	Nenhum	A senha para acessar o espelho do repositório compartilhado. Para obter mais informações, consulte Configurando espelhos do repositório Maven.

Para obter mais informações, consulte a documentação sobre configuração do agente e a documentação sobre configuração do agente baseada em git.

Variável de Ambiente	Valor	Descrição
INSTANA_ENDPOINT_URL	Sequência	O endpoint de backend do Instana ao qual seus agentes sem servidor se conectam. Ele depende da sua região e é diferente do terminal de backend do agente hospedeiro. Começa comhttps://serverless-.
INSTANA_AGENT_KEY	Sequência	Sua chave de agente do Instana. A mesma chave do agente pode ser usada para o monitoramento de agentes de host e sem servidor.
INSTANA_TIMEOUT	Número Inteiro	Tempo de espera, em milissegundos, para as solicitações do HTTP que enviam dados ao backend do Instana.
INSTANA_ENDPOINT_PROXY	URL	Defina esta variável parahttp://my-proxy.tld ouhttp://user:password@my-proxy.tld para encaminhar o envio de dados ao backend do Instana por meio de um(s) proxy(s) HTTP.
INSTANA_EXTRA_HTTP_HEADERS	Sequência, separado por ponto e vírgula	Lista separada por ponto e vírgula de cabeçalhos de HTTP a serem capturados.
INSTANA_SERVICE_NAME	Sequência	Nome do serviço customizado.
INSTANA_LOG_LEVEL	debug...warninfo ouerror	O nível de registro do pacote Instana. Por padrão, é assiminfo.
INSTANA_LOG_SPANS	true oufalse	Defina esta variável paratrue incluir os spans gerados pela instrumentação do ` Instana `, que são enviados para a saída padrão. Essa configuração é útil para depurar problemas de SDK e de instrumentação automática.
INSTANA_DEBUG	Sequência	Defina esta variável com qualquer valor para definir o nível de registrodebug.
INSTANA_DISABLE_CA_CHECK	true oufalse	Defina esta variável paratrue desativar a verificação do certificado do servidor em relação à lista de autoridades de certificação (CAs) integrada ao ambiente de execução do Lambda quando ele se conectar ao backend do Instana. Ativar esse recurso torna seu Lambda vulnerável a ataques do tipo “ MITM ” para essa conexão. Utilize esta configuração apenas se você usar o Instana em um servidor próprio e não conseguir operar o backend do Instana com um certificado cuja CA raiz seja conhecida.
INSTANA_SECRETS	Sequência	O valor deve ser estruturado da seguinte forma,<matcher>:<secret>[,<secret>] por exemplocontains-ignore-case:key,password,secret: Consulte a documentação do Secrets para obter mais detalhes sobre os comparadores.
INSTANA_TAGS	Sequência, separada por vírgula	Uma lista de tags, separadas por vírgulas, associadas ao componente monitorado, por exemplomy_tag=myvalue,my_other_tag.
INSTANA_ZONE	Sequência	A zona na qual colocar esse componente monitorado.
INSTANA_DISABLE_USE_OPENTELEMETRY	true oufalse	Defina esta variável paratrue desativar a integração com o OpenTelemetry. O valor padrão éfalse.
INSTANA_STACK_TRACE	all,error, ounone	Defina esta variável comoerror para capturar rastreamentos de pilha apenas para intervalos com erros ou comonone para desativar a captura de rastreamentos de pilha. O valor padrão éall.
INSTANA_STACK_TRACE_LENGTH	Número Inteiro	Configure esta variável para limitar o número de estruturas de rastreio de pilha capturadas em um período.

Os Sensores de linguagem dinâmica oferecidos pelo Instana respeitam um conjunto comum de variáveis de ambiente. A tabela a seguir descreve esse conjunto comum.

Para obter mais informações sobre Java, Scala, .NET, .NET Core ou PHP, consulte as páginas de documentação correspondentes.

Variável de Ambiente	Valor	Descrição
INSTANA_AGENT_HOST	Endereço IP ou nome do DNS	Permite que os usuários especificam manualmente o local do agente de host do Instana.
INSTANA_AGENT_PORT	Número da porta	Especificar manualmente a porta do agente de host do Instana.
INSTANA_DISABLE_AUTO_INSTR	true oufalse	Desativa a instrumentação automática.
INSTANA_SERVICE_NAME	Sequência	Define o nome do serviço para toda a aplicação.
INSTANA_PROCESS_NAME	Sequência	Define um rótulo personalizado para a entidade de infraestrutura que representa esse ambiente de execução. [1]
INSTANA_DEBUG	Qualquer valor	Ativa o registro de depuração. Use-o apenas por um período limitado para evitar sobrecarga e envio excessivo de registros.
INSTANA_DISABLE_USE_OPENTELEMETRY	true oufalse	Defina esta variável paratrue desativar a integração com o OpenTelemetry. O valor padrão éfalse.
INSTANA_STACK_TRACE	all,error, ounone	Defina esta variável comoerror para capturar rastreamentos de pilha apenas para intervalos com erros ou comonone para desativar a captura de rastreamentos de pilha. O valor padrão éall.
INSTANA_STACK_TRACE_LENGTH	Número Inteiro	Configure esta variável para limitar o número de estruturas de rastreio de pilha capturadas em um período.
INSTANA_TRACING_HTTP_EXIT_CLASSIFY_ALL_4XX_AS_ERRORS	true ou false	Defina essa variável como true para marcar todas as respostas do tipo “ 4xx ” como erros nos spans de saída. O valor padrão é false.
INSTANA_TRACING_HTTP_EXIT_CLASSIFY_AS_ERRORS	Números inteiros separados por vírgulas	Defina essa variável como uma lista separada por vírgulas de códigos de status do ` 4xx ` a serem marcados como erros nos intervalos de saída; por exemplo, 401,403.

Para obter informações sobre Java, Scala, .NET, .NET Core ou PHP, consulte as páginas de documentação correspondentes.

Programação	Crystal	Go	Haskell	NGINX	Node.js	PHP	Python	Ruby	.NET Core	.NET
INSTANA_AGENT_HOST	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_AGENT_PORT	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_AUTO_INSTR	N/D	N/D	N/D	N/D	✅	❌	✅	✅	❌	❌
INSTANA_SERVICE_NAME	❌	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_PROCESS_NAME	✅	✅	✅	✅	✅	✅	✅	✅	❌	❌
INSTANA_DEBUG	✅	✅	❌	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_USE_OPENTELEMETRY	❌	❌	❌	❌	✅	❌	❌	❌	❌	❌
INSTANA_STACK_TRACE	❌	❌	❌	❌	✅	✅	✅	✅	❌	❌
INSTANA_STACK_TRACE_LENGTH	❌	❌	❌	❌	✅	✅	✅	✅	❌	❌
INSTANA_TRACING_HTTP_EXIT_CLASSIFY_ALL_4XX_AS_ERRORS	❌	❌	❌	❌	✅	✅	❌	❌	❌	❌
INSTANA_TRACING_HTTP_EXIT_CLASSIFY_AS_ERRORS	❌	❌	❌	❌	✅	✅	❌	❌	❌	❌