Compartilhar via


Monitore os dados do Azure Cosmos DB usando as configurações de diagnóstico do Log Analytics do Azure Monitor

APLICA-SE AO: NoSQL MongoDB Cassandra Gremlin Table

As configurações de diagnóstico no Azure são usadas para coletar logs de recursos. Os recursos emitem logs dos recursos do Azure e fornecem dados avançados e frequentes sobre a operação desse recurso. Esses logs são capturados por solicitação e também são chamados de logs do plano de dados. Entre alguns exemplos de operações do plano de dados estão excluir, inserir e readFeed. O conteúdo desses logs varia de acordo com o tipo de recurso.

Para saber mais sobre as configurações de diagnóstico, confira Configurações de diagnóstico no Azure Monitor.

Observação

Recomenda-se criar a configuração de diagnóstico no modo específico do recurso (para todas as APIs, exceto a API de Tabela) seguindo as instruções na guia API REST. Essa opção fornece otimizações de custo adicionais com uma exibição aprimorada para lidar com os dados.

Pré-requisitos

Aviso

Se você precisar excluir um recurso, renomear ou mover um recurso, ou migrá-lo entre grupos de recursos ou assinaturas, primeiro exclua suas configurações de diagnóstico. Caso contrário, se você recriar esse recurso, as configurações de diagnóstico do recurso excluído poderão ser incluídas com o novo recurso, dependendo da configuração do recurso para cada recurso. Se as configurações de diagnóstico estiverem incluídas no novo recurso, isso retomará a coleção de logs de recursos conforme definido na configuração de diagnóstico e enviará a métrica aplicável e os dados de log para o destino configurado anteriormente.

Além disso, é uma boa prática excluir as configurações de diagnóstico de um recurso que você vai excluir e não planeja usar novamente para manter seu ambiente limpo.

Criar configurações de diagnóstico

Aqui, percorremos o processo de criação de configurações de diagnóstico para sua conta.

Observação

No momento, não há suporte para a métrica de exportação de registros como uma categoria.

  1. Entre no portal do Azure.

  2. Navegue até sua conta existente do Azure Cosmos DB.

  3. Na seção Monitoramento do menu de recursos, selecione Configurações de Diagnóstico. Em seguida, selecione a opção Adicionar configuração de diagnóstico.

    Captura de tela da lista de configurações de diagnóstico com opções para criar configurações ou editar as existentes.

    Importante

    Talvez seja exibida uma solicitação para "habilitar a consulta de texto completo [...] para logs mais detalhados" se o recurso consulta de texto completo não estiver habilitado na sua conta. Você pode ignorar esse aviso com segurança se não quiser habilitar esse recurso. Para obter mais informações, consulte habilitar consulta de texto completo.

  4. No painel Configurações de diagnóstico, nomeie a configuração como example-setting e, em seguida, selecione a categoria QueryRuntimeStatistics. Habilite a caixa de seleção Enviar para o Workspace do Log Analytics, selecionando seu workspace existente. Finalmente, selecione Recurso específico como a opção de destino.

    Captura de tela das várias opções para definir uma configuração de diagnóstico.

Habilitar a consulta de texto completo para registrar o texto da consulta

O Azure Cosmos DB oferece registro em log avançado para solução de problemas detalhada. Ao habilitar a consulta de texto completo, você pode exibir a consulta desofuscada para todas as solicitações na sua conta do Azure Cosmos DB. Você também dá permissão para que o Azure Cosmos DB acesse e exiba esses dados em seus logs.

Aviso

A habilitação desse recurso pode resultar em custos de log adicionais, para detalhes de preços, visite Preços do Azure Monitor. É recomendável desabilitar esse recurso após a solução de problemas.

  1. Na página da conta existente do Azure Cosmos DB, selecione a opção Recursos na seção Configurações do menu de recursos. Em seguida, selecione o recurso Consulta de texto completo de diagnósticos.

    Captura de tela dos recursos disponíveis para uma conta do Azure Cosmos DB.

  2. Na caixa de diálogo, selecione Enable. Essa configuração será aplicada em alguns minutos. Todos os logs recém-ingeridos agora têm o texto completo ou o texto PIICommand de cada solicitação.

    Captura de tela do recurso de consulta de texto completo de diagnóstico sendo habilitado para uma conta do Azure Cosmos DB.