Gerenciar agentes de host

Se você atender aos pré-requisitos, poderá iniciar o gerenciamento de configuração.

Se não houver nenhum gerenciamento de configuração ativo, inicialize o gerenciamento de configuração baseado n Git clicando Initialize na seção Gerenciamento de configuração.

Em seguida, insira as seguintes informações na caixa de diálogo "Gerenciamento de configuração":

• Nome do controle remoto : O nome do controle remoto “ Git ”.
• Ramo remoto : o nome do ramo a ser usado para as atualizações.
• URI remota : A URI do repositório Git.

Clique em “Inicializar e reiniciar” para configurar o agente de acordo com as definições e reinicie para obter a configuração mais recente.

Se o gerenciamento de configuração já estiver ativo, você poderá ver os detalhes na seção Gerenciamento de configuração. Os detalhes incluem informações sobre o remote configurado, como o nome da ramificação e o URI, e informações sobre o commit atualmente em uso, como o hash e a mensagem do commit.

Para atualizar a configuração, clique em Atualizar e insira os detalhes necessários na caixa de diálogo Gerenciamento de configuração.

Clique em “Atualizar e reiniciar” para configurar o agente de acordo com as definições e reinicie para obter a configuração mais recente.

Para criar um despejo de memória (heap dump) para o agente do host em um sistema Linux, execute o seguinte comando em um shell Linux :

TS=`date +%s` && /opt/instana/agent/jvm/bin/jmap -dump:file=/tmp/agent-dump-$TS.hprof `cat /opt/instana/agent/agent.pid` && gzip /tmp/agent-dump-$TS.hprof

O comando cria o despejo de memória e salva o arquivo compactado em /tmp/agent-dump-<timestamp>.hprof.zip.

Para criar um despejo de memória (heap dump) para o agente do host em um sistema Windows, execute o seguinte comando em um PowerShell:

$TS = [int][double]::Parse((Get-Date -UFormat %s)); C:\"Program Files"\Instana\instana-agent\jvm\bin\jmap -dump:file="$env:TEMP\agent-dump-$TS.hprof" (Get-Content "C:\Program Files\Instana\instana-agent\agent.pid"); Compress-Archive -Path "$env:TEMP\agent-dump-$TS.hprof" -DestinationPath "$env:TEMP\agent-dump-$TS.hprof.zip" -Force; Remove-Item "$env:TEMP\agent-dump-$TS.hprof"

O comando cria o despejo de memória e salva o arquivo compactado em $TEMP\agent-dump-<timestamp>.hprof.zip.

Para criar um despejo de memória para o agente do host em um sistema Linux, siga estas etapas:

Um despejo de memória ad hoc só pode ser criado quando o agente é executado com essa -Dcom.ibm.tools.attach.enable=yes configuração. Para verificar essa configuração, abra o painel de gerenciamento de agentes na interface do usuário do Instana, acesse a entidade de processo de agente Instana no lado esquerdo do painel de processos e localize com.ibm.tools.attach.enable na lista de argumentos do processo.

As etapas a seguir pressupõem que o agente do Instana esteja instalado no local padrão em /opt/instana/agent e que esteja em execução como um serviço do Systemd. Você precisa definir os caminhos se tiver instalado o agent do Instana em um local diferente.

1. Faça login no servidor Linux como root usuário ou altere sua sessão de shell para o root usuário.
2. Abra o arquivo/opt/instana/agent/bin/setenv para edição.
3. Encontre a linha que começa com EXTRA_JAVA_OPTS= e altere a propriedade -Dcom.ibm.tools.attach.enable=no para -Dcom.ibm.tools.attach.enable=yes.
4. Reinicie o agente com systemctl restart instana-agent.
5. Deixe o agente em execução até que ocorra a situação que gera o despejo de memória.
6. Para criar um despejo de memória para o agente do host em um sistema Linux, execute o seguinte comando:

   TS=`date +%s` && /opt/instana/agent/jvm/bin/jcmd `cat /opt/instana/agent/agent.pid` Heap.dump /tmp/agent-dump-$TS.phd  && gzip /tmp/agent-dump-$TS.phd

   O comando cria o despejo de memória e salva o arquivo compactado em /tmp/agent-dump-<timestamp>.phd.zip.

Para criar um despejo de memória do agente do host em um sistema Windows, siga estas etapas:

Um despejo de memória ad hoc só pode ser criado quando o agente é executado com essa -Dcom.ibm.tools.attach.enable=yes configuração. Para verificar essa configuração, abra o painel de gerenciamento de agentes na interface do usuário do Instana, acesse a entidade de processo de agente Instana no lado esquerdo do painel de processos e localize com.ibm.tools.attach.enable na lista de argumentos do processo.

As etapas a seguir pressupõem que o agente do Instana esteja instalado no local padrão em C:\Program Files\Instana\instana-agent e que esteja em execução como um serviço do Systemd. Você precisa definir os caminhos se tiver instalado o agent do Instana em um local diferente.

1. Faça login no servidor Windows como Administrator.
2. Abrir C:\Program Files\Instana\instana-agent\bin\setenv.bat o arquivo para edição.
3. Encontre a linha que começa com SET EXTRA_JAVA_OPTS= e altere a propriedade -Dcom.ibm.tools.attach.enable=no para -Dcom.ibm.tools.attach.enable=yes.
4. Na Consola de Gestão da Microsoft, na secção “Serviços”, localize o “Serviço do Agente do Instana ” e reinicie o serviço.
5. Deixe o agente em execução até que ocorra a situação que gera o despejo de memória.
6. Crie o arquivo C:\Users\Administrator\agent-dump.ps1 com o seguinte conteúdo:

   $TS = [int][double]::Parse((Get-Date -UFormat %s))
   $AGENT_PID = (Get-Content "C:\Program Files\Instana\instana-agent\agent.pid")
   C:\"Program Files"\Instana\instana-agent\jvm\bin\jcmd $AGENT_PID Dump.heap C:\Windows\Temp\agent-dump-$TS.phd
   Compress-Archive -Path C:\Windows\Temp\agent-dump-$TS.phd -DestinationPath C:\Windows\Temp\agent-dump-$TS.phd.zip -Force
   Remove-Item C:\Windows\Temp\agent-dump-$TS.phd

7. Abra o programa “ PowerShell ” com privilégios de administrador.
8. Execute os seguintes comandos para criar e executar um script ScheduledTask que execute o despejo de memória como a SYSTEM conta:

   $SchedScript = New-ScheduledTaskAction -Execute "PowerShell.exe" -Argument '-ExecutionPolicy Bypass -file C:\Users\Administrator\agent-dump.ps1'
   Register-ScheduledTask -User SYSTEM -taskname !_AgentDump -Action $SchedScript | Out-Null
   Start-ScheduledTask -TaskName "!_AgentDump" 
   Unregister-ScheduledTask -TaskName "!_AgentDump" -Confirm:$false

   O comando cria o despejo de memória e salva o arquivo compactado em C:\Windows\Temp\agent-dump-<timestamp>.phd.zip.

Você pode analisar as métricas de desempenho do agente de host do Instana utilizando o recurso de autoanálise do agente.

O auto-perfilador é compatível apenas com sistemas Linux com arquitetura x86_64-bit. {: note} Para realizar o auto-perfilamento do agente do host, siga estas etapas:

1. Na seção Suporte do painel do agente, clique em Perfil do agente. O profiler é executado por 10 minutos. Você pode verificar os registros do agente para confirmar se o profiler foi iniciado. Consulte o seguinte exemplo:

   2025-03-19T14:21:48.077+00:00 | INFO  | instana-executor-thread-2-1      | ndRequestHandler | com.instana.agent-self-profiling - 1.0.0 | Starting Agent profiler for 10 minutes
   2025-03-19T14:21:52.998+00:00 | INFO  | instana-scheduler-thread-3-4     | Profiler         | com.instana.agent-self-profiling - 1.0.0 | Profiler installed
    

2. Depois de iniciar o profiler, aguarde 2 minutos e, em seguida, atualize o painel. Um novo botão, “Analisar perfis”, aparece no painel do agente.

3. Clique no botão “Analisar perfis” para abrir a página “Analisar perfis ”.

4. Na página “Analisar perfis ”, clique em “Ver tudo ”. Você pode compartilhar o gráfico Flame, juntamente com quaisquer informações adicionais solicitadas pelo Suporte do IBM para a análise de desempenho do agente.

Tipo de problema de monitoramento: agent_tmp_directory_missing

O agente de host do Instana cria arquivos JAR temporários no $TMP/.instana diretório. Esses arquivos JAR são necessários para o monitoramento do JVM. Este aviso indica que os arquivos JAR necessários estão faltando ou que o diretório tmp Instana não está disponível, o que pode causar problemas com anexos do Java. O agente do Instana monitora periodicamente o estado do diretório tmp Instana e seus arquivos JAR relevantes para evitar falhas no envio de anexos pelo Java.

Para evitar esse problema, certifique-se de que o tmp local tenha permissões de leitura e gravação e evite limpezas desnecessárias do /tmp local.

Tipo de problema de monitoramento: insufficient-disk-space-for-tmp-directory

Durante a execução, o contêiner do agente do Instana cria arquivos JAR temporários no $TMP/.instana diretório. Esses arquivos JAR são necessários para o monitoramento do JVM. Este aviso indica que não há espaço suficiente no tmp local para armazenar arquivos temporários, o que pode causar uma falha no envio de anexos pelo Java. Para resolver esse problema, aumente o espaço alocado para o tmp na implementação do contêiner

Tipo de problema de monitoramento: pax_url_mvn_leak

A versão do Pax 2.6.16URL do OPS4J apresenta um vazamento de memória que é reiniciado a cada 24 horas como parte da atualização do agente. Dependendo do número de sensores que forem parados e reiniciados durante esse período, o agente poderá encontrar um OutOfMemoryError erro. Para resolver esse problema, foi adicionada uma correção nos assemblies do agente lançados após 18 de junho de 2025. Se você detectar esse problema de monitoramento, atualize o assembly do seu agente do Instana para uma versão lançada a partir de 18 de junho de 2025.

Para obter mais informações sobre este problema, consulte o problema e a solicitação de pull correspondente no repositório pax-urlGitHub.

Tipo de problema de monitoramento: agent_jvm_tls_1_3_missing

O agente do Instana requer TLSv1.3 suporte no host instalado. Se não TLSv1.3 for compatível, as funcionalidades de monitoramento serão prejudicadas.

Para resolver esse problema, atualize a versão do seu agente do Instana TLS para TLSv1.3. As seguintes versões do TLS estão habilitadas: TLSv1, TLSv1.1, TLSv1.2, TLSv1.3. Para obter mais informações, consulte Configurando a criptografia do TLS para o terminal do agente.

Tipo de problema de monitoramento: solaris_jspawnhelper_executable_issue

Este problema de monitoramento indica que o arquivo jspawnhelper ` JVM ` no servidor ` Solaris ` não possui permissão de execução.

Para corrigir o problema de permissão do arquivo Solaris JVM, conceda permissão de execução ao arquivo jspawnhelperJVM, localizado no caminho JVM, usando o seguinte comando:

chmod +x <jvm-path>/jspawnhelper
 

No Java 9 ou versões posteriores, especifique o caminho do ` JVM ` como *instanaAgentDir*/jvm/jre/lib/jspawnhelper. Para versões anteriores do ` Java `, especifique o caminho ` JVM ` como *instanaAgentDir*/jvm/jre/lib/sparcv9/jspawnhelper.