Compartilhar via

Habilitar o log de diagnósticos para serviços de IA do Azure

  • Artigo

Este guia fornece instruções passo a passo para habilitar o log de diagnósticos para um serviço de IA do Azure. Esses logs fornecem dados avançados e frequentes sobre a operação de um recurso que são usados para identificação e depuração de problemas. Antes de continuar, você precisa ter uma conta do Azure com uma assinatura de, pelo menos, um serviço de IA do Azure, como os Serviços de Fala.

Pré-requisitos

Para habilitar o log de diagnósticos, você precisará de algum lugar para armazenar os dados de log. Este tutorial usa o Armazenamento do Azure e o Log Analytics.

  • Armazenamento do Azure – mantém os logs de diagnóstico para auditoria de política, análise estática ou backup. A conta de armazenamento não precisa estar na mesma assinatura que o recurso que emite os logs, contanto que o usuário que define a configuração tenha acesso RBAC do Azure apropriado a ambas as assinaturas.
  • Log Analytics – uma ferramenta de análise e pesquisa de logs flexível que permite a análise de logs brutos gerados por um recurso do Azure.

Observação

Habilitar a coleta de log de diagnóstico

Vamos começar habilitando o log de diagnósticos usando o portal do Azure.

Observação

Para habilitar esse recurso usando o PowerShell ou a CLI do Azure, use as instruções fornecidas em Coletar e consumir dados de log dos recursos do Azure.

  1. Navegue até o portal do Azure. Em seguida, localize e selecione um recurso dos serviços de IA do Azure. Por exemplo, sua assinatura para os Serviços de Fala.
  2. Em seguida, no menu de navegação à esquerda, localize Monitoramento e selecione Configurações de diagnóstico. Essa tela contém todas as configurações de diagnóstico criadas anteriormente para esse recurso.
  3. Se houver um recurso criado anteriormente que gostaria de usar, você poderá selecioná-lo agora. Caso contrário, selecione + Adicionar configuração de diagnóstico.
  4. Insira um nome para a configuração. Em seguida, selecione Arquivar em uma conta de armazenamento e Enviar para o Log Analytics.
  5. Quando for solicitada a configuração, selecione a conta de armazenamento e o workspace do OMS que você gostaria de usar para armazenar os logs de diagnóstico. Observação: se você não tiver uma conta de armazenamento ou workspace do OMS, siga os prompts para criar uma.
  6. Selecione Auditoria, RequestResponse e AllMetrics. Em seguida, defina o período de retenção para seus dados de log de diagnóstico. Se uma política de retenção for definida como zero, os eventos para essa categoria de log serão armazenados indefinidamente.
  7. Selecione Salvar.

Pode levar até duas horas antes que os dados de registro em log estejam disponíveis para consulta e análise. Portanto, não se preocupe se não vir nada imediatamente.

Ver e exportar dados de diagnóstico do Armazenamento do Azure

O Armazenamento do Azure é uma solução robusta de armazenamento de objetos que é otimizada para armazenar grandes quantidades de dados não estruturados. Nesta seção, você aprenderá a consultar sua conta de armazenamento para obter as transações totais em um período de 30 dias e exportar os dados para o Excel.

  1. No portal do Azure, localize o recurso do Armazenamento do Azure que você criou na última seção.
  2. No menu de navegação à esquerda, localize Monitoramento e selecione Métricas.
  3. Use os menus suspensos disponíveis para configurar sua consulta. Para esse exemplo, vamos definir o intervalo de tempo para os Últimos 30 dias e a métrica para Transação.
  4. Quando a consulta for concluída, você verá uma visualização da transação nos últimos 30 dias. Para exportar esses dados, use o botão Exportar para o Excel localizado na parte superior da página.

Saiba mais sobre o que você pode fazer usando dados de diagnóstico no Armazenamento do Azure.

Exibir logs no Log Analytics

Siga essas instruções para explorar os dados de análise de logs para seu recurso.

  1. No portal do Azure, localize e selecione Log Analytics no menu de navegação à esquerda.
  2. Localize e selecione o recurso que você criou ao habilitar o diagnóstico.
  3. Em geral, localize e selecione Logs. Nessa página, você pode executar consultas em seus logs.

Consultas de exemplo

Aqui estão algumas consultas Kusto básicas que você pode usar para explorar os dados de log.

Execute esta consulta para todos os logs de diagnóstico dos serviços de IA do Azure por período especificado:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"

Execute esta consulta para ver os 10 logs mais recentes:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| take 10

Execute esta consulta para agrupar operações por Recurso:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES" |
summarize count() by Resource

Execute esta consulta para localizar o tempo médio necessário para executar uma operação:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| summarize avg(DurationMs)
by OperationName

Execute esta consulta para ver o volume de operações ao longo do tempo dividido por OperationName com contagens compartimentalizadas a cada 10 segundos.

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| summarize count()
by bin(TimeGenerated, 10s), OperationName
| render areachart kind=unstacked

Próximas etapas