Regras de silenciamento: Suprimir notificação

Alerts envia notificações oportunas quando seu sistema está com problemas. Às vezes você não quer ver algumas notificações conhecidas. Você pode usar muting rules para parar de ser bombardeado por mensagens que não precisam da sua atenção.

Depois de identificar os elementos comuns em suas notificações indesejadas, você pode definir regras de silenciamento que visem especificamente esses elementos, enquanto permitem a passagem de outras notificações. Mesmo quando uma notificação está silenciada, alertasainda coleta dados sobre esses eventos de alerta. As regras de silenciamento não interferem no processo de alertas e são aplicadas no ponto imediatamente anterior ao envio de uma notificação.

Crie uma regra de silenciamento

Para criar uma regra de silenciamento, siga estas etapas:

1. Vá para one.newrelic.com > All capabilities > Alerts e clique em Muting rules no painel de navegação esquerdo.

2. Clique em + Add a rule.

3. Insira um nome e uma descrição (opcional) para a regra de silenciamento e selecione a conta à qual a regra será aplicada.

4. Construa o filtro de eventos de alerta. Você pode usar um subconjunto de atributos de evento de alerta. Escolha um atributo, um operador e um valor. Estes são os atributos: accountId, conditionId, conditionName, conditionType, entity.guid, nrqlEventType, nrqlQuery, policyId, policyName, product,runbookUrl (como conditionRunbookUrl), tags.<NAME> e targetName). Os valores são comparados com um dos atributos de evento de alerta, como um ID de política de alertas ou um nome de condição.

5. Clique em Add another condition se quiser incluir mais filtros.

/* <img title="Tela de edição de regra de silenciamento" alt="Tela de edição de regra de silenciamento" src="/images/alerts_screenshot-crop_violation-filter.webp" /> <figcaption> Vá para <DNT>**[one.newrelic.com > All capabilities](https\://one.newrelic.com/all-capabilities) > Alerts**</DNT> e clique em <DNT>**Muting rules**</DNT> no painel de navegação à esquerda. Você pode criar regras de silenciamento complexas para atingir um conjunto pequeno ou grande de notificações indesejadas. </figcaption> */

Gerenciar regras de silenciamento

Uma condição de regra de silenciamento é o conjunto de expressões individuais compostas por atributos, operadores e valores que definem quais eventos de alerta devem ser silenciados.

Para criar, habilitar, desabilitar e gerenciar regras de silenciamento, siga estas etapas:

1. Vá para one.newrelic.com > All capabilities > Alerts e clique em Muting rules no painel de navegação esquerdo.

2. Habilite ou desabilite regras de silenciamento a qualquer momento na coluna Enabled . Você também pode editar cada regra clicando em ícone na linha de cada regra.

As regras podem ter um dos seguintes status:

• Active: O silenciamento está habilitado e ativo.
• Scheduled: o silenciamento está ativado, mas ainda não está ativo (há uma programação futura).
• Ended: o silenciamento está ativado, mas não está mais ativo (não há programação futura).
• Inactive: O silenciamento está desativado.

/* <img title="Gerenciar regras de silenciamento" alt="Gerenciar regras de silenciamento" src="/images/alerts_screenshot-full_muting-rules.webp" /> <figcaption> Vá para <DNT>**[one.newrelic.com > All capabilities](https\://one.newrelic.com/all-capabilities) > Alerts > Muting rules**</DNT>: Você pode criar regras de silenciamento complexas para direcionar um conjunto pequeno ou grande de notificações indesejadas. </figcaption> */

Opções de notificação para regras de silenciamento

Quando uma regra de silenciamento está ativa e um evento de alerta é aberto, o usuário não receberá uma notificação. Você pode configurar o comportamento das notificações quando uma regra de silenciamento estiver inativa com as duas configurações abaixo:

• Notify: Se houver um evento de alerta em andamento após o término da janela da regra de silenciamento, você será notificado. Isso funciona encerrando o evento de alerta existente e silenciado e, se o limite ainda estiver sendo violado, um novo evento de alerta será aberto em um estado não silenciado, disparando uma notificação. Recomendamos manter esta configuração padrão.

• Suppress notification: Se houver um evento de alerta em andamento após o término da janela da regra de silenciamento, você não será notificado. Isso funciona mantendo o evento de alerta silenciado existente aberto após o carimbo de data/hora de término da janela da regra de silenciamento.

Agende uma regra de silenciamento

Se necessário, você pode agendar suas regras de silenciamento.

Para fazer isso, selecione uma hora de início e uma hora de término. Opcionalmente, você pode definir a regra de silenciamento para durar um dia inteiro.

Você também pode optar por selecionar um fuso horário para a programação da regra de silenciamento. O padrão é o fuso horário selecionado nas preferências do usuário.

Você pode programar suas regras de silenciamento para ocorrerem diariamente, semanalmente ou mensalmente. Uma regra de silenciamento programada para repetição semanal inclui a opção de selecionar os dias da semana para recorrência. Se nenhum dia for selecionado, a recorrência semanal será repetida por padrão no dia da semana em que a regra de silenciamento está programada para iniciar.

Você também pode especificar quando deseja que a recorrência termine selecionando uma data específica ou um determinado número de ocorrências.

Visualizar eventos de alerta e problemas silenciados

Ao visualizar um problema aberto ou fechado, eventos de alerta e problemas são marcados como Muted. Você pode visualizar eventos de alerta e problemas silenciados nos seguintes locais:

• Visualizar um problema silenciado: Vá para one.newrelic.com > All capabilities > Alerts e clique em Issues & Activity no painel de navegação à esquerda. Clique em qualquer problema silenciado para ver detalhes sobre os eventos de alerta crítico que foram silenciados.

• Veja uma lista de eventos de alerta silenciados: Vá para one.newrelic.com > All capabilities > Alerts e clique em Issues & Activity no painel de navegação à esquerda. Em seguida, selecione o alert events tab. Eventos de alerta e problemas silenciados são marcados com o ícone na coluna Muted.

Silenciar resultados facetados usando tags.

Para silenciar os resultados da consulta facetada, use o atributo tags.FACETED_ATTRIBUTE, onde FACETED_ATTRIBUTE representa o atributo que você executou uma consulta NRQL FACET . Por exemplo: se sua condição do alerta NRQL inclui FACET host em sua consulta, você pode destino esse atributo FACET usando tags.host.

A consulta de condição NRQL pode aceitar atributos de múltiplas facetas. Se você deseja filtrar atributo em seu evento ou série temporal métrica que foi agregada, você deve adicionar esses atributo à sua cláusula de consulta NRQL FACET ; por exemplo: FACET host, region, cluster.

Para obter um exemplo de uso de tags., consulte Criar regra de silenciamento.

Operadores de subcondição

Esses são os operadores lógicos que você pode usar para comparar atributo ao adicionar regras de silenciamento. Se você é novo nas regras de silenciamento, veja estes exemplos.

• EQUALS: Onde o valor fornecido é igual ao valor do atributo do evento de alerta.
• DOES_NOT_EQUALS: Onde o valor fornecido não é igual ao valor do atributo do evento de alerta.
• IN: Onde o valor do atributo do evento de alerta está presente em uma lista de valores fornecidos (até 500).
• NOT_IN: Onde o valor do atributo do evento de alerta não está presente em uma lista de valores fornecidos (até 500).
• CONTAINS: Onde a string de valor fornecida está presente no valor do atributo do evento de alerta.
• DOES_NOT_CONTAINS: Onde a string de valor fornecida não está presente no valor do atributo do evento de alerta.
• ENDS_WITH: Onde o valor do atributo do evento de alerta termina com a string de valor fornecida.
• NOT_ENDS_WITH: Onde o valor do atributo do evento de alerta não termina com a string de valor fornecida.
• STARTS_WITH: Onde o valor do atributo do evento de alerta começa com a string de valor fornecida.
• DOES_NOT_STARTS_WITH: Onde o valor do atributo do evento de alerta não começa com a string de valor fornecida.
• IS_BLANK: Onde o valor do atributo do evento de alerta estiver em branco. Nulo, string vazia, etc.
• IS_NOT_BLANK: Onde o valor do atributo do evento de alerta não está em branco. Nulo, string vazia, etc.
• IS_ANY: Uma condição com este operador silenciará todos os eventos de alerta na conta.

Como funcionam as regras de silenciamento

As regras de silenciamento são aplicadas ao final do ciclo de vida padrão do alerta para suprimir ou silenciar notificações. Eles não desativam políticas ou condições existentes. Por exemplo, você pode silenciar notificações durante interrupções conhecidas do sistema, como janelas de manutenção e implantações. Eventos de alerta de interrupção do sistema ainda serão identificados, mesmo que as notificações para esses eventos de alerta estejam silenciadas.

Uma regra de silenciamento usa um conjunto de condições que correspondem a atributos em um evento de alerta. As regras de silenciamento nos dizem como:

• Identifique eventos de alerta individuais após serem criados, mas antes que um problema seja aberto.
• Substitua a condição padrão para indicar que eles devem ser silenciados.

Atualmente, silenciar um evento de alerta significa que o ciclo de vida normal do evento de alerta é mantido, exceto que um problema contendo apenas eventos de alerta silenciados não enviará notificações.

As regras de silenciamento são determinadas pelo primeiro evento que acionou uma notificação dentro de um problema. Isso significa que se o primeiro evento de notificação foi silenciado devido a um estado silenciado, o restante do problema também será silenciado.

As regras de silenciamento sobrepõem eventos de alerta específicos. Não desativam políticas ou condições existentes. Isso permite que você silencie eventos de alerta de entidades específicas que podem ser cobertas por uma política ou condição que abrange um grande número de entidades. Isso também evita que você precise silenciar excessivamente seu monitoramento ao realizar manutenção em um subconjunto do seu sistema.

A tabela a seguir descreve como o ciclo de vida de eventos de alerta é afetado por eventos de alerta silenciados:

Comportamento de silenciamento com fluxo de trabalho

Um evento de alerta acionado tem uma relação de 1:1 com um problema, portanto, se um evento de alerta for silenciado, o problema correspondente também será silenciado. Os fluxos de trabalho são acionados por incidentes que podem ter um ou mais eventos de alerta; portanto, pode haver um cenário de eventos de alerta silenciados e não silenciados combinados.

Cada problema tem um dos seguintes estados de silenciamento:

• Fully muted (FULLY_MUTED): um problema tem todos os seus eventos de alerta abertos silenciados (Valor padrão).
• Partially muted (PARTIALLY_MUTED): um problema que tem pelo menos um evento de alerta aberto silenciado e um evento de alerta aberto não silenciado.
• Not muted (NOT_MUTED): um problema que não possui eventos de alerta silenciados abertos.

Para obter um guia passo a passo sobre como configurar seu fluxo de trabalho, confira um exemplo de demonstração abaixo (aprox. 2:17 minutos):

Comportamento de silenciamento com NerdGraph

No NerdGraph, você pode usar as seguintes consultas e mutações com suas regras de silenciamento. Você pode ver o esquema com mais detalhes no API Explorer.

• actor.account.alerts.mutingRule: Buscar uma regra de silenciamento por ID.
• actor.account.alerts.mutingRules: busque uma lista de regras de silenciamento para uma conta.
• alertsMutingRuleCreate: crie uma regra de silenciamento para uma conta.
• alertsMutingRuleUpdate: Atualizar uma regra de silenciamento por ID e ID da conta.

Você pode encontrar alguns exemplos de consultas e mutações nesta página.

Uma regra de silenciamento possui os seguintes campos e componentes:

Exemplos de silenciamento

Para obter mais informações sobre como fazer solicitações ao NerdGraph, consulte a documentação do NerdGraph, incluindo tutoriais do GraphQL.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        mutingRules {
          name
          condition {
            operator
            conditions {
              attribute
              operator
              values
            }
          }
        }
      }
    }
  }
}

mutation {
  alertsMutingRuleCreate(
    accountId: YOUR_ACCOUNT_ID
    rule: {
      name: "host-1 mute rule"
      description: "Mute host-1 incidents"
      enabled: true
      condition: {
        operator: AND
        conditions: [
          { attribute: "tags.host", operator: EQUALS, values: ["host-1"] }
        ]
      }
    }
  ) {
    id
  }
}

mutation {
  alertsMutingRuleCreate(
    accountId: YOUR_ACCOUNT_ID
    rule: {
      name: "host-1 and synthetics/mobile mute rule"
      description: "Mute host-1 and synthetics/mobile incidents"
      enabled: true
      condition: {
        operator: OR
        conditions: [
          { attribute: "targetName", operator: EQUALS, values: ["host-1"] }
          {
            attribute: "product"
            operator: IN
            values: ["SYNTHETICS", "MOBILE"]
          }
        ]
      }
    }
  ) {
    id
  }
}

mutation {
  alertsMutingRuleUpdate(
    accountId: YOUR_ACCOUNT_ID
    id: MUTING_RULE_ID
    rule: { name: "updated name", enabled: false }
  ) {
    name
  }
}

mutation {
  alertsMutingRuleDelete(accountId: YOUR_ACCOUNT_ID, id: MUTING_RULE_ID) {
    id
  }
}