6 Marcação

Visão geral

Há uma opção para adicionar tags a várias entidades no Zabbix. As tags podem ser definidas para:

  • templates
  • hosts
  • itens
  • web scenarios
  • triggers
  • serviços
  • itens e triggers de template
  • protótipos de hosts, itens e triggers

As tags possuem várias utilidades, principalmente para marcar eventos. Se as entidades forem marcadas com tags, os novos eventos correspondentes serão marcados da seguinte forma:

  • com templates marcados - qualquer problema do host criado por entidades relevantes (itens, triggers, etc.) deste template será marcado
  • com hosts marcados - qualquer problema do host será marcado
  • com itens e cenários web marcados - qualquer dado/problema desse item ou cenário web será marcado
  • com triggers marcados - qualquer problema desse trigger será marcado

Um evento de problema herda todas as tags da cadeia completa de templates, hosts, itens, cenários web e triggers. Combinações idênticas de tag:value (após a resolução de macros) são mescladas em uma única ocorrência, evitando duplicação ao marcar o evento.

O uso de tags personalizadas de eventos oferece maior flexibilidade. Importante destacar que os eventos podem ser correlacionados correlated com base nas tags. Em outros usos, ações podem ser definidas com base em eventos marcados. Problemas de itens podem ser agrupados com base em tags. Tags de problemas também podem ser usadas para mapear problemas em services.

O sistema de tags é realizado como um par de nome da tag e valor. Você pode usar apenas o nome ou combiná-lo com um valor:

MySQL, Service:MySQL, Services, Services:Customer, Applications, Application:Java, Priority:High 
Copy
✔ Copied

Uma entidade (template, host, item, cenário web, trigger ou evento) pode ser marcada com o mesmo nome, mas valores diferentes – essas tags não serão consideradas “duplicadas”. Da mesma forma, uma tag sem valor e a mesma tag com valor podem ser usadas simultaneamente.

Casos de uso

Alguns casos de uso para essa funcionalidade são os seguintes:

  1. Marcar eventos de trigger no frontend:
    • Defina uma tag no nível do trigger, por exemplo, scope:performance;
    • Todos os problemas criados por esse trigger serão marcados com essa tag.
  2. Marcar todos os problemas herdados do template:
    • Defina uma tag no nível do template, por exemplo, target:MySQL;
    • Todos os problemas do host criados por triggers desse template serão marcados com essa tag.
  3. Marcar todos os problemas do host:
    • Defina uma tag no nível do host, por exemplo, service:Jira;
    • Todos os problemas dos triggers do host serão marcados com essa tag.
  4. Agrupar itens relacionados:
    • Defina uma tag no nível do item, por exemplo, component:cpu;
    • Na seção Últimos dados, use o filtro de tags para visualizar todos os itens com a tag component:cpu.
  5. Identificar problemas em arquivos de log e encerrá-los separadamente:
    • Defina tags no trigger de log que identificam eventos usando extração de valores com a macro {{ITEM.VALUE<N>}.regsub()};
    • Na configuração do trigger, ative o modo de geração de múltiplos eventos de problema;
    • Na configuração do trigger, use a event correlation:
      selecione a opção para que o evento OK encerre apenas eventos correspondentes e escolha a tag para correspondência.
  • Veja os eventos de problema criados com uma tag e encerrados individualmente.
  1. Usar para filtrar notificações:
    • Defina tags no nível do trigger para marcar eventos com diferentes tags;
  • Use o filtro de tags nas condições de ações para receber notificações apenas dos eventos que correspondam aos dados das tags.
  1. Usar informações extraídas do valor do item como valor da tag:
    • Use uma macro {{ITEM.VALUE<N>}.regsub()} no valor da tag;
    • Veja os valores de tags em MonitoramentoProblemas como dados extraídos do valor do item.
  2. Identificar melhor os problemas em notificações:
    • Defina tags no nível do trigger;
    • Use uma macro {EVENT.TAGS} na notificação de problema;
    • Identifique mais facilmente a qual aplicação/serviço a notificação pertence.
  3. Simplificar tarefas de configuração usando tags no nível do template:
    • Defina tags no nível dos triggers do template;
    • Veja essas tags em todos os triggers criados a partir dos triggers do template.
  4. Criar triggers com tags a partir da descoberta de baixo nível (LLD):
    • Defina tags nos protótipos de trigger;
    • Use macros do LLD no nome ou valor da tag;
    • Veja essas tags em todos os triggers criados a partir dos protótipos de trigger.
  5. Relacionar serviços usando service tags:
  6. Mapear serviços para problemas usando problem tags:
    • Na configuração do serviço, especifique a tag de problema problem tag, por exemplo target:MySQL;
    • Problemas com a tag correspondente serão automaticamente correlacionados ao serviço;
    • O status do serviço mudará para o status do problema com a maior gravidade.
  7. Suprimir problemas quando um host estiver em modo de manutenção:
    • Defina as tags em Períodos de manutenção Maintenance periods para suprimir apenas problemas com tags correspondentes.
  8. Conceder acesso a grupos de usuários:
    • Especifique tags na configuração do grupo de usuário user group para permitir a visualização apenas dos problemas com tags correspondentes.

Configuração

As tags podem ser inseridas em uma guia dedicada, por exemplo, no gatilho configuração:

Suporte a macros

As macros integradas e definidas pelo usuário em tags são resolvidas no momento do evento. Até que o evento ocorra, essas macros serão exibidas na interface do Zabbix como não resolvidas. Macros de descoberta de baixo nível (LLD) são resolvidas durante o processo de descoberta.

As seguintes macros podem ser usadas em tags de trigger:

  • as macros {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} e {HOST.ID} podem ser usadas para preencher o nome ou valor da tag.
  • as macros {INVENTORY.*} macros podem ser usadas para referenciar valores de inventário do host a partir de um ou vários hosts em uma expressão de trigger.
  • as macros de usuários User macros e macros de usuários com contexto são suportadas para o nome/valor da tag;
    o contexto pode incluir macros de descoberta de baixo nível.
  • as macros de descoberta de baixo nível podem ser usadas para o nome/valor da tag em protótipos de trigger.

As seguintes macros podem ser usadas em notificações baseadas em triggers:

  • as macros {EVENT.TAGS} e {EVENT.RECOVERY.TAGS} resolvem para uma lista separada por vírgulas de tags de evento ou tags de eventos de recuperação
  • as macros {EVENT.TAGSJSON} e {EVENT.RECOVERY.TAGSJSON} resolvem para um array JSON contendo objects ou objetos de tags de eventos de recuperação.

As seguintes macros podem ser usadas em tags de templates, hosts, itens e cenários da web:

  • as macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} e {HOST.ID}
  • {INVENTORY.*} macros
  • macros de usuários User macros
  • as macros de descoberta de baixo nível podem ser usadas em tags de protótipos de itens.

As seguintes macros podem ser usadas em tags de protótipos de host:

  • as macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} e {HOST.ID}
  • {INVENTORY.*} macros
  • macros de usuário User macros
  • as macros de descoberta de baixo nível Low-level discovery macros serão resolvidas durante o processo de descoberta e, em seguida, adicionadas ao host descoberto.
Extração de substrings em tags de trigger

A extração de substrings é suportada para preencher o nome ou valor da tag, utilizando uma função de macro function - aplicando uma expressão regular ao valor obtido pela macro {ITEM.VALUE}, {ITEM.LASTVALUE} ou por uma macro de descoberta de baixo nível (LLD). Por exemplo:

{{ITEM.VALUE}.regsub(pattern, output)}
       {{ITEM.VALUE}.iregsub(pattern, output)}
       
       {{#LLDMACRO}.regsub(pattern, output)}
       {{#LLDMACRO}.iregsub(pattern, output)}
Copy
✔ Copied

O nome e o valor da tag serão truncados para 255 caracteres se o comprimento exceder esse limite após a resolução da macro.

Veja também: Usando funções de macro em macros de descoberta de baixo nível low-level discovery macros para marcação de eventos.

Visualizando tags de eventos

As tags, se definidas, podem ser visualizadas com novos eventos em:

  • MonitoramentoProblemas
  • MonitoramentoProblemasDetalhes do evento
  • MonitoramentoPainel → Widget Problemas

Apenas as três primeiras entradas de tags são exibidas. Se houver mais de três entradas, isso é indicado por três pontos. Ao passar o mouse sobre esses pontos, todas as entradas de tags são exibidas em uma janela pop-up.

Observe que a ordem de exibição das tags é afetada pelo filtro de tags e pela opção Prioridade de exibição de tags no filtro de MonitoramentoProblemas ou no widget Problemas do painel.

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.