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 precisar 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 de 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 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. Se um resultado for truncado, um ícone de aviso será exibido. A descrição do aviso é exibida ao passar o mouse sobre ele. 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 sobre ele. Caso "Personalizado em caso de falha" esteja 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. Se um resultado for truncado, um ícone de aviso será exibido. A descrição do aviso é exibida ao passar o mouse sobre ele. 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 anterior e uma hora anterior opcionais podem ser especificados. O server responde com os resultados de 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 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 agent selecionada do host
- Os valores devem ser preenchidos manualmente para itens de template
- Os valores de macros em texto simples são resolvidos
- Quando o valor do campo (ou parte do valor) for uma macro secreta ou de Vault, o campo ficará vazio e deverá ser preenchido manualmente. Se algum 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 ficam 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 ficam desabilitados para itens calculados)
- Clique em Obter valor e testar para testar o pré-processamento
Se você tiver especificado um mapeamento de valores no formulário de configuração do item (campo 'Mostrar valor'), a caixa de diálogo de teste do item mostrará outra linha após o resultado final, chamada 'Resultado com mapa de valores aplicado'.
Parâmetros específicos para obter um valor real de um host:
| Parameter | Description |
|---|---|
| Obter valor do host | Marque esta caixa de seleção para obter um valor real do host. |
| Endereço do host | Insira o endereço do host. Este campo é preenchido automaticamente com o endereço da interface do host do item. |
| Porta | Insira a porta do host. Este campo é preenchido automaticamente com a porta da interface do host do item. |
| Campos adicionais para interfaces SNMP (versão SNMP, comunidade SNMP, nome de contexto etc.) |
Consulte Configurando monitoramento SNMP 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). |
| Valor | 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 512 KB 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 512 KB ainda são processados integralmente pelo Zabbix server. |
Para os demais parâmetros, consulte Testando valor hipotético acima.