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ê quiser 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: now (somente leitura). |
| Valor anterior | Insira um valor de entrada anterior para comparar. Somente para as etapas de pré-processamento Mudança e Limitação. |
| Hora anterior | Insira a hora do valor de entrada anterior para comparar. Somente para as etapas de pré-processamento Mudança e Limitação. O valor padrão é baseado no valor do campo 'Intervalo de atualização' do item (se for '1m', então este campo será preenchido com now-1m). Se nada for especificado ou o usuário não tiver acesso ao host, o padrão será now-30s. |
| Macros | Se alguma macro for usada, ela será listada junto com seus valores. Os valores podem ser editados para fins de teste, mas as alterações serão salvas apenas 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 clicar no botão Testar. Os resultados do teste são truncados para um tamanho máximo de 512KB quando enviados ao frontend. Os resultados do teste podem ser copiados (não mais 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 integralmente 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 caso de falha" seja especificado para a etapa e essa ação seja executada, uma nova linha aparecerá logo após a linha da etapa de teste de pré-processamento, mostrando qual ação foi realizada e qual resultado ela 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 (ao clicar 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 do teste são truncados para um tamanho máximo de 512KB quando enviados ao frontend. O resultado final pode ser copiado (não mais 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 integralmente 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 sessões de teste, seja para etapas individuais ou para todas as etapas, permitindo que o usuário altere as etapas de pré-processamento ou a configuração do item e depois retorne à janela de teste sem precisar reinserir as informações. No entanto, os valores são perdidos ao atualizar a página.
O teste é realizado 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 Mudança e Limitação, um valor e hora anteriores opcionais podem ser especificados. O server responde com 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 Get value from host
- Insira ou verifique os parâmetros do host (endereço do host, porta, nome do proxy/sem proxy) e os 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, usando as informações da interface de agent selecionada do host
- Os valores devem ser preenchidos manualmente para itens de template
- Os valores de macro em texto simples são resolvidos
- Quando o valor do campo (ou parte do valor) é uma macro secreta ou de 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 Get value and test para testar o pré-processamento
Se você tiver especificado um mapeamento de valor no formulário de configuração do item (campo 'Show value'), a janela de teste do item mostrará outra linha após o resultado final, chamada 'Result with value map applied'.
Parâmetros específicos para obter um valor real de um host:
| Parameter | Description |
|---|---|
| Get value from host | Marque esta caixa de seleção para obter um valor real do host. |
| Host address | Insira o endereço do host. Este campo é preenchido automaticamente com o endereço da interface do host do item. |
| Port | Insira a porta do host. Este campo é preenchido automaticamente com a porta da interface do host do item. |
| Additional fields for SNMP interfaces (SNMP version, SNMP community, Context name, etc.) |
Consulte Configuring SNMP monitoring para 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 com o proxy do host (se houver). |
| Value | Valor obtido do host. Clicar no campo do parâmetro ou no botão de visualizar/editar abrirá uma janela de área de texto com o valor ou bloco de código.Os valores são truncados para um tamanho máximo de 512KB e somente 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 integralmente pelo Zabbix server. |
Para os demais parâmetros, consulte Testing hypothetical value acima.