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}, esses macros são usados diretamente nos prototypes. Se não contiverem, ou se forem necessários macros adicionais/personalizados, os macros podem ser definidos manualmente e mapeados 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. Vá para 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, representando, da esquerda para a direita, o fluxo de dados durante a descoberta:

• Regra de descoberta - especifica, principalmente, o item integrado ou script personalizado para recuperar os dados de descoberta.
• Pré-processamento - aplica algum pré-processamento aos dados descobertos.
• Macros LLD - permite extrair alguns valores de macro para uso em itens descobertos, triggers etc.
• Filtros - permite filtrar os valores descobertos.
• Substituições - permite modificar itens, triggers, gráficos ou protótipos de host ao aplicar a objetos descobertos específicos.

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

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

Preprocessamento

A aba Preprocessamento permite definir regras de transformação a serem aplicadas ao resultado da descoberta. Uma ou várias transformações são possíveis nesta etapa. As transformações são executadas na ordem em que são definidas. Todo o preprocessamento é feito pelo Zabbix server.

Veja também:

• Detalhes de preprocessamento
• Teste de preprocessamento

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

Macros personalizados

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

Macros personalizados são úteis em casos em que o JSON retornado não possui as macros necessárias já definidas. Por exemplo:

• A chave nativa vfs.fs.discovery para descoberta de sistema de arquivos retorna um JSON com algumas LLD macros predefinidas, como {#FSNAME}, {#FSTYPE}. Essas macros podem ser usadas diretamente em protótipos de item, trigger (veja as seções subsequentes da 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 nenhuma LLD macro predefinida. Nesse caso, você pode definir as macros manualmente e mapeá-las 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 realizadas até o momento.

Filtro

Um filtro pode ser usado para gerar itens, triggers e gráficos reais apenas para entidades que correspondam aos critérios. A aba Filters contém definições de filtro da regra de descoberta, permitindo filtrar valores de descoberta:

Por exemplo, se você estiver interessado apenas nos sistemas de arquivos C:, D: e E:, você pode colocar {#FSNAME} no campo Macro e ^C|^D|^E no campo Regular expression.
A filtragem também é possível por tipos de sistema de arquivos usando a macro {#FSTYPE} (por exemplo, ^ext|^reiserfs) e por tipos de unidade (suportado apenas pelo agent do Windows) 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

Override

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

Os overrides, se houver, são exibidos em uma lista reordenável por arrastar e soltar e são executados na ordem em que foram definidos. Para configurar os detalhes de um novo override, clique em no bloco Overrides. Para editar um override existente, clique no nome do override. Uma janela pop-up será aberta, permitindo editar os detalhes da regra de override.

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 Operations. Para editar uma operação existente, clique em ao lado da operação. Uma janela pop-up será aberta para editar os detalhes da operação.

Parameter			Description
Object			Quatro tipos de objetos estão disponíveis: Protótipo de item Protótipo de trigger Protótipo de gráfico Protótipo de host
Condition			Permite filtrar as entidades às quais a operação deve ser aplicada.
	Operator		Operadores suportados: equals - aplicar a este protótipo does not equal - aplicar a todos os protótipos, exceto este contains - aplicar se o nome do protótipo contiver esta string does not contain - aplicar se o nome do protótipo não contiver esta string matches - aplicar se o nome do protótipo corresponder à expressão regular does not match - aplicar se o nome do protótipo não corresponder à expressão regular
	Pattern		Uma expressão regular ou uma string a ser pesquisada.
	Object: Item prototype
		Create enabled	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de item: Yes - o item será adicionado em estado habilitado. No - o item será adicionado a uma entidade descoberta, mas em estado desabilitado.
		Discover	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de item: Yes - o item será adicionado. No - o item não será adicionado.
		Update interval	Quando a caixa de seleção é marcada, duas opções aparecem, permitindo definir um intervalo diferente para o item: Delay - 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 suportados (o suporte a macros de LLD foi restaurado no Zabbix 7.0.27). Deve ser definido como 0 se Custom interval for usado. Custom interval - clique em para especificar intervalos flexíveis/agendados. Para informações detalhadas, consulte Custom intervals.
		History	Quando a caixa de seleção é marcada, os botões aparecem, permitindo definir um período diferente de armazenamento de histórico para o item: Do not store - se selecionado, o histórico não será armazenado. Store up to - 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 suportadas (o suporte a macros de LLD foi restaurado no Zabbix 7.0.27).
		Trends	Quando a caixa de seleção é marcada, os botões aparecem, permitindo definir um período diferente de armazenamento de tendências para o item: Do not store - se selecionado, as tendências não serão armazenadas. Store up to - 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 suportadas (o suporte a macros de LLD foi restaurado no Zabbix 7.0.27).
		Tags	Quando a caixa de seleção é marcada, um novo bloco aparecerá, permitindo especificar pares de tag-valor. Macros de usuário e macros de LLD são suportadas. Essas tags serão anexadas às tags especificadas no protótipo de item, mesmo que os nomes das tags coincidam.
	Object: Trigger prototype
		Create enabled	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de trigger: Yes - o trigger será adicionado em estado habilitado. No - o trigger será adicionado a uma entidade descoberta, mas em estado desabilitado.
		Discover	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de trigger: Yes - o trigger será adicionado. No - o trigger não será adicionado.
		Severity	Quando a caixa de seleção é marcada, os botões de severidade do trigger aparecerão, permitindo modificar a severidade do trigger.
		Tags	Quando a caixa de seleção é marcada, um novo bloco aparecerá, permitindo especificar pares de tag-valor. Macros de usuário e macros de LLD são suportadas. Essas tags serão anexadas às tags especificadas no protótipo de trigger, mesmo que os nomes das tags coincidam.
	Object: Graph prototype
		Discover	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de gráfico: Yes - o gráfico será adicionado. No - o gráfico não será adicionado.
	Object: Host prototype
		Create enabled	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de host: Yes - o host será criado em estado habilitado. No - o host será criado em estado desabilitado.
		Discover	Quando a caixa de seleção é marcada, os botões aparecem, permitindo substituir as configurações originais do protótipo de host: Yes - o host será descoberto. No - o host não será descoberto.
		Link templates	Quando a caixa de seleção é marcada, um campo de entrada para especificar templates aparecerá. Comece a digitar o nome do template ou clique em Select ao lado do campo e selecione templates na lista em uma janela pop-up. Os templates deste override 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 aparecerá, permitindo especificar pares de tag-valor. Macros de usuário e macros de LLD são suportadas. Essas tags serão anexadas às tags especificadas no protótipo de host, mesmo que os nomes das tags coincidam.
		Host inventory	Quando a caixa de seleção é marcada, os botões aparecerão, permitindo selecionar um modo diferente de inventário para o protótipo de host: Disabled - não preencher o inventário do host Manual - fornecer os detalhes manualmente Automated - preencher automaticamente os dados do inventário do host com base nas métricas coletadas.

Botões do formulário

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

	Adiciona uma regra de descoberta. Este botão está disponível apenas para novas regras de descoberta.
	Atualiza as propriedades de uma regra de descoberta. Este botão está disponível apenas para regras de descoberta existentes.
	Cria outra regra de descoberta com base nas propriedades da regra de descoberta atual.
	Executa a descoberta com base na regra de descoberta imediatamente. A regra de descoberta já deve existir. Veja mais detalhes. Nota que ao executar 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.
	Testa 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 quaisquer alterações.
	Exclui a regra de descoberta.
	Cancela 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.