Monitoramento da referência de dados do Azure Cosmos DB

APLICA-SE A: API do SQL API do Cassandra API do Gremlin API de Tabela API do Azure Cosmos DB para MongoDB

Este artigo apresenta uma referência de dados de log e métricas coletados para analisar o desempenho e a disponibilidade do Azure Cosmos DB. Veja o artigo Monitorar o Azure Cosmos DB para obter detalhes sobre como coletar e analisar dados de monitoramento do Azure Cosmos DB.

Métricas

Todas as métricas correspondentes ao Azure Cosmos DB são armazenadas no namespace Métricas padrão do Cosmos DB. Para obter uma lista de todas as métricas de suporte do Azure Monitor (incluindo o Azure Cosmos DB), veja Métricas com suporte do Azure Monitor. Esta seção lista todas as métricas da plataforma coletadas automaticamente do Azure Cosmos DB.

Métricas de solicitação

Métrica (Nome de exibição da métrica) Unidade (Tipo de agregação) Descrição Dimensões Granularidades de tempo Mapeamento de métrica herdada Uso
TotalRequests (Total de solicitações) Count (Contagem) Número de solicitações feitas DatabaseName, CollectionName, Region, StatusCode Tudo TotalRequests, Http 2xx, Http 3xx, Http 400, Http 401, Erro interno do servidor, Serviço Não Disponível, Solicitações Limitadas, Média de Solicitações por Segundo Usada para monitorar solicitações por código de status, o contêiner em uma granularidade de minuto. Para obter a média de solicitações por segundo, use a agregação de contagem no minuto e divida por 60.
MetadataRequests (Solicitações de metadados) Count (Contagem) Contagem de solicitações de metadados. O Azure Cosmos DB mantém um contêiner de metadados do sistema para cada conta, o que permite que você enumere coleções, bancos de dados etc. e as configurações deles, gratuitamente. DatabaseName, CollectionName, Region, StatusCode Tudo Usada para monitorar os limitadores devido a solicitações de metadados.
MongoRequests (Solicitações de Mongo) Count (Contagem) Número de Solicitações do Mongo Feitas DatabaseName, CollectionName, Region, CommandName, ErrorCode Tudo Taxa de Solicitação de Consulta do Mongo, Taxa de Solicitação de Atualização do Mongo, Taxa de Solicitação de Exclusão do Mongo, Taxa de Solicitação de Inserção do Mongo, Taxa de Solicitação de Contagem do Mongo Usada para monitorar os erros de solicitação do Mongo, usos por tipo de comando.

Métricas de unidade de solicitação

Métrica (Nome de exibição da métrica) Unidade (Tipo de agregação) Descrição Dimensões Granularidades de tempo Mapeamento de métrica herdada Uso
MongoRequestCharge (Encargo de solicitação de Mongo) Count (Total) Unidades Solicitadas do Mongo Consumidas DatabaseName, CollectionName, Region, CommandName, ErrorCode Tudo Encargo de Solicitação de Consulta do Mongo, Encargo de Solicitação de Atualização do Mongo, Encargo de Solicitação de Exclusão do Mongo, Encargo de Solicitação de Inserção do Mongo, Encargo de Solicitação de Contagem do Mongo Usada para monitorar RUs de recurso do Mongo em um minuto.
TotalRequestUnits (Total de unidades de solicitação) Count (Total) Unidades Solicitadas Consumidas DatabaseName, CollectionName, Region, StatusCode Tudo TotalRequestUnits Usada para monitorar o uso de RU Total a uma granularidade de minuto. Para obter a média de RU consumida por segundo, use a agregação de Soma no intervalo/nível de minuto e divida por 60.
ProvisionedThroughput (Taxa de transferência provisionada) Count (Máximo) Taxa de transferência provisionada na granularidade do contêiner DatabaseName, ContainerName 5 M Usada para monitorar a taxa de transferência provisionada por contêiner.

Métricas de armazenamento

Métrica (Nome de exibição da métrica) Unidade (Tipo de agregação) Descrição Dimensões Granularidades de tempo Mapeamento de métrica herdada Uso
AvailableStorage (Armazenamento disponível) Bytes (Total) Armazenamento disponível total relatado na granularidade de 5 minutos por região DatabaseName, CollectionName, Region 5 M Armazenamento disponível Usada para monitorar a capacidade de armazenamento disponível (aplicável apenas para coleções de armazenamento fixas). A granularidade mínima deve ser de 5 minutos.
DataUsage (Uso de dados) Bytes (Total) Uso de dados total relatado na granularidade de 5 minutos por região DatabaseName, CollectionName, Region 5 M Tamanho dos dados Usada para monitorar o uso total de dados no contêiner e na região, a granularidade mínima deve ser 5 minutos.
IndexUsage (Uso do índice) Bytes (Total) Uso do índice total relatado na granularidade de 5 minutos por região DatabaseName, CollectionName, Region 5 M Tamanho do Índice Usada para monitorar o uso total de dados no contêiner e na região, a granularidade mínima deve ser 5 minutos.
DocumentQuota (Cota de documento) Bytes (Total) Cota de armazenamento total relatada na granularidade de 5 minutos por região. DatabaseName, CollectionName, Region 5 M Capacidade de Armazenamento Usada para monitorar a cota total no contêiner e na região, a granularidade mínima deve ser 5 minutos.
DocumentCount (Contagem de documentos) Count (Total) Contagem total de documentos relatada na granularidade de 5 minutos por região DatabaseName, CollectionName, Region 5 M Contagem de documentos Usada para monitorar a contagem de documentos no contêiner e na região, a granularidade mínima deve ser 5 minutos.

Métricas de latência

Métrica (Nome de exibição da métrica) Unidade (Tipo de agregação) Descrição Dimensões Granularidades de tempo Uso
ReplicationLatency (Latência de replicação) MiliSeconds (Mínimo, Máximo, Média) Latência de replicação P99 nas regiões de origem e de destino para conta habilitada geograficamente SourceRegion, TargetRegion Tudo Usada para monitorar a latência de replicação P99 entre quaisquer duas regiões para uma conta com replicação geográfica.
Latência do lado do servidor MiliSeconds (Média) Tempo gasto pelo servidor para processar a solicitação. CollectionName, ConnectionMode, DatabaseName, OperationType, PublicAPIType, Region Tudo Usada para monitorar a latência de solicitação no servidor do Azure Cosmos DB.

Métricas de disponibilidade

Métrica (Nome de exibição da métrica) Unidade (Tipo de agregação) Descrição Granularidades de tempo Mapeamento de métrica herdada Uso
ServiceAvailability (Disponibilidade do serviço) Percentual (Mínimo, Máximo) Disponibilidade de solicitações de conta na granularidade de uma hora 1H Disponibilidade do serviço Isso é a porcentagem do total de solicitações passadas. Uma solicitação será considerada com falha devido a erro de sistema se o código de status for 410, 500 ou 503. Usada para monitorar a disponibilidade da conta na granularidade de hora.

Métricas da API do Cassandra

Métrica (Nome de exibição da métrica) Unidade (Tipo de agregação) Descrição Dimensões Granularidades de tempo Uso
CassandraRequests (Solicitações do Cassandra) Count (Contagem) Número de solicitações da API do Cassandra feitas DatabaseName, CollectionName, ErrorCode, Region, OperationType, ResourceType Tudo Usada para monitorar solicitações do Cassandra em uma granularidade de minuto. Para obter a média de solicitações por segundo, use a agregação de contagem no minuto e divida por 60.
CassandraRequestCharges (Encargos de solicitação do Cassandra) Count (Soma, Mínimo, Máximo, Média) Unidades de solicitação consumidas pelas solicitações de API do Cassandra DatabaseName, CollectionName, Region, OperationType, ResourceType Tudo Usada para monitorar as RUs usadas por minuto por uma conta de API do Cassandra.
CassandraConnectionClosures (Fechamentos de conexão do Cassandra) Count (Contagem) Número de conexões do Cassandra fechadas ClosureReason, Region Tudo Usada para monitorar a conectividade entre os clientes e a API do Cassandra do Azure Cosmos DB.

Para obter mais informações, veja uma lista de todas as métricas de plataforma com suporte no Azure Monitor.

Logs de recursos

A tabela a seguir lista as propriedades dos logs de recursos no Azure Cosmos DB. Os logs de recursos são coletados em logs do Azure Monitor ou no Armazenamento do Microsoft Azure. No Azure Monitor, os logs são coletados na tabela AzureDiagnostics no provedor de recursos** nome do MICROSOFT.DOCUMENTDB.

Propriedade ou campo de Armazenamento do Microsoft Azure Propriedade de logs do Azure Monitor Descrição
time TimeGenerated A data e hora (UTC) em que a operação ocorreu.
resourceId Recurso A conta do Azure Cosmos DB na qual os logs estão habilitados.
category Categoria Para o Azure Cosmos DB, DataPlaneRequests, MongoRequests, QueryRuntimeStatistics, PartitionKeyStatistics, PartitionKeyRUConsumption, ControlPlaneRequests, CassandraRequests, GremlinRequests são os tipos de log disponíveis.
operationName OperationName Nome da operação. O nome da operação pode ser Create, Update, Read, ReadFeed, Delete, Replace, Execute, SqlQuery, Query, JSQuery, Head, HeadFeed ou Upsert.
properties N/D O conteúdo desse campo é descrito nas linhas a seguir.
activityId activityId_g O GUID exclusivo da operação registrada.
userAgent userAgent_s Uma cadeia de caracteres que especifica o agente de usuário do cliente do qual a solicitação foi enviada. O formato do agente do usuário é {user agent name}/{version}.
requestResourceType requestResourceType_s O tipo do recurso acessado. Esse valor pode ser banco de dados, contêiner, documento, anexo, usuário, permissão, procedimento armazenado, gatilho, função definida pelo usuário ou uma oferta.
statusCode statusCode_s O status da resposta da operação.
requestResourceId ResourceId O resourceId referente à solicitação. Dependendo da operação executada, esse valor pode apontar para databaseRid, collectionRid ou documentRid.
clientIpAddress clientIpAddress_s Endereço IP do cliente.
requestCharge requestCharge_s O número de RUs usadas pela operação
collectionRid collectionId_s A ID exclusiva da coleção.
duration duration_d A duração da operação em milissegundos.
requestLength requestLength_s O tamanho da solicitação, em bytes.
responseLength responseLength_s O tamanho da resposta, em bytes.
resourceTokenPermissionId resourceTokenPermissionId_s Essa propriedade indica a ID de permissão de token do recurso que você especificou. Para saber mais sobre permissões, veja o artigo Proteger o acesso aos dados.
resourceTokenPermissionMode resourceTokenPermissionMode_s Essa propriedade indica o modo de permissão que você definiu ao criar o token de recurso. O modo de permissão pode ter valores como “todos” ou “leitura”. Para saber mais sobre permissões, veja o artigo Proteger o acesso aos dados.
resourceTokenUserRid resourceTokenUserRid_s Esse valor não fica vazio quando tokens de recurso são usados para autenticação. O valor aponta para a ID de recurso do usuário.
responseLength responseLength_s O tamanho da resposta, em bytes.

Para ver uma lista de todas as categorias de logs e links do Azure Monitor para esquemas associados, veja Categorias de logs e esquemas do Azure Monitor.

Tabelas de Logs do Azure Monitor

O Azure Cosmos DB usa as tabelas Kusto dos logs do Azure Monitor. Você pode consultar essas tabelas com o Log Analytics. Para obter uma lista das tabelas do Azure Data Explorer que o Cosmos DB usa, veja o artigo Referência da tabela Logs do Azure Monitor.

Consulte Também