Obter análises de API no Gerenciamento de API do Azure
APLICA-SE A: Desenvolvedor | Básico | Básico v2 | Padrão | Standard v2 | Premium | Premium v2
O Gerenciamento de API do Azure fornece análises de suas APIs para que você possa analisar seu uso e desempenho. Use análises para o monitoramento de alto nível e a resolução de problemas em suas APIs. Para obter outros recursos de monitoramento, incluindo métricas quase em tempo real e registros de recursos para diagnóstico e auditoria, consulte Tutorial: Monitorar as APIs publicadas.
Observação
Atualmente, esse recurso não está disponível em workspaces.
Sobre a análise de API
O Gerenciamento de API fornece análises usando um painel baseado no Azure Monitor. O painel agrega dados em um workspace do Log Analytics do Azure.
Nas camadas de serviço clássicas do Gerenciamento de API, sua instância do Gerenciamento de API também inclui análises herdadas integradas no portal do Microsoft Azure, e os dados de análise podem ser acessados usando a API REST do Gerenciamento de API. Dados semelhantes são mostrados no painel baseado no Azure Monitor e na análise interna.
Importante
- O painel baseado no Azure Monitor é a maneira recomendada de acessar os dados de análise.
- A análise interna (clássica) não está disponível nas camadas v2.
Com a análise de API, analise o uso e o desempenho das APIs em sua instância do Gerenciamento de API em várias dimensões, inclusive:
- Hora
- painel Geografia do app's selecionado
- APIs
- Operações de API
- Produtos
- Assinaturas
- Usuários
- Requests
Observação
- A análise de API fornece dados sobre solicitações, incluindo solicitações com falha e não autorizadas.
- Os valores de geografia são aproximados com base no mapeamento de endereço IP.
- Pode haver um atraso na disponibilidade de dados de análise.
Painel de controle baseado no Azure Monitor
Para usar o painel baseado no Azure Monitor, você precisa de um workspace do Log Analytics como fonte de dados para logs de gateway de Gerenciamento de API.
Se precisar configurar um, veja a seguir as etapas resumidas para enviar logs de gateway para um workspace do Log Analytics. Para obter mais informações, consulte Tutorial: Monitorar as APIs publicadas. Essa é uma configuração que só precisa ser realizada uma vez.
- No portal do Azure, navegue até a instância do Gerenciamento de API.
- No menu à esquerda, em Monitoramento, selecione Configurações de diagnóstico>+ Adicionar configuração de diagnóstico.
- Digite um nome descritivo para a configuração de diagnóstico.
- Em Logs, selecione Logs relacionados ao ApiManagement Gateway.
- Em Detalhes do destino, selecione Enviar para o Log Analytics e selecione um workspace do Log Analytics na mesma assinatura ou em outra. Se precisar criar um espaço de trabalho, consulte Criar um workspace do Log Analytics.
- Verifique se Recurso específico esteja selecionado como tabela de destino.
- Selecione Salvar.
Importante
Um novo workspace do Log Analytics pode levar até 2 horas para começar a receber dados. Um workspace existente deve começar a receber dados em aproximadamente 15 minutos.
Acessar o painel
Depois que um workspace do Log Analytics estiver configurado, acesse o painel baseado no Azure Monitor para analisar o uso e o desempenho de suas APIs.
- No portal do Azure, navegue até a instância do Gerenciamento de API.
- No menu à esquerda, em Monitoramento, selecione Análises. O painel de análise é aberto.
- Selecione um intervalo de tempo para os dados.
- Selecione uma categoria de relatório para os dados de análise, como Linha do tempo, Geografia e assim por diante.
Análise incorporada herdada
Em determinadas camadas de serviço de Gerenciamento de API, a análise interna (também chamada de análise herdada ou análise clássica) também está disponível no portal do Azure e os dados de análise podem ser acessados usando a API REST de Gerenciamento de API.
Análise integrada - portal
Para acessar a análise interna (clássica) no portal do Azure:
- No portal do Azure, navegue até a instância do Gerenciamento de API.
- No menu à esquerda, em Monitoramento, selecione Análise (clássico).
- Selecione um intervalo de tempo para os dados ou insira um do tipo personalizado.
- Selecione uma categoria de relatório para os dados de análise, como Linha do tempo, Geografia e assim por diante.
- Opcionalmente, filtre o relatório por uma ou mais outras categorias.
Análises - API REST
Use as operações de Relatórios na API REST do Gerenciamento de API para recuperar e filtrar os dados de análise de sua instância do Gerenciamento de API.
As operações disponíveis retornam os registros de relatório por API, geografia, operações de API, produto, solicitação, assinatura, tempo ou usuário.
Conteúdo relacionado
- Para obter uma introdução aos recursos do Azure Monitor no Gerenciamento de API, consulte Tutorial: monitorar APIs publicadas
- Para saber mais sobre monitoramento e logs de HTTP detalhados, consulte Monitorar suas APIs com o Gerenciamento de API do Azure, os Hubs de Eventos e o Moesif.
- Saiba como integrar o Gerenciamento de API do Azure ao Azure Application Insights.
- Saiba mais sobre a Desativação do painel de análise de API interna (março de 2027)