Monitorizar o Azure Cosmos DB
Este artigo descreve:
- Os tipos de dados de monitoramento que você pode coletar para este serviço.
- Formas de analisar esses dados.
Nota
Se já estiver familiarizado com este serviço e/ou Azure Monitor e quiser apenas saber como analisar dados de monitorização, consulte a secção Analisar perto do final deste artigo.
Quando você tem aplicativos críticos e processos de negócios que dependem de recursos do Azure, você precisa monitorar e receber alertas para seu sistema. O serviço Azure Monitor coleta e agrega métricas e logs de cada componente do seu sistema. O Azure Monitor fornece uma exibição de disponibilidade, desempenho e resiliência e notifica você sobre problemas. Você pode usar o portal do Azure, PowerShell, CLI do Azure, API REST ou bibliotecas de cliente para configurar e exibir dados de monitoramento.
- Para obter mais informações sobre o Azure Monitor, consulte a visão geral do Azure Monitor.
- Para obter mais informações sobre como monitorar os recursos do Azure em geral, consulte Monitorar recursos do Azure com o Azure Monitor.
Informações
Alguns serviços no Azure têm um painel de monitoramento interno no portal do Azure que fornece um ponto de partida para monitorar seu serviço. Esses painéis são chamados de insights, e você pode encontrá-los no Hub de Insights do Azure Monitor no portal do Azure.
Insights do Azure Cosmos DB
O Azure Cosmos DB insights é um recurso baseado no recurso de pastas de trabalho do Azure Monitor. Use as informações do Azure Cosmos DB para obter uma exibição do desempenho geral, falhas, capacidade e integridade operacional de todos os seus recursos do Azure Cosmos DB em uma experiência interativa unificada.
Para obter mais informações sobre insights do Azure Cosmos DB, consulte os seguintes artigos:
Tipos de recursos
O Azure usa o conceito de tipos de recursos e IDs para identificar tudo em uma assinatura. O Azure Monitor organiza de forma semelhante os principais dados de monitoramento em métricas e logs com base em tipos de recursos, também chamados de namespaces. Diferentes métricas e logs estão disponíveis para diferentes tipos de recursos. Seu serviço pode estar associado a mais de um tipo de recurso.
Os tipos de recursos também fazem parte das IDs de recursos para cada recurso em execução no Azure. Por exemplo, um tipo de recurso para uma máquina virtual é Microsoft.Compute/virtualMachines. Para obter uma lista de serviços e seus tipos de recursos associados, consulte Provedores de recursos.
Para obter mais informações sobre os tipos de recursos para o Azure Cosmos DB, consulte Referência de dados de monitoramento do Azure Cosmos DB.
Armazenamento de dados
Para o Azure Monitor:
- Os dados de métricas são armazenados no banco de dados de métricas do Azure Monitor.
- Os dados de log são armazenados no repositório de logs do Azure Monitor. O Log Analytics é uma ferramenta no portal do Azure que pode consultar este armazenamento.
- O log de atividades do Azure é um repositório separado com sua própria interface no portal do Azure.
Opcionalmente, você pode rotear dados de métricas e logs de atividades para o repositório de logs do Azure Monitor. Em seguida, você pode usar o Log Analytics para consultar os dados e correlacioná-los com outros dados de log.
Muitos serviços podem usar configurações de diagnóstico para enviar dados de métrica e log para outros locais de armazenamento fora do Azure Monitor. Os exemplos incluem o Armazenamento do Azure, sistemas de parceiros hospedados e sistemas de parceiros que não são do Azure, usando Hubs de Eventos.
Para obter informações detalhadas sobre como o Azure Monitor armazena dados, consulte Plataforma de dados do Azure Monitor.
Métricas da plataforma Azure Monitor
O Azure Monitor fornece métricas de plataforma para a maioria dos serviços. Essas métricas são:
- Definido individualmente para cada namespace.
- Armazenado no banco de dados de métricas de séries cronológicas do Azure Monitor.
- Leve e capaz de suportar alertas quase em tempo real.
- Usado para acompanhar o desempenho de um recurso ao longo do tempo.
Coleção: o Azure Monitor coleta métricas da plataforma automaticamente. Não é necessária qualquer configuração.
Roteamento: normalmente você também pode rotear métricas da plataforma para Logs / Log Analytics do Azure Monitor para poder consultá-las com outros dados de log. Para obter mais informações, consulte a configuração de diagnóstico de métricas. Para saber como definir definições de diagnóstico para um serviço, consulte Criar definições de diagnóstico no Azure Monitor.
Para obter uma lista de todas as métricas que é possível reunir para todos os recursos no Azure Monitor, consulte Métricas suportadas no Azure Monitor.
O Azure Monitor coleta métricas do Azure Cosmos DB por padrão. Você não precisa configurar nada explicitamente. A maioria das métricas está disponível na página do portal do Azure Cosmos DB ou na página Azure Monitor. Por padrão, as métricas são coletadas com granularidade de um minuto. A granularidade pode variar de acordo com a métrica escolhida. Por padrão, essas métricas têm um período de retenção de 30 dias.
As métricas do lado do servidor do Azure Cosmos DB incluem taxa de transferência, armazenamento, disponibilidade, latência, consistência e métricas no nível do sistema. No lado do cliente, você pode coletar detalhes para cobrança de solicitação, ID de atividade, informações de rastreamento de exceção e pilha, status HTTP e código de substatus e cadeia de caracteres de diagnóstico. Por padrão, essas métricas têm um período de retenção de sete dias. Você pode usar esses dados para depurar problemas ou se precisar entrar em contato com a equipe de suporte do Azure Cosmos DB.
Os valores de dimensão para as métricas, como nome do contêiner, não diferenciam maiúsculas de minúsculas. Esta situação pode resultar em confusão ou colisão de telemetria e ações em recipientes com tais nomes. Use a comparação sem distinção entre maiúsculas e minúsculas ao fazer comparações de cadeia de caracteres nesses valores de dimensão.
Para obter uma lista de métricas disponíveis para o Azure Cosmos DB, consulte Referência de dados de monitoramento do Azure Cosmos DB.
Métricas não baseadas no Azure Monitor
Este serviço fornece outras métricas que não estão incluídas no banco de dados de métricas do Azure Monitor.
- Para obter informações sobre soluções e ferramentas de parceiros que podem ajudar a monitorar o Azure Cosmos DB, consulte Monitorar o Azure Cosmos DB usando soluções de terceiros.
- Para implementar métricas do Micrometer no SDK do Java para Azure Cosmos DB consumindo métricas Prometheus, consulte Usar métricas de cliente do Micrometer para Java.
Logs de recursos do Azure Monitor
Os logs de recursos fornecem informações sobre operações que foram feitas por um recurso do Azure. Os logs são gerados automaticamente, mas você deve roteá-los para os logs do Azure Monitor para salvá-los ou consultá-los. Os logs são organizados em categorias. Um determinado namespace pode ter várias categorias de log de recursos.
Coleção: os logs de recursos não são coletados e armazenados até que você crie uma configuração de diagnóstico e roteie os logs para um ou mais locais. Ao criar uma definição de diagnóstico, especifica as categorias de registos que devem ser recolhidas. Há várias maneiras de criar e manter configurações de diagnóstico, incluindo o portal do Azure, programaticamente e por meio da Política do Azure.
Roteamento: o padrão sugerido é rotear logs de recursos para Logs do Azure Monitor para que você possa consultá-los com outros dados de log. Outros locais, como o Armazenamento do Azure, Hubs de Eventos do Azure e determinados parceiros de monitoramento da Microsoft também estão disponíveis. Para obter mais informações, consulte Logs de recursos do Azure e Destinos de log de recursos.
Para obter informações detalhadas sobre como coletar, armazenar e rotear logs de recursos, consulte Configurações de diagnóstico no Azure Monitor.
Para obter uma lista de todas as categorias de log de recursos disponíveis no Azure Monitor, consulte Logs de recursos com suporte no Azure Monitor.
Todos os logs de recursos no Azure Monitor têm os mesmos campos de cabeçalho, seguidos por campos específicos do serviço. O esquema comum é descrito no esquema de log de recursos do Azure Monitor.
Você pode monitorar logs de diagnóstico de sua conta do Azure Cosmos DB e criar painéis do Azure Monitor. Dados como eventos e rastreamentos que ocorrem em uma segunda granularidade são armazenados como logs. Por exemplo, se a taxa de transferência de um contêiner for alterada, as propriedades de uma conta do Azure Cosmos DB serão alteradas. Os logs capturam esses eventos. Você pode analisar esses logs executando consultas nos dados coletados.
Para obter as categorias de log de recursos disponíveis, suas tabelas associadas do Log Analytics e os esquemas de logs para o Azure Cosmos DB, consulte Referência de dados de monitoramento do Azure Cosmos DB.
Registo de atividades do Azure
O log de atividades contém eventos no nível de assinatura que rastreiam as operações para cada recurso do Azure visto de fora desse recurso; por exemplo, criar um novo recurso ou iniciar uma máquina virtual.
Coleção: os eventos do log de atividades são gerados e coletados automaticamente em um repositório separado para exibição no portal do Azure.
Roteamento: você pode enviar dados de log de atividades para os Logs do Azure Monitor para analisá-los junto com outros dados de log. Outros locais, como o Armazenamento do Azure, Hubs de Eventos do Azure e determinados parceiros de monitoramento da Microsoft também estão disponíveis. Para obter mais informações sobre como rotear o log de atividades, consulte Visão geral do log de atividades do Azure.
Analise os dados de monitoramento
Existem muitas ferramentas para analisar dados de monitoramento.
Ferramentas do Azure Monitor
O Azure Monitor dá suporte às seguintes ferramentas básicas:
Explorador de métricas, uma ferramenta no portal do Azure que permite exibir e analisar métricas para recursos do Azure. Para obter mais informações, consulte Analisar métricas com o explorador de métricas do Azure Monitor.
Log Analytics, uma ferramenta no portal do Azure que permite consultar e analisar dados de log usando a linguagem de consulta Kusto (KQL). Para obter mais informações, consulte Introdução às consultas de log no Azure Monitor.
O log de atividades, que tem uma interface de usuário no portal do Azure para exibição e pesquisas básicas. Para fazer uma análise mais aprofundada, você precisa rotear os dados para os logs do Azure Monitor e executar consultas mais complexas no Log Analytics.
As ferramentas que permitem uma visualização mais complexa incluem:
- Painéis que permitem combinar diferentes tipos de dados em um único painel no portal do Azure.
- Pastas de trabalho, relatórios personalizáveis que você pode criar no portal do Azure. As pastas de trabalho podem incluir texto, métricas e consultas de log.
- Grafana, uma ferramenta de plataforma aberta que se destaca em dashboards operacionais. Você pode usar o Grafana para criar painéis que incluem dados de várias fontes diferentes do Azure Monitor.
- Power BI, um serviço de análise de negócios que fornece visualizações interativas em várias fontes de dados. Você pode configurar o Power BI para importar automaticamente dados de log do Azure Monitor para aproveitar essas visualizações.
Ferramentas de exportação do Azure Monitor
Você pode obter dados do Azure Monitor para outras ferramentas usando os seguintes métodos:
Métricas: use a API REST para métricas para extrair dados de métricas do banco de dados de métricas do Azure Monitor. A API suporta expressões de filtro para refinar os dados recuperados. Para obter mais informações, consulte Referência da API REST do Azure Monitor.
Logs: use a API REST ou as bibliotecas de cliente associadas.
Outra opção é a exportação de dados do espaço de trabalho.
Para começar a usar a API REST para o Azure Monitor, consulte Passo a passo da API REST de monitoramento do Azure.
Analisar métricas do Azure Cosmos DB
Você pode usar o Azure Monitor Metrics Explorer para analisar métricas do Azure Cosmos DB com métricas de outros serviços do Azure selecionando Métricas em Monitoramento na navegação do portal da conta do Azure Cosmos DB. Para obter mais informações sobre como usar o explorador de métricas, consulte Analisar métricas com o explorador de métricas do Azure Monitor.
Você pode monitorar a latência do lado do servidor, o uso da unidade de solicitação e o uso da unidade de solicitação normalizada para seus recursos do Azure Cosmos DB. Você pode selecionar métricas específicas para unidades de solicitação, armazenamento, latência, disponibilidade, Cassandra e outros.
No lado do cliente, você pode depurar problemas coletando métricas para carga de solicitação, ID de atividade, informações de rastreamento de exceção e pilha, código de status e substatus HTTP e cadeia de caracteres de diagnóstico.
Para obter mais informações e instruções detalhadas, consulte os seguintes artigos:
- Monitorar a latência do lado do servidor
- Monitorar o uso da unidade de solicitação
- Monitorar o uso normalizado da unidade de solicitação
- Monitorar atualizações importantes
Para obter uma lista de todas as métricas de recursos suportadas no Azure Monitor, consulte Métricas do Azure Monitor suportadas. Para obter uma lista das métricas de plataforma coletadas para o Azure Cosmos DB, consulte Monitorando métricas de referência de dados do Azure Cosmos DB.
Monitorar o Azure Cosmos DB programaticamente
As métricas de nível de conta disponíveis no portal, como uso de armazenamento de conta e total de solicitações, não estão disponíveis usando a API para NoSQL. No entanto, você pode recuperar dados de uso no nível de coleta usando a API para NoSQL. Para recuperar dados de nível de coleta, use uma das seguintes abordagens:
Para usar a API REST, execute um GET na coleção. As informações de cota e uso da coleção são retornadas nos
x-ms-resource-quotacabeçalhos ex-ms-resource-usagena resposta.Para usar o SDK do .NET, use o método DocumentClient.ReadDocumentCollectionAsync , que retorna um ResourceResponse que contém muitas propriedades de uso, como CollectionSizeUsage, DatabaseUsage e DocumentUsage.
Para acessar mais métricas, use o SDK do Azure Monitor. As definições de métricas disponíveis podem ser recuperadas usando este formato:
https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metricDefinitions?api-version=2018-01-01
Para recuperar métricas individuais, use o seguinte formato:
https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.DocumentDb/databaseAccounts/{DocumentDBAccountName}/providers/microsoft.insights/metrics?timespan={StartTime}/{EndTime}&interval={AggregationInterval}&metricnames={MetricName}&aggregation={AggregationType}&`$filter={Filter}&api-version=2018-01-01
Para saber mais, consulte Azure monitoring REST API.
Analisar logs do Azure Cosmos DB
Os dados nos Logs do Azure Monitor são armazenados em tabelas. Cada tabela tem seu próprio conjunto de propriedades exclusivas. Todos os registos de recursos no Azure Monitor têm os mesmos campos seguidos de campos específicos do serviço. O esquema comum é descrito no esquema de log de recursos do Azure Monitor.
Para obter os tipos de logs de recursos coletados para o Azure Cosmos DB, consulte Referência de dados de monitoramento do Azure Cosmos DB.
Consulte os seguintes artigos para obter mais informações sobre como trabalhar com os Logs do Azure Monitor para o Azure Cosmos DB:
- Monitorar dados usando as configurações de Diagnóstico do Azure
- Logs do plano de controle de auditoria
- Adicionar uma transformação para dados do espaço de trabalho
Consultas do Kusto
Você pode analisar dados de monitoramento no repositório Azure Monitor Logs / Log Analytics usando a linguagem de consulta Kusto (KQL).
Importante
Quando você seleciona Logs no menu do serviço no portal, o Log Analytics é aberto com o escopo da consulta definido para o serviço atual. Esse escopo significa que as consultas de log incluirão apenas dados desse tipo de recurso. Se quiser executar uma consulta que inclua dados de outros serviços do Azure, selecione Logs no menu Azure Monitor . Consulte Escopo e intervalo de tempo da consulta de log no Azure Monitor Log Analytics para obter detalhes.
Para obter uma lista de consultas comuns para qualquer serviço, consulte a interface de consultas do Log Analytics.
Antes de usar o Log Analytics para emitir consultas Kusto, você deve habilitar logs de diagnóstico para operações de plano de controle. Ao habilitar logs de diagnóstico, você seleciona entre armazenar seus dados em tabelas específicas de recursos ou na única tabela AzureDiagnostics (legada). O texto exato das consultas Kusto depende do modo de coleta selecionado.
Aqui estão algumas consultas que você pode inserir na barra de pesquisa de log para ajudá-lo a monitorar seus recursos do Azure Cosmos DB.
Para consultar todos os logs do plano de controle do Azure Cosmos DB:
CDBControlPlaneRequests
Para consultar todos os logs de plano de dados do Azure Cosmos DB:
CDBDataPlaneRequests
Para consultar uma lista filtrada de logs de plano de dados, específicos de um único recurso:
CDBDataPlaneRequests
| where AccountName=="<account-name>"
Para obter uma contagem de logs de plano de dados, agrupados por recurso:
CDBDataPlaneRequests
| summarize count() by AccountName
Para gerar um gráfico para logs de plano de dados, agrupados pelo tipo de operação:
CDBDataPlaneRequests
| summarize count() by OperationName
| render piechart
Para consultas Kusto que você pode usar para solucionar problemas com o Azure Cosmos DB, consulte os seguintes artigos:
- Solucionar problemas usando consultas básicas
- Solucionar problemas usando consultas de diagnóstico avançadas
Esses exemplos são apenas uma pequena amostra das consultas avançadas que você pode executar no Azure Monitor usando a KQL (Kusto Query Language). Para obter mais exemplos, consulte exemplos de consultas Kusto.
Alertas
Os alertas do Azure Monitor notificam proativamente quando condições específicas são encontradas em seus dados de monitoramento. Os alertas permitem-lhe identificar e resolver problemas no seu sistema antes que os seus clientes os percebam. Para obter mais informações, consulte Alertas do Azure Monitor.
Há muitas fontes de alertas comuns para recursos do Azure. Para obter exemplos de alertas comuns para recursos do Azure, consulte Consultas de alerta de log de exemplo. O site Azure Monitor Baseline Alerts (AMBA) fornece um método semiautomatizado de implementação de alertas métricos de plataforma, painéis e diretrizes importantes. O site aplica-se a um subconjunto em contínua expansão dos serviços do Azure, incluindo todos os serviços que fazem parte da Zona de Aterragem do Azure (ALZ).
O esquema de alerta comum padroniza o consumo de notificações de alerta do Azure Monitor. Para obter mais informações, consulte Esquema de alerta comum.
Tipos de alertas
Você pode alertar sobre qualquer fonte de dados de métrica ou log na plataforma de dados do Azure Monitor. Há muitos tipos diferentes de alertas, dependendo dos serviços que você está monitorando e dos dados de monitoramento que você está coletando. Diferentes tipos de alertas têm vários benefícios e desvantagens. Para obter mais informações, consulte Escolher o tipo de alerta de monitoramento correto.
A lista a seguir descreve os tipos de alertas do Azure Monitor que você pode criar:
- Os alertas métricos avaliam as métricas de recursos em intervalos regulares. As métricas podem ser métricas de plataforma, métricas personalizadas, logs do Azure Monitor convertidos em métricas ou métricas do Application Insights. Os alertas métricos também podem aplicar várias condições e limites dinâmicos.
- Os alertas de log permitem que os usuários usem uma consulta do Log Analytics para avaliar logs de recursos em uma frequência predefinida.
- Os alertas do log de atividades são acionados quando ocorre um novo evento do log de atividades que corresponde às condições definidas. Os alertas de Integridade do Recurso e os alertas de Integridade do Serviço são alertas de log de atividades que relatam a integridade do serviço e do recurso.
Alguns serviços do Azure também suportam alertas de deteção inteligente, alertas Prometheus ou regras de alerta recomendadas.
Para alguns serviços, você pode monitorar em escala aplicando a mesma regra de alerta de métrica a vários recursos do mesmo tipo que existem na mesma região do Azure. Notificações individuais são enviadas para cada recurso monitorado. Para serviços e nuvens do Azure com suporte, consulte Monitorar vários recursos com uma regra de alerta.
Regras de alerta do Azure Cosmos DB
A tabela a seguir lista algumas regras de alerta comuns e recomendadas para o Azure Cosmos DB.
| Tipo de alerta | Condição | Description |
|---|---|---|
| Limitação de taxa em unidades de solicitação (alerta métrico) | Nome da dimensão: StatusCode, Operador: Igual, Valores de dimensão: 429 | Alerta se o contêiner ou um banco de dados tiver excedido o limite de taxa de transferência provisionada. |
| Região com falha | Operador: Maior que, Tipo de agregação: Contagem, Valor limite: 1 | Quando uma única região é submetida a failover. Esse alerta será útil se você não tiver habilitado o failover gerenciado pelo serviço. |
| Girar teclas (alerta de registro de atividades) | Nível do evento: Informativo, Estado: iniciado | Alerta quando as chaves da conta são alternadas. Você pode atualizar seu aplicativo com as novas chaves. |
Para obter mais informações e instruções sobre como criar alertas para o Azure Cosmos DB, consulte Criar alerta em métricas. Para criar um alerta para monitorar se o armazenamento de uma chave de partição lógica está se aproximando de 20 GB, consulte Criar alerta sobre o tamanho da chave de partição lógica.
Recomendações do assistente
Para alguns serviços, se ocorrerem condições críticas ou alterações iminentes durante as operações de recursos, será exibido um alerta na página Visão geral do serviço no portal. Você pode encontrar mais informações e correções recomendadas para o alerta em Recomendações do Advisor em Monitoramento no menu à esquerda. Durante as operações normais, nenhuma recomendação do consultor é exibida.
Para obter mais informações sobre o Azure Advisor, consulte Visão geral do Azure Advisor.
Conteúdos relacionados
- Consulte Referência de dados de monitoramento do Azure Cosmos DB para obter uma referência das métricas, logs e outros valores importantes criados para o Azure Cosmos DB.
- Consulte Monitorando recursos do Azure com o Azure Monitor para obter detalhes gerais sobre o monitoramento de recursos do Azure.