3 Descoberta de baixo nível

Visão geral

A descoberta em baixo nível (LLD) descobre automaticamente entidades (por exemplo, sistemas de arquivos, interfaces de rede) em um host e cria os itens, triggers e gráficos correspondentes sem configuração manual para cada uma.

Para usar a LLD, você cria uma regra de descoberta que coleta dados JSON descrevendo entidades e prototypes (item, trigger e graph) para cada entidade.

O JSON retornado pela regra deve ser um array de objetos, em que cada objeto representa uma entidade descoberta usando pares chave-valor. Por exemplo, uma regra de descoberta com net.if.discovery pode retornar:

[
  {"{#IFNAME}": "lo"},
  {"{#IFNAME}": "eth0"}
]

Um conjunto correspondente de itens, triggers e gráficos é então criado a partir dos prototypes — um por interface (lo e eth0).

Se os objetos contiverem chaves no formato {#MACRO}, essas macros são usadas diretamente nos prototypes. Caso contrário, ou se forem necessárias macros adicionais/personalizadas, as macros podem ser definidas manualmente e mapeadas para campos JSON usando JSONPath.

A LLD também pode criar hosts (por exemplo, para máquinas virtuais descobertas em um hypervisor) e oferece suporte a regras de descoberta aninhadas para descoberta em vários níveis.

Entidades que não forem mais descobertas podem ser desabilitadas ou excluídas automaticamente.

Configurando a descoberta de baixo nível

Vamos ilustrar a descoberta de baixo nível com base em um exemplo de descoberta de sistema de arquivos.

Para configurar a descoberta, faça o seguinte:

1. Acesse Data collection > Templates ou Hosts.
2. Clique em Discovery na linha do template/host apropriado.

3. Clique em Create discovery rule no canto superior direito da tela.
4. Preencha o formulário da regra de descoberta com os detalhes necessários.

Regra de descoberta

O formulário da regra de descoberta contém cinco abas, que representam, da esquerda para a direita, o fluxo de dados durante a descoberta:

• Regra de descoberta - especifique qual item integrado ou script personalizado deve ser usado para recuperar os dados de descoberta.
• Pré-processamento - aplique algum pré-processamento aos dados descobertos.
• Macros LLD - permita a extração de valores de macros para uso em itens descobertos, triggers etc.
• Filtros - permita a filtragem dos valores descobertos.
• Substituições - permita a modificação de itens, triggers, gráficos ou protótipos de host quando aplicadas a objetos descobertos específicos.

A aba Regra de descoberta contém a chave do item a ser usada para a descoberta (bem como alguns atributos gerais da regra de descoberta):

Todos os campos de entrada obrigatórios são marcados com um asterisco vermelho.

Pré-processamento

A aba Pré-processamento permite definir regras de transformação a serem aplicadas ao resultado da descoberta. Uma ou várias transformações podem ser realizadas nesta etapa. As transformações são executadas na ordem em que são definidas. Todo o pré-processamento é realizado pelo Zabbix server.

Consulte também:

• Detalhes do pré-processamento
• Teste de pré-processamento

Observe que, se a regra de descoberta tiver sido aplicada ao host por meio de um template, o conteúdo desta aba será somente leitura.

Macros personalizados

A aba Macros LLD permite especificar macros personalizados de descoberta de baixo nível.

Os macros personalizados são úteis quando o JSON retornado não contém os macros necessários já definidos. Por exemplo:

• A chave nativa vfs.fs.discovery para descoberta de sistemas de arquivos retorna um JSON com alguns macros LLD predefinidos, como {#FSNAME}, {#FSTYPE}. Esses macros podem ser usados diretamente em protótipos de item e trigger (consulte as seções seguintes desta página); não é necessário definir macros personalizados;
• O item de agent vfs.fs.get também retorna um JSON com dados do sistema de arquivos, mas sem macros LLD predefinidos. Nesse caso, você pode definir os macros manualmente e mapeá-los para os valores no JSON usando JSONPath:

Os valores extraídos podem ser usados em itens descobertos, triggers etc. Observe que os valores serão extraídos do resultado da descoberta e de todas as etapas de pré-processamento executadas até o momento.

Filtro

Um filtro pode ser usado para gerar itens, triggers e gráficos reais somente para entidades que correspondam aos critérios.
A aba Filtros contém definições de filtros de regras de descoberta que permitem filtrar valores de descoberta:

Por exemplo, se você estiver interessado apenas nos sistemas de arquivos C:, D: e E:, poderá inserir {#FSNAME} no campo Macro e ^C|^D|^E no campo Expressão regular.
Também é possível filtrar por tipos de sistema de arquivos usando a macro {#FSTYPE} (por exemplo, ^ext|^reiserfs) e por tipos de unidade (compatível somente com o Windows agent) usando a macro {#FSDRIVETYPE} (por exemplo, fixed).

Para testar uma expressão regular, você pode usar grep -E, por exemplo:

for f in ext2 nfs reiserfs smbfs; 
do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; 
done

Substituição

A aba Substituições permite definir regras para modificar a lista de protótipos de item, trigger, gráfico, host e descoberta, ou seus atributos, para objetos descobertos que atendam a determinados critérios.

As substituições, se houver, são exibidas em uma lista reordenável por arrastar e soltar e executadas na ordem em que são definidas. Para configurar os detalhes de uma nova substituição, clique em no bloco Substituições. Para editar uma substituição existente, clique no nome da substituição. Uma janela pop-up será aberta, permitindo editar os detalhes da regra de substituição.

Todos os parâmetros obrigatórios são marcados com asteriscos vermelhos.

Configurando uma operação

Para configurar os detalhes de uma nova operação, clique em no bloco Operações. Para editar uma operação existente, clique em ao lado da operação. Uma janela pop-up será aberta, permitindo editar os detalhes da operação.

Parâmetro			Descrição
Objeto			Cinco tipos de objetos estão disponíveis: Protótipo de item Protótipo de trigger Protótipo de gráfico Protótipo de host Protótipo de descoberta
Condição			Permite filtrar as entidades às quais a operação deve ser aplicada.
	Operador		Operadores compatíveis: é igual a - aplicar a este protótipo não é igual a - aplicar a todos os protótipos, exceto este contém - aplicar se o nome do protótipo contiver esta string não contém - aplicar se o nome do protótipo não contiver esta string corresponde - aplicar se o nome do protótipo corresponder à expressão regular não corresponde - aplicar se o nome do protótipo não corresponder à expressão regular
	Padrão		Uma expressão regular ou uma string a ser pesquisada.
	Objeto: Protótipo de item
		Criar habilitado	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de item: Sim - o item será adicionado em um estado habilitado. Não - o item será adicionado a uma entidade descoberta, mas em um estado desabilitado.
		Descobrir	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de item: Sim - o item será adicionado. Não - o item não será adicionado.
		Intervalo de atualização	Quando a caixa de seleção é marcada, duas opções aparecem, permitindo definir um intervalo diferente para o item: Atraso - intervalo de atualização do item. Macros de usuário, macros de LLD e sufixos de tempo (por exemplo, 30s, 1m, 2h, 1d) são compatíveis (o suporte a macros de LLD foi restaurado no Zabbix 7.4.11). Deve ser definido como 0 se Intervalo personalizado for usado. Intervalo personalizado - clique em para especificar intervalos flexíveis/de agendamento. Para obter informações detalhadas, consulte Intervalos personalizados.
		Histórico	Quando a caixa de seleção é marcada, os botões aparecem, permitindo definir um período de armazenamento de histórico diferente para o item: Não armazenar - se selecionado, o histórico não será armazenado. Armazenar por até - se selecionado, um campo de entrada para especificar o período de armazenamento aparecerá à direita. Macros de usuário e macros de LLD são compatíveis (o suporte a macros de LLD foi restaurado no Zabbix 7.4.11).
		Tendências	Quando a caixa de seleção é marcada, os botões aparecem, permitindo definir um período de armazenamento de tendências diferente para o item: Não armazenar - se selecionado, as tendências não serão armazenadas. Armazenar por até - se selecionado, um campo de entrada para especificar o período de armazenamento aparecerá à direita. Macros de usuário e macros de LLD são compatíveis (o suporte a macros de LLD foi restaurado no Zabbix 7.4.11).
		Tags	Quando a caixa de seleção é marcada, um novo bloco aparece, permitindo especificar pares de tag e valor. Macros de usuário e macros de LLD são compatíveis. Essas tags serão anexadas às tags especificadas no protótipo de item, mesmo que os nomes das tags sejam iguais.
	Objeto: Protótipo de trigger
		Criar habilitado	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de trigger: Sim - o trigger será adicionado em um estado habilitado. Não - o trigger será adicionado a uma entidade descoberta, mas em um estado desabilitado.
		Descobrir	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de trigger: Sim - o trigger será adicionado. Não - o trigger não será adicionado.
		Severidade	Quando a caixa de seleção é marcada, os botões de severidade do trigger aparecem, permitindo modificar a severidade do trigger.
		Tags	Quando a caixa de seleção é marcada, um novo bloco aparece, permitindo especificar pares de tag e valor. Macros de usuário e macros de LLD são compatíveis. Essas tags serão anexadas às tags especificadas no protótipo de trigger, mesmo que os nomes das tags sejam iguais.
	Objeto: Protótipo de gráfico
		Descobrir	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de gráfico: Sim - o gráfico será adicionado. Não - o gráfico não será adicionado.
	Objeto: Protótipo de host
		Criar habilitado	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de host: Sim - o host será criado em um estado habilitado. Não - o host será criado em um estado desabilitado.
		Descobrir	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de host: Sim - o host será descoberto. Não - o host não será descoberto.
		Vincular templates	Quando a caixa de seleção é marcada, um campo de entrada para especificar templates aparece. Comece a digitar o nome do template ou clique em Selecionar ao lado do campo e selecione os templates na lista exibida em uma janela pop-up. Os templates desta substituição são adicionados a todos os templates já vinculados ao protótipo de host.
		Tags	Quando a caixa de seleção é marcada, um novo bloco aparece, permitindo especificar pares de tag e valor. Macros de usuário e macros de LLD são compatíveis. Essas tags serão anexadas às tags especificadas no protótipo de host, mesmo que os nomes das tags sejam iguais.
		Inventário do host	Quando a caixa de seleção é marcada, os botões aparecem, permitindo selecionar um modo de inventário diferente para o protótipo de host: Desabilitado - não preencher o inventário do host Manual - fornecer os detalhes manualmente Automatizado - preencher automaticamente os dados do inventário do host com base nas métricas coletadas.
	Objeto: Protótipo de descoberta
		Criar habilitado	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de descoberta: Sim - a regra de descoberta será adicionada em um estado habilitado. Não - a regra de descoberta será adicionada em um estado desabilitado.
		Descobrir	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de descoberta: Sim - a regra de descoberta será adicionada. Não - a regra de descoberta não será adicionada.
		Intervalo de atualização	Quando a caixa de seleção é marcada, duas opções aparecem, permitindo definir um intervalo diferente para a regra de descoberta: Atraso - intervalo de atualização da regra. Macros de usuário, macros de LLD e sufixos de tempo (por exemplo, 30s, 1m, 2h, 1d) são compatíveis. Deve ser definido como 0 se Intervalo personalizado for usado. Intervalo personalizado - clique em para especificar intervalos flexíveis/de agendamento. Para obter informações detalhadas, consulte Intervalos personalizados.

Botões do formulário

Os botões na parte inferior do formulário permitem realizar várias operações.

	Adicionar uma regra de descoberta. Este botão está disponível somente para novas regras de descoberta.
	Atualizar as propriedades de uma regra de descoberta. Este botão está disponível somente para regras de descoberta existentes.
	Criar outra regra de descoberta com base nas propriedades da regra de descoberta atual.
	Realizar a descoberta imediatamente com base na regra de descoberta. A regra de descoberta já deve existir. Consulte mais detalhes. Observação: ao realizar a descoberta imediatamente, o cache de configuração não é atualizado; portanto, o resultado não refletirá alterações muito recentes na configuração da regra de descoberta.
	Testar a configuração da regra de descoberta. Use este botão para verificar as configurações (como conectividade e correção dos parâmetros) sem aplicar permanentemente nenhuma alteração.
	Excluir a regra de descoberta.
	Cancelar a edição das propriedades da regra de descoberta.

Entidades descobertas

As capturas de tela abaixo ilustram como os items, triggers e gráficos descobertos aparecem na configuração do host. As entidades descobertas são prefixadas com um link laranja para a regra de descoberta da qual elas se originam.

Observe que as entidades descobertas não serão criadas caso já existam entidades com os mesmos critérios de exclusividade, por exemplo, um item com a mesma chave ou um gráfico com o mesmo nome. Uma mensagem de erro é exibida neste caso no frontend informando que a regra de descoberta de baixo nível não pôde criar determinadas entidades. A própria regra de descoberta, no entanto, não ficará como não suportada porque alguma entidade não pôde ser criada e teve que ser ignorada. A regra de descoberta continuará criando/atualizando outras entidades.

Se uma entidade descoberta (host, sistema de arquivos, interface, etc) parar de ser descoberta (ou não passar mais no filtro), as entidades que foram criadas com base nela podem ser automaticamente desativadas e eventualmente excluídas.

Recursos perdidos podem ser automaticamente desativados com base no valor do parâmetro Desativar recursos perdidos. Isso afeta hosts, items e triggers perdidos.

Recursos perdidos podem ser automaticamente excluídos com base no valor do parâmetro Excluir recursos perdidos. Isso afeta hosts, grupos de hosts, items, triggers e gráficos perdidos.

Quando as entidades descobertas se tornam 'Não descobertas mais', um indicador de tempo de vida é exibido na lista de entidades. Mova o ponteiro do mouse sobre ele e uma mensagem será exibida indicando os detalhes do status.

Se as entidades foram marcadas para exclusão, mas não foram excluídas no momento esperado (regra de descoberta ou host do item desativado), elas serão excluídas na próxima vez que a regra de descoberta for processada.

Entidades que contêm outras entidades, que estão marcadas para exclusão, não serão atualizadas se forem alteradas no nível da regra de descoberta. Por exemplo, triggers baseados em LLD não serão atualizados se contiverem items que estão marcados para exclusão.

Outros tipos de descoberta

Mais detalhes e tutoriais sobre outros tipos de descoberta prontos para uso estão disponíveis nas seguintes seções:

• descoberta de interfaces de rede
• descoberta de CPUs e núcleos de CPU
• descoberta de OIDs SNMP
• descoberta de objetos JMX;
• descoberta usando consultas SQL ODBC
• descoberta de serviços do Windows
• descoberta de interfaces de host no Zabbix

Para mais detalhes sobre o formato JSON para items de descoberta e um exemplo de como implementar seu próprio descobridor de sistema de arquivos como um script Perl, veja criando regras LLD personalizadas.