Criar alertas para o Azure Cosmos DB usando o Azure Monitor
APLICA-SE AO: 
NoSQL MongoDB Cassandra Gremlin Table
Os alertas são usados para configurar testes recorrentes para monitorar a disponibilidade e a capacidade de resposta de seus recursos do Azure Cosmos DB. Alertas podem enviar uma notificação na forma de um email ou executar uma Função do Azure quando uma de suas métricas atinge o limite ou se um evento específico é registrado no log de atividades.
Você pode receber um alerta com base nas métricas, nos eventos do log de atividades ou nos logs do Log Analytics na conta do Azure Cosmos DB:
Métricas: o alerta é disparado quando o valor de uma métrica especificada ultrapassa um limite atribuído por você. Por exemplo, quando as unidades de solicitação totais consumidas excederem 1000 RU/s. Esse alerta é disparado tanto quando a condição é atendida pela primeira vez quanto posteriormente, quando essa condição não está mais sendo atendida. Consulte o artigo de referência de dados de monitoramento para obter diferentes métricas disponíveis no Azure Cosmos DB.
Eventos do log de atividades: este alerta é disparado quando ocorre um determinado evento. Por exemplo, quando as chaves de sua conta do Azure Cosmos DB são acessadas ou atualizadas.
Log Analytics – Esse alerta é disparado quando o valor de uma propriedade especificada nos resultados de uma consulta do Log Analytics ultrapassa um limite que você atribui. Por exemplo, você pode criar uma consulta do Log Analytics para monitorar se o armazenamento de uma chave de partição lógica está atingindo o limite de armazenamento de chave de partição lógica de 20 GB no Azure Cosmos DB.
Você pode configurar alertas no painel do Azure Cosmos DB ou no serviço do Azure Monitor no portal do Azure. Ambas as interfaces oferecem as mesmas opções. Este artigo mostra como configurar alertas para o Azure Cosmos DB usando o Azure Monitor.
Criar uma regra de alerta
Esta seção mostra como criar um alerta quando você recebe um código de status HTTP 429, que é recebido quando as solicitações são limitadas por taxa. Por exemplo, talvez você queira receber um alerta quando houver 100 ou mais solicitações com taxas limitadas. Este artigo mostra como configurar um alerta para esse cenário usando o código de status HTTP. Você pode usar etapas semelhantes para configurar outros tipos de alertas também. Basta escolher uma condição diferente com base em seu requisito.
Dica
O cenário de alertas com base no número 429s excedendo um limite é usado aqui para fins de ilustração. Isso não significa que sempre há algo errado com a exibição de 429s no banco de dados ou contêiner. Em geral, se aparecer de 1 a 5% das solicitações com 429s em uma carga de trabalho de produção e a latência geral do aplicativo estiver dentro dos requisitos, esse será um sinal normal e íntegro de que você está usando a taxa de transferência (RU/s) que provisionou. Saiba mais sobre como interpretar e depurar exceções 429.
Entre no portal do Azure.
Selecione Monitor na barra de menus de navegação à esquerda e selecione Alertas.
Selecione o botão Nova regra de alerta para abrir o painel Criar regra de alerta.
Preencha a seção Escopo :
Abra o painel Selecionar recurso e configure o seguinte:
Escolha seu nome de assinatura.
Selecione Contas de Azure Cosmos DB para o tipo de recurso.
O local da sua conta do Azure Cosmos DB.
Depois de preencher os detalhes, será exibida uma lista de contas do Azure Cosmos DB no escopo selecionado. Escolha aquele para o qual você deseja configurar alertas e selecione Concluído.
Preencha a seção Condição :
Abra o painel Selecionar condição para abrir a página Selecionar um sinal e configure o seguinte:
Selecione um sinal. O tipo de sinal pode ser uma métrica, um log de atividades ou um log (Log Analytics). Escolha Métricas neste cenário, para obter um alerta quando a limitação de taxa ocorrer na métrica de total de unidades de solicitação.
Selecione Tudo em Monitorar serviço
Escolha um Nome de sinal. Para obter um alerta para códigos de status HTTP, escolha o sinal Total de Unidades de Solicitação.
Agora você pode definir a lógica para disparar um alerta e usar o gráfico para exibir as tendências da conta do Azure Cosmos DB. A métrica Total de Unidades de Solicitação dá suporte a dimensões. Essas dimensões permitem que você filtre a métrica. Por exemplo, você pode usar dimensões para filtrar um banco de dados ou um contêiner específico que deseja monitorar. Se você não selecionar nenhuma dimensão, esse valor será ignorado.
Escolha StatusCode como o Nome da dimensão. Selecione Adicionar valor personalizado e defina o código de status como 429.
Na Lógica de alerta, defina o Limite como Estático. O limite estático usa um valor de limite definido pelo usuário para avaliar a regra, enquanto os limites dinâmicos usam algoritmos de aprendizado de máquina internos para aprender continuamente o padrão de comportamento de métrica e calcular os limites de forma automática.
Defina o operador como Maior que, o Tipo de agregação como Totale o Valor do limite como 100. Com essa lógica, se o cliente perceber mais de 100 solicitações com um código de status 429, o alerta será disparado. Você também pode configurar o tipo de agregação, a granularidade da agregação e a frequência de avaliação com base em seu requisito.
Depois de preencher o formulário, selecione Concluído. A captura de tela a seguir mostra os detalhes da lógica de alerta:
Preencha a seção Grupo de ações :
No painel Criar regra, selecione um grupo de ações existente ou crie um novo. Um grupo de ações permite definir a ação a ser executada quando ocorrer uma condição de alerta. Neste exemplo, crie um novo grupo de ações para receber uma notificação por email quando o alerta for disparado. Abra o painel Adicionar grupo de ações e preencha os seguintes detalhes:
Nome do grupo de ações: o nome do grupo de ações deve ser exclusivo dentro de um grupo de recursos.
Nome curto: o nome curto do grupo de ações, esse valor é incluído no email e notificações de SMS para identificar qual grupo de ação foi a origem da notificação.
Escolha a assinatura e o grupo de recursos no qual esse grupo de ações será criado.
Forneça um nome para a ação e selecione Email/Mensagem SMS/Push/Voz como o Tipo de Ação. A captura de tela a seguir mostra os detalhes do tipo de ação:
Preencha a seção Detalhes da regra de alerta:
- Defina um nome para a regra, faça uma descrição opcional, escolha um nível de severidade para a regra, escolha se deseja habilitar a regra na criação de regra e clique em Criar alerta de regra para criar o alerta de regra da métrica.
Depois de criar o alerta, ele ficará ativo em 10 minutos.
Cenários de alerta comuns
A seguir, alguns cenários em que esse recurso é útil:
- Quando as chaves de uma conta do Azure Cosmos DB são atualizadas.
- Quando o uso de dados ou índice de um contêiner, banco de dado ou de uma região excede um determinado número de bytes.
- Quando o armazenamento de uma chave de partição lógica estiver atingindo o limite de armazenamento de partição lógica de 20 GB do Azure Cosmos DB.
- Quando o consumo de RU/s normalizado for maior do que determinado percentual. A métrica de consumo de RU normalizada fornece a utilização de taxa de transferência máxima dentro de um conjunto de réplicas. Para saber mais, consulte o artigo Como monitorar as RU/s normalizadas.
- Quando uma região é adicionada, removida ou se 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.
Próximas etapas
- Como monitorar a métrica de RU/s normalizada no contêiner do Azure Cosmos DB.
- Como monitorar a taxa de transferência ou o uso da unidade de solicitação de uma operação no Azure Cosmos DB.