Como monitorar a latência do lado do servidor para operações em uma conta ou contêiner do Azure Cosmos DB
APLICA-SE AO: 
NoSQL MongoDB Cassandra Gremlin Table
O Azure Monitor para Azure Cosmos DB fornece uma exibição de métricas para monitorar sua conta e criar painéis. As métricas do Azure Cosmos DB são coletadas por padrão, e esse recurso não exige que você habilite nem configure nada explicitamente. As métricas de gateway de latência direta e de latência do servidor do lado do servidor são usadas para exibir a latência do lado do servidor de uma operação em dois modos de conexão diferentes. Use a métrica do gateway de latência do servidor se sua operação de solicitação estiver no modo de conectividade de gateway. Use a métrica direta de latência do servidor se sua operação de solicitação estiver no modo de conectividade direta. O Azure Cosmos DB fornece o SLA de menos de 10 ms para operações de leitura/gravação de ponto com conectividade direta. Para operações de leitura e gravação de ponto, os SLAs são calculados conforme detalhado no Documento SLA. Para obter mais informações sobre o modo de conexão, consulte o artigo Modos de conectividade.
A tabela a seguir indica qual API dá suporte a métricas de latência do lado do servidor (direta versus gateway):
| API | Latência do lado do servidor em conexão direta | Latência do lado do servidor em conexão por gateway |
|---|---|---|
| SQL | ✓ | ✓ |
| MongoDB | ✓ | |
| Cassandra | ✓ | |
| Gremlin | ✓ | |
| Tabela | ✓ | ✓ |
Será possível monitorar a métrica de latência do lado do servidor se você vir uma latência excepcionalmente alta para a operação de ponto, como:
- Uma operação GET ou SET com chave de partição e ID
- Uma operação de leitura ou gravação ou
- Uma consulta
Você pode pesquisar o log de diagnóstico para ver o tamanho dos dados retornados. Se você vir uma alta latência sustentada para operações de consulta, deverá procurar o log de diagnóstico para a taxa de transferência mais alta ou RU/s em uso. A latência do lado do servidor mostra a quantidade de tempo gasto na infraestrutura de back-end antes que os dados sejam retornados ao cliente. É importante observar essa métrica para eliminar qualquer problema de latência de back-end.
Exibir a métrica de latência do lado do servidor
Entre no portal do Azure.
Selecione Monitor na barra de menus de navegação à esquerda e selecione Métricas.
No painel Métricas>Selecionar um recurso > escolha a assinatura necessária e o grupo de recursos. Para o Tipo de recurso, selecione Contas do Azure Cosmos DB, escolha uma das contas existentes do Azure Cosmos DB e selecione Aplicar.
Em seguida, selecione a métrica Latência do Lado do Servidor por Gateway na lista de métricas disponíveis, se sua operação estiver no modo de conectividade de gateway. Selecione a métrica Latência do Lado do Servidor por Conexão Direta se sua operação de solicitação estiver no modo de conectividade direta. Para saber mais detalhadamente sobre todas as métricas disponíveis nesta lista, consulte o artigo Métricas por categoria. Neste exemplo, vamos selecionar Latência do Lado do Servidor por Gateway e Média como o valor de agregação. Além desses detalhes, você também pode selecionar o Intervalo de tempo e a Granularidade de tempo das métricas. Você pode exibir as métricas de, no máximo, os últimos 30 dias. Depois que você aplicar o filtro, um gráfico será exibido com base no seu filtro. Você pode ver a latência do lado do servidor no modo de conectividade de gateway por cinco minutos para o período selecionado.
Filtros para latência do lado do servidor
Você também pode filtrar as métricas e obter os gráficos exibidos por CollectionName, DatabaseName, OperationType, Region e PublicAPIType específicos.
Para filtrar as métricas, selecione Adicionar filtro e escolha a propriedade necessária, como PublicAPIType, e selecione o valor Sql. Selecione Aplicar divisão para OperationType. Em seguida, o grafo exibe a latência do lado do servidor para diferentes operações no modo de conexão de gateway durante o período selecionado. As operações executadas por meio do procedimento armazenado não são registradas em log, de modo que não estão disponíveis na métrica OperationType.
As métricas Latência do Lado do Servidor por Gateway para cada operação são exibidas conforme mostrado na imagem a seguir:
Você também pode agrupar as métricas usando a opção Aplicar divisão.
Observação
As solicitações que chegam ao Azure Cosmos DB nem sempre são direcionadas a um contêiner. Por exemplo, você pode até criar um banco de dados dentro de uma conta distribuída globalmente que a solicitação ainda será registrada para a métrica de latência do lado do servidor. A solicitação é registrada porque leva tempo para criar um recurso de banco de dados, mas ela não tem um contêiner como destino. Se você vir que o valor da métrica CollectionName é <empty>, isso significa que o destino não é um contêiner, mas outro recurso no Azure Cosmos DB.
Como solução alternativa, você pode filtrar proativamente suas métricas para um contêiner específico (CollectionName) para excluir solicitações que não são específicas o contêiner que é o tema da sua consulta.
Próximas etapas
- Monitore dados do Azure Cosmos DB usando configurações de diagnóstico no Azure.
- Auditar operações do painel de controle do Azure Cosmos DB