InstanaPCP e os contadores de desempenho do ` Windows `

Editar online

No ` Windows `, o aplicativo ` InstanaPCP ` é iniciado automaticamente quando o agente é iniciado. O aplicativo " InstanaPCP " realiza as seguintes ações:

  • Configura o ambiente para o rastreio automático de aplicativos hospedados pelo IIS
  • Coleta métricas para processos em execução (como GC e CPU) e os envia ao agente.
  • Envia uma lista dos processos em execução no host Windows para o agente.
  • Coleta métricas do contador de desempenho customizado definidas no arquivo configuration.yaml .

Contadores de Desempenho

Editar online

Instana suporta dois métodos para coletar processos e suas métricas de um host Windows.

O primeiro método (método padrão) :

Quando o ` InstanaPCP ` é iniciado, ele cria uma ProcessNameFormat configuração com o valor 2 no Registro. Esta configuração altera o formato do nome do processo de processname para processname_processid nos seguintes caminhos do Registro:

  1. HKLM:\SYSTEM\CurrentControlSet\Services\.NETFramework\Performance
  2. HKLM:\SYSTEM\CurrentControlSet\Services\PerfProc\Performance

O segundo método :

Este método utiliza uma lógica reformulada e não requer a alteração do formato do nome do processo. Para usar esse método, defina a variável INSTANA_COLLECT_METRICS_BY_PROCESS_READING de ambiente como ou 1true no nível do host. Esse método oferece maior flexibilidade, pois não altera o formato do nome do processo, e será a opção padrão e a única suportada no futuro.

Contadores de desempenho customizados

Editar online

Instana suporta o monitoramento de contadores de desempenho personalizados. Os contadores de desempenho customizados são desativados por padrão.. Para ativar contadores de desempenho customizados, atualize o arquivo configuration.yaml conforme mostrado no exemplo a seguir:

com.instana.plugin.perfcounters:
  enabled: true

Os contadores de desempenho são definidos com quatro valores e nomes diferentes Os contadores de desempenho são agrupados por categoria Eles podem ser ligados a uma instância específica ou são do host. Para descrever exclusivamente um contador, uma sintaxe semelhante ao exemplo a seguir é usada:

[host]\[category]([instance])\[counter name]

instance pode ser opcional dependendo do contador. O contador a seguir é um exemplo:

\Processor Information(_Total)\% Processor Time

Os atributos do contador no exemplo são explicados na lista a seguir:

  • host está vazio.. O contador é do host atual (localhost).
  • category é Informações do processador.
  • instance é _Total.
  • counter name é % de Tempo do Processador

Instana suporta apenas consultas a localhost contadores.

Algumas categorias são somente de host; instance não está definido para essas categorias. O exemplo a seguir mostra uma categoria de host inteiro:

\System\Processor Queue Length

Após a sinalização ser ativada, defina os contadores que você deseja monitorar. Atualize a configuração conforme mostrado no exemplo a seguir:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: [name of the counters category]
      instance: [instance name]
      counters:
        - [name of the counter]

A saída a seguir mostra valores de amostra para contadores:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: Processor Information
      instance: _Total
      counters:
        - "% Processor Time"
Nota: o nome do contador é colocado entre aspas duplas (") devido ao caractere especial %_

Se você precisar de mais contadores por categoria, apenas inclua-os na matriz counters , conforme mostrado no exemplo a seguir:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: Memory
      counters:
        - Page Faults/sec
        - Cache Faults/sec
        - Page Reads/sec
Nota: O não instance está definido neste exemplo porque a categoria Memória abrange todo o host.
Observação: a consulta a contadores de desempenho é uma operação inerentemente dispendiosa. Se você tiver muitos contadores, isso impactará o desempenho do agente.

O exemplo a seguir mostra várias categorias e contadores:

com.instana.plugin.perfcounters:
  enabled: true
  counters:
    - category: System
      counters:
        - Processor Queue Length
        - System Calls/sec
    - category: Process
      instance: _Total
      counters:
        - Private bytes
        - Working Set
        - Thread Count
    - category: Memory
      counters:
        - Page Faults/sec
        - Cache Faults/sec
        - Page Reads/sec
    - category: .NET CLR Exceptions
      instance: _Global_
      counters:
        - "# of Exceps Thrown / sec"
        - "# of Pinned Objects"

O exemplo a seguir mostra um painel do host com contadores de desempenho:

Figura 1. Exemplo de painel de contadores de desempenho
Exemplo do painel Contadores de Desempenho

Para obter mais assistência, abra um caso de suporte

Resolução de problemas

Editar online

Se você encontrar quaisquer outros problemas, entre em contato com o Suporte IBM

InstanaPCP não em execução

Editar online

Tipo de problema de monitoramento: clr_instana_pcp_not_running

Você pode localizar a mensagem de aviso InstanaPCP does not seem to be running no log de seu agente Essa mensagem é exibida quando o agente falha ao interagir com o InstanaPCP O agente inicia InstanaPCP no início do processo de autoinicialização e, em seguida, o agente pode se comunicar com InstanaPCP. O agente não poderá iniciar o InstanaPCP antecipadamente no processo de autoinicialização se ocorrer qualquer um dos erros a seguir:

  • O agente não está em execução com privilégios suficientes (não executando como Sistema Local ou Administrador).
  • A versão do `.NET Framework ` no servidor não é compatível. Só são compatíveis as versões .NET Framework, 4.5.1 e posteriores.
  • InstanaPCP reiniciado devido ao consumo excessivo de memória.

Se essa mensagem aparecer repetidamente, conclua as seguintes verificações:

  1. Verifique se o usuário que executa o agente possui privilégios administrativos locais Se o usuário não tiver privilégios administrativos locais, conceda privilégios administrativos locais para o usuário ou use uma conta de usuário diferente Ao instalar o agente do Instana a partir do pacote de instalação, o serviço é normalmente executado como “Sistema Local”, o que lhe confere privilégios suficientes.

  2. Verifique a versão do .NET Framework instalada no seu computador. O pacote de instalação do ` Windows ` instala automaticamente a versão mínima do `.NET Framework ` necessária para o ` InstanaPCP `. No entanto, se você instalar o agente do host a partir de um arquivo ZIP, talvez seja necessário instalar o .NET Framework. Se você não tiver certeza se possui a versão correta do `.NET Framework `, acesse o site \system\com\instana\agent-windows-extensions<latest>\agent-windows-extensions--<latest> directorye, em seguida, execute manualmente o ` InstanaPCP ` como um programa de instalação independente a partir da linha de comando. Se você não tiver a versão correta do .NET Framework instalada, será exibida uma mensagem.

  3. Verifique se você vê mensagens que estão relacionadas ao consumo excessivo no log da seguinte forma:

    InstanaPCP.exe Private-Bytes is above warning-treshhold for XXX times now

Killing InstanaPCP.exe for excessive memory-usage. Possible memory-leak in native Windows-Libraries.

Essas mensagens serão exibidas se ocorrer qualquer um dos seguintes problemas:

  • No servidor Windows, onde o InstanaPCP está em execução, a versão do IIS é anterior à 7 e ocorreu um vazamento de memória. Este vazamento pode ser corrigido instalando uma atualização da Microsoft. Esse problema pode ocorrer em máquinas Windows 2008. Antes de instalar esta atualização da Microsoft, entre em contato com o Suporte da IBM para verificar se ocorreu algum vazamento de memória no seu computador. A equipe de suporte da IBM pode fornecer o link para atualizar seu pacote da Microsoft.

  1. Muitas aplicações do .NET estão em execução no servidor, e essas aplicações estão gerando muitos registros. Aumente os limites de memória do ` InstanaPCP ` aplicando alterações nas seguintes configurações no arquivo do configuration.yaml seu agente:

    com.instana.plugin.clr:
  pcp_warn_limit: <MB-treshold before warning>
  pcp_stop_limit: <MB-treshold  to stop / restart the process>

InstanaPCP não conectado

Editar online

Tipo de problema de monitoramento: clr_instana_pcp_not_connected

O agente de host não pode se conectar ao processo do InstanaPCP, o que impede a recuperação e o processamento de dados de rastreio e de métricas de tempo de execução para processos do .NET.

Esse problema geralmente é uma falha temporária, que se resolve rapidamente após a inicialização do InstanaPCP . Se esse problema não for resolvido, entre em contato com o Suporte IBM