Observabilidade no Gerenciamento de API do Azure
APLICA-SE A: todas as camadas do Gerenciamento de API
A observabilidade é a capacidade de entender o estado interno de um sistema por meio dos dados que ele produz, bem como analisar os dados para entender o que aconteceu e por quê.
O Gerenciamento de API do Azure ajuda as organizações a centralizar o gerenciamento de todas as APIs. Como ele é como um ponto único de entrada de todo o tráfego das APIs, é um lugar ideal para observá-las.
Visão geral
O Gerenciamento de API do Azure permite que você escolha usar o gateway gerenciado ou o gateway auto-hospedado, seja auto-implantado, seja usando uma extensão do Azure Arc.
A tabela a seguir resume todos as funcionalidades de observabilidade com suporte do Gerenciamento de API para operar APIs e os modelos de implantação aos quais eles oferecem suporte. Esses recursos podem ser usados por editores de API e outros que têm permissões para operar ou gerenciar a instância do Gerenciamento de API.
Observação
Para consumidores de API que usam o portal do desenvolvedor, um relatório de API interno está disponível. Ele fornece apenas informações sobre o uso de API individual durante os 90 dias anteriores. Atualmente, o relatório de API interno não está disponível no portal do desenvolvedor para as camadas de serviço v2.
| Ferramenta | Útil para | Atraso de dados | Retenção | amostragem | Tipo de dados | Modelo(s) de implantação com suporte |
|---|---|---|---|---|---|---|
| Inspetor de API | Testando e depurando | Instantâneo | Últimos 100 rastreamentos | Ativado por solicitação | Rastreamentos de solicitação | Gerenciado, auto-hospedado, Azure Arc |
| Análise integrada | Relatórios e monitoramento | minutos | Tempo de vida | 100% | Relatórios e logs | Gerenciado |
| Métricas do Azure Monitor | Relatórios e monitoramento | minutos | 90 dias (atualize para estender) | 100% | Métricas | Gerenciado, auto-hospedado2, Azure Arc |
| Logs do Azure Monitor | Relatórios, monitoramento e depuração | minutos | 31 dias/5 GB (atualize para estender) | 100 % (ajustável) | Logs | Gerenciado1, auto-hospedado3, Azure Arc3 |
| Azure Application Insights | Relatórios, monitoramento e depuração | Segundos | 90 dias/5 GB (atualize para estender) | Personalizado | Logs, métricas | Gerenciado1, auto-hospedado1, Azure Arc1 |
| Log por meio dos Hubs de Eventos do Azure | Cenários personalizados | Segundos | Usuário gerenciado | Personalizado | Personalizado | Gerenciado1, auto-hospedado1, Azure Arc1 |
| OpenTelemetry | Monitoramento | minutos | Usuário gerenciado | 100% | Métricas | Auto-Hospedado2 |
1. Opcional, dependendo da configuração do recurso no Gerenciamento de API do Azure
2. Opcional, dependendo da configuração do gateway
3. Atualmente, o gateway auto-hospedado não envia logs de diagnóstico ao Azure Monitor. No entanto, é possível configurar e manter os logs localmente onde o gateway auto-hospedado está implantado. Para mais informações, consulte configurar métricas e logs locais no gateway auto-hospedado
Próximas etapas
- Introdução às métricas e aos logs do Azure Monitor
- Saiba como registrar solicitações no Application Insights
- Saiba como registrar eventos por meio dos Hubs de Eventos
- Saiba mais sobre como visualizar dados do Azure Monitor usando o Espaço Gerenciado do Azure para Grafana