Configurar Alertas

  • 6 minutos

O Azure Cosmos DB usa o serviço Azure Monitor para configurar e enviar alertas. Os alertas monitoram a disponibilidade e a capacidade de resposta dos recursos do Azure Cosmos DB e enviam notificações quando as métricas monitoradas atingem os limites especificados. Os alertas podem assumir a forma de emails ou até mesmo executar Azure Functions quando são acionados. Os alertas também monitoram os eventos do log de atividades da conta do Azure Cosmos DB.

Os alertas podem ser configurados na página da conta do Azure Cosmos DB ou no Azure Monitor. Em ambos os locais, você configurará os alertas de maneira semelhante.

Configurar um alerta

Vamos dar uma olhada em um exemplo de configuração de alertas quando mais de mil exceções 429 são acionadas no período de 15 minutos. O alerta deve verificar a condição a cada 5 minutos. Por fim, ele deve enviar um email para admins@contoso.com quando a condição for atendida.

  1. Na sua página da conta do Azure Cosmos DB, na seção Monitoramento, escolha Alertas.

  2. Selecione + Criar e selecione Regra de alerta para criar um novo alerta. Você deve ver sua conta atual do Azure Cosmos DB, assinatura e Grupo de Recursos já selecionados.

  3. Selecione Adicionar condição. Essa condição definirá o gatilho para este alerta.

    1. Hora de escolher o Tipo de sinal. Os sinais são Métricas ou Logs de Atividade. Como as exceções 429 podem ocorrer quando são feitas solicitações, pesquise pelo nome do sinal Total de Unidades de Solicitação. Devemos ver um gráfico que nos mostra o total de unidades de solicitação nas últimas 6 horas.

    2. No momento, se você adicionar uma Lógica de Alerta, ela será medida em todas as unidades de solicitação dessa conta. O que você precisa é apenas criar uma condição em relação às Solicitações que retornaram um código de status de 429. Para criar esse filtro, em Dividir por dimensão, escolha:

      1. Selecione StatusCode no menu suspenso StatusCode.

      2. Selecione = em =.

      3. Se ocorreu uma exceção 429 nas últimas 6 horas, você poderá vê-la nas opções Valores de dimensão. Se 429 não for uma opção em Valores de dimensão, selecione Adicionar valor personalizado e adicione o valor 429. Você pode adicionar filtros extras, como banco de dados, coleção, região ou tipo de operação, se precisar de um filtro ainda mais preciso.

    3. Defina o valor Limite da Lógica de Alerta como 1000.

    4. Em Avaliado com base em, defina a Granularidade de agregação (período) como 15 minutos e a Frequência de Avaliação como 5 minutos.

    5. Selecione Concluído para terminar a configuração da Condição.

  4. O alerta precisa saber o que fazer quando a condição for atendida. Vamos enviar um email. Em Ações, selecione Adicionar grupos de ações.

    1. Se você já tiver algumas ações criadas, poderá reutilizá-las. Vamos criar uma nova Ação, selecione + Criar grupo de ação.

    2. Na guia Básico:

      1. Dê um nome ao Grupo de ações.

      2. Se necessário, altere o Nome de exibição.

    3. Na guia Notificação:

      1. Em Tipo de notificação, escolha Mensagem de email/SMS/Push/voz.

      2. Dê um Nome à notificação.

      3. Selecione o ícone de lápis para adicionar o destinatário da notificação.

        1. Marque a caixa de seleção Email.

        2. Defina o Email como admins@contoso.com e selecione OK.

    4. Selecione o botão Examinar + criar e depois o botão Criar.

  5. Por fim, precisamos preencher as informações gerais do alerta em Detalhes da regra de alerta. Você pode alterar qualquer uma das opções predefinidas conforme necessário, mas precisa definir pelo menos o Nome da regra de alerta, portanto, dê um nome ao alerta.

  6. Selecione o botão Criar regra de alerta para criar o alerta.

Depois que o alerta for criado, pode levar até 10 minutos para ser ativado.

Cenários de alerta comuns

A seguir, alguns cenários em que esse recurso é útil:

  • Quando as chaves de uma conta do Azure Cosmos são atualizadas.
  • Quando o uso de dados ou índice de um contêiner, banco de dado ou região excede um determinado número de bytes.
  • Quando o consumo de RU/s normalizado for maior do que um determinado percentual.
  • Quando uma região é adicionada, removida ou fica offline.
  • Quando um banco de dados ou um contêiner é criado, excluído ou atualizado.
  • Quando a taxa de transferência do banco de dados ou do contêiner é alterada.