1 Teste de pré-processamento

Testando

Testar as etapas de pré-processamento é útil para garantir que pipelines de pré-processamento complexos produzam os resultados esperados, sem esperar que o valor do item seja recebido e pré-processado.

É possível testar:

• contra um valor hipotético
• contra um valor real de um host

Cada etapa de pré-processamento pode ser testada individualmente, assim como todas as etapas podem ser testadas juntas. Ao clicar no botão Testar ou Testar todas as etapas respectivamente no bloco Ações, uma janela de teste é aberta.

Testando valor hipotético

Parâmetro	Descrição
Obter valor do host	Se você deseja testar um valor hipotético, deixe esta caixa de seleção desmarcada. Veja também: Testando valor real.
Valor	Insira o valor de entrada para testar. Clicar no campo do parâmetro ou no botão de visualizar/editar abrirá uma janela de área de texto para inserir o valor ou bloco de código.
Não suportado	Marque esta caixa de seleção para testar um valor não suportado. Esta opção é útil para testar a etapa de pré-processamento Verificar valor não suportado.
Erro	Insira o texto do erro. Este campo é habilitado quando Obter valor do host está desmarcado, mas Não suportado está marcado. Se Obter valor do host estiver marcado, este campo será preenchido com a mensagem de erro real (somente leitura) do host.
Hora	A hora do valor de entrada é exibida: agora (somente leitura).
Valor anterior	Insira um valor de entrada anterior para comparar. Somente para as etapas de pré-processamento Change e Throttling.
Hora anterior	Insira a hora do valor de entrada anterior para comparar. Somente para as etapas de pré-processamento Change e Throttling. O valor padrão é baseado no valor do campo 'Intervalo de atualização' do item (se '1m', então este campo é preenchido com agora-1m). Se nada for especificado ou o usuário não tiver acesso ao host, o padrão é agora-30s.
Macros	Se houver macros usadas, elas são listadas junto com seus valores. Os valores são editáveis para fins de teste, mas as alterações só serão salvas no contexto do teste.
Sequência de fim de linha	Selecione a sequência de fim de linha para valores de entrada multilinha: LF - sequência LF (line feed) CRLF - sequência CRLF (carriage-return line-feed).
Etapas de pré-processamento	As etapas de pré-processamento são listadas; o resultado do teste é exibido para cada etapa após o botão Testar ser clicado. Os resultados dos testes são truncados para um tamanho máximo de 512KB quando enviados para o frontend. Os resultados dos testes podem ser copiados (não mais do que os 512KB truncados). Se um resultado for truncado, um ícone de aviso será exibido. A descrição do aviso é exibida ao passar o mouse. Observe que dados maiores que 512KB ainda são processados totalmente pelo Zabbix server. Se a etapa falhar no teste, um ícone de erro será exibido. A descrição do erro é exibida ao passar o mouse. Caso "Personalizado em falha" seja especificado para a etapa e essa ação seja executada, uma nova linha aparece logo após a linha da etapa de teste de pré-processamento, mostrando qual ação foi realizada e qual resultado produziu (erro ou valor).
Resultado	O resultado final do teste das etapas de pré-processamento é exibido em todos os casos quando todas as etapas são testadas juntas (quando você clica no botão Testar todas as etapas). O tipo de conversão para o tipo de valor do item também é exibido, por exemplo, Resultado convertido para Numérico (sem sinal). Os resultados dos testes são truncados para um tamanho máximo de 512KB quando enviados para o frontend. O resultado final pode ser copiado (não mais do que os 512KB truncados). Se um resultado for truncado, um ícone de aviso será exibido. A descrição do aviso é exibida ao passar o mouse. Observe que dados maiores que 512KB ainda são processados totalmente pelo Zabbix server.

Clique em Testar para ver o resultado após cada etapa de pré-processamento.

Os valores de teste são armazenados entre as sessões de teste para etapas individuais ou todas as etapas, permitindo que o usuário altere as etapas de pré-processamento ou a configuração do item e, em seguida, retorne à janela de teste sem precisar inserir as informações novamente. Os valores são perdidos ao atualizar a página.

O teste é feito pelo Zabbix server. O frontend envia uma solicitação correspondente ao server e aguarda o resultado. A solicitação contém o valor de entrada e as etapas de pré-processamento (com macros de usuário expandidas). Para as etapas Change e Throttling, um valor e hora anteriores opcionais podem ser especificados. O server responde com os resultados para cada etapa de pré-processamento.

Todos os erros técnicos ou erros de validação de entrada são exibidos na caixa de erro na parte superior da janela de teste.

Testando valor real

Para testar o pré-processamento com um valor real:

• Marque a caixa de seleção Obter valor do host
• Insira ou verifique os parâmetros do host (endereço do host, porta, nome do proxy/sem proxy) e detalhes específicos do item (como comunidade SNMPv2 ou credenciais de segurança SNMPv3). Esses campos são sensíveis ao contexto:
  • Os valores são preenchidos automaticamente quando possível, ou seja, para itens que exigem um agent, obtendo as informações da interface agent selecionada do host
  • Os valores devem ser preenchidos manualmente para itens de template
  • Valores de macros em texto simples são resolvidos
  • Quando o valor do campo (ou parte do valor) for uma macro secreta ou macro do Vault, o campo ficará vazio e deverá ser preenchido manualmente. Se qualquer parâmetro do item contiver um valor de macro secreta, a seguinte mensagem de aviso será exibida: "O item contém macros definidas pelo usuário com valores secretos. Os valores dessas macros devem ser inseridos manualmente."
  • Os campos são desabilitados quando não são necessários no contexto do tipo de item (por exemplo, os campos de endereço do host e proxy são desabilitados para itens calculados)
• Clique em Obter valor e testar para testar o pré-processamento

Se você especificou um mapeamento de valor no formulário de configuração do item (campo 'Exibir valor'), a caixa de diálogo de teste do item mostrará outra linha após o resultado final, chamada 'Resultado com mapa de valor aplicado'.

Parâmetros específicos para obter um valor real de um host:

Parâmetro	Descrição
Obter valor do host	Marque esta caixa para obter um valor real do host.
Endereço do host	Insira o endereço do host. Este campo é preenchido automaticamente pelo endereço da interface do host do item.
Porta	Insira a porta do host. Este campo é preenchido automaticamente pela porta da interface do host do item.
Campos adicionais para interfaces SNMP (Versão SNMP, Comunidade SNMP, Nome do contexto, etc.)	Consulte Configurando monitoramento SNMP para obter detalhes adicionais sobre a configuração de uma interface SNMP (v1, v2 e v3). Esses campos são preenchidos automaticamente a partir da interface do host do item.
Proxy	Especifique o proxy se o host for monitorado por um proxy. Este campo é preenchido automaticamente pelo proxy do host (se houver).
Valor	Valor recuperado do host. Clicar no campo do parâmetro ou no botão de visualizar/editar abrirá uma janela de área de texto do valor ou bloco de código. Os valores são truncados para um tamanho máximo de 512KB e apenas no frontend. Se um resultado for truncado, um ícone de aviso será exibido. A descrição do aviso é exibida ao passar o mouse. Observe que dados maiores que 512KB ainda são processados totalmente pelo Zabbix server.

Para os demais parâmetros, consulte Testando valor hipotético acima.