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

  • Artigo

Este guia fornece instruções passo a passo para habilitar o log de diagnóstico para um serviço de IA do Azure. Esses logs fornecem dados ricos 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ê deve 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óstico, você precisará de um lugar para armazenar seus dados de log. Este tutorial usa o Armazenamento do Azure e o Log Analytics.

  • Armazenamento do Azure - Retém 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 os logs emissores de recursos, desde que o usuário que define a configuração tenha acesso RBAC do Azure apropriado a ambas as assinaturas.
  • Log Analytics - Uma ferramenta flexível de pesquisa e análise de logs que permite a análise de logs brutos gerados por um recurso do Azure.

Nota

Habilitar a coleta de log de diagnóstico

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

Nota

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

  1. Navegue para o portal do Azure. Em seguida, localize e selecione um recurso de serviços de IA do Azure. Por exemplo, a sua subscrição dos Serviços de Voz.
  2. Em seguida, no menu de navegação à esquerda, localize Monitoramento e selecione Configurações de diagnóstico. Esta tela contém todas as configurações de diagnóstico criadas anteriormente para este recurso.
  3. Se houver um recurso criado anteriormente que você gostaria de usar, você pode 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 registrar o Analytics.
  5. Quando solicitado a configurar, selecione a conta de armazenamento e o espaço de trabalho do OMS que você deseja usar para armazenar seus logs de diagnóstico. Observação: se você não tiver uma conta de armazenamento ou espaço de trabalho do OMS, siga as instruções para criar uma.
  6. Selecione Audit, 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 dessa categoria de log serão armazenados indefinidamente.
  7. Selecione Guardar.

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

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

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

  1. No portal do Azure, localize o recurso de 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. Neste exemplo, vamos definir o intervalo de tempo como Últimos 30 dias e a métrica como Transação.
  4. Quando a consulta estiver concluída, você verá uma visualização da transação nos últimos 30 dias. Para exportar esses dados, use o botão Exportar para Excel localizado na parte superior da página.

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

Ver registos no Log Analytics

Siga estas instruções para explorar os dados de análise de log para o 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. Nesta página, você pode executar consultas em seus logs.

Consultas de amostra

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

Execute esta consulta para todos os logs de diagnóstico dos serviços de IA do Azure por um período de tempo 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 encontrar 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 exibir o volume de operações ao longo do tempo dividido por OperationName com contagens vinculadas a cada 10s.

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

Próximos passos