Fila do ECC do MID Server

A Fila do canal de comunicação externo (ECC) é um ponto de conexão entre uma instância e o MID Server. Os trabalhos que o MID Server precisa executar são salvos nesta fila até que o MID Server esteja pronto para processá-los.

Asynchronous Message Bus

O MID Server assina mensagens publicadas pelo Asynchronous Message Bus (AMB), que notifica o MID Server de que há registros de tarefas pendentes na Fila do ECC. Se houver uma tarefa na Fila do ECC para esse MID Server, o MID Server definirá o status como "Processando". Quando terminar de trabalhar em um trabalho solicitado, o MID Server se reportará à fila do ECC com os resultados.

O MID Server abre uma conexão persistente com a instância por meio do cliente AMB e ouve no canal AMB /mid/server/<mid_sys_id>. Quando um registro de saída é inserido na tabela Fila [ecc_queue], uma mensagem AMB é enviada para o canal do MID Server. O MID Server recebe essa mensagem e imediatamente pesquisa a tabela ecc_queue em busca de trabalho, a menos que o MID Server esteja ocupado e o nível de prioridade da mensagem não seja Interativo.

O MID Server pesquisa a fila do ECC no intervalo regular máximo definido no parâmetro de configuração mid.poll.time (40 segundos por padrão), independentemente da atividade da mensagem AMB. Se o MID estiver ocupado e receber uma mensagem AMB com um nível de prioridade diferente de Interativo, o tempo de pesquisa da fila será alterado para mid.poll.time.standard (5 segundos por padrão). Esta pesquisa da fila do ECC em um intervalo regular é feita caso a conexão AMB seja descartada.

Figura 1. Processo de pesquisa da fila do ECC do MID Server

Nota:

O cliente AMB no MID Server não funciona em todos os ambientes e pode precisar ser desabilitado para evitar problemas de desempenho. Para desabilitar o AMB em seu ambiente, defina o parâmetro mid.disable_amb como verdadeiro. Quando você desabilita o AMB, o MID Server não recebe mais as notificações para cada novo registro de saída da fila do ECC. Para obter mais informações, consulte  mid.poll.time em  Parâmetros do MID Server.

Informações da fila do ECC

Você pode acessar a Fila do ECC navegando em qualquer um destes caminhos:

• Discovery > Saída e Artefatos > Fila do ECC
• Discovery > Agendas de descoberta > {nome da programação} > {Registro de status da descoberta}
• ECC > Fila
• {Registro de status da descoberta} > Fila do ECC

Uma Fila do ECC fornece as seguintes informações:

Campo	Valor de entrada
Agente	O nome do sistema externo de onde ou para o qual esta mensagem é. Se a mensagem for de ou para um MID Server, o nome do agente estará no formato mid.server.xxx, em que xxx é o nome de um MID Server específico.
Tópico	O nome da probe que o MID Server executou. Se você estiver usando um padrão para descoberta, o probe do Horizontal Pattern probe do Horizontal Pattern será exibido.
Nome	O comando real que a probe executou. Por exemplo, se Tópico for SSHCommand, o campo Nome conterá o comando do shell real a ser executado. Se você estiver usando um padrão de descoberta, será exibido o seguinte: Inicializador de padrão: seguido pelo nome do padrão e o número de várias páginas.
Fonte	O endereço IP no qual a descoberta deve ser executada. Algumas probes são executadas em vários endereços IP; nesses casos, este campo contém uma descrição legível.
Resposta para	Este campo opcional contém uma referência (sys_id) à mensagem da Fila do ECC à qual esta mensagem está respondendo. O Discovery faz uso extensivo deste campo para rastrear a hierarquia de mensagens que resultam de um determinado Discovery programado. Clique no ícone de registro do valor neste campo para abrir o registro de Fila do ECC para a atividade que gerou a probe atual ou o registro do sensor.
Fila	Um indicador de se esta mensagem foi uma mensagem de entrada ou uma mensagem de saída.
Estado	O estado do registro da fila do ECC atual. Os estados são atualizados automaticamente.
Processado	A hora em que esta mensagem foi processada.
Criado	A hora em que esta mensagem foi criada.
Sequência	O número de sequência exclusivo desta mensagem. Este valor é gerado automaticamente quando um registro de Fila do ECC é inserido. Seu uso é obsoleto.
Cadeia de caracteres de erro	Uma mensagem de erro, se ocorreu um erro durante o processamento. Este campo ficará oculto no formulário padrão a menos que haja um erro.
Carga	O corpo da mensagem no formato XML. O XML retornado tem uma tag raiz de <results> contendo uma ou mais tags <result> e uma única tag <parameters>. Os parâmetros são simplesmente um eco daqueles enviados para o servidor MID na probe; eles variam de probe para probe, mas em geral eles informam à probe os detalhes do que ela deve fazer e como ela deve se comportar. As tags de resultado são as mais interessantes: elas contêm os dados reais gerados pela probe.

Controles de fila do ECC

O formulário de Fila do ECC contém estes links relacionados:

Link relacionado	Descrição
Executar novamente	Executa a probe novamente. Você pode executar novamente as probes ao encontrar uma descoberta com falha ou outros resultados inesperados.
Ir para item CMDB	Abra o registro de IC do IC que foi atualizado durante a descoberta.
Ir para o sensor	Abra o registro do sensor associado.

Gerenciar conteúdo de fila do ECC para um MID Server

A Fila do ECC permite criar mensagens da Fila do ECC, acessar entradas de log do MID Server e recuperar estatísticas de um registro individual do MID Server.

Antes de Iniciar

Função necessária: administrador, mid_server

Procedimento

1. Envie comandos remotos por meio de um MID Server para um dispositivo host diretamente da Fila do ECC sem executar Descoberta.
   1. Navegue até a Fila do ECC e clique em Novo.
   2. Crie uma mensagem com estas configurações:
      • Agente: o nome do MID Server que executa o comando.
      • Tópico: Comando
      • Nome: o comando real que você deseja processar. Para o Windows, isso é expresso em uma estrutura de linha de comando do DOS. Para o Linux, a estrutura pode ser uma entrada de linha de comando do bash.
      • Fila: Saída
      • Carga: com tags XML apropriadas, você pode especificar o comando aqui em vez de no campo Nome. A vantagem disso é que o comando não é restrito pelo tamanho do campo Nome de 120 caracteres. Use o seguinte formato XML para o comando:

      <parameters>
         <parameter name="name" value="ACTUAL_COMMAND_LINE"/>
      </parameters>

2. Entradas de acesso na Fila do ECC que mostram logs de agent0.log.0 e logs de wrapper.log para um MID Server individual.
   1. Abra um registro de MID Server.
   2. Em Links relacionados, clique em Obter logs de MID, arquivos e despejo de encadeamento.
      Os registros da fila do ECC aparecem na lista usando o seguinte filtro:

      • [Topic] [is] [SystemCommand]
      • [Source] [is] [grabLog]
      • [Agent] [is] [your MID Server]

      Somente as entradas agent0.log.0 e wrapper.log são exibidas. Esses logs também podem ser acessados no caminho do arquivo ~\agent\logs\.

   3. Para abrir uma entrada de log, clique no link na coluna Criado.
3. Acesse o tópico queue.stats para obter informações úteis sobre MID Servers individuais, como dados de uso de memória e CPU.
   1. Abra um registro de MID Server.
   2. Em Links relacionados, clique em Estatísticas MID.
      Os registros da fila do ECC aparecem na lista usando o seguinte filtro:

      • [Topic] [is] [queue.stats]
      • [Agent] [is] [your MID Server]