Esta página aplica-se ao Apigee e ao Apigee Hybrid.
Veja a documentação do
Apigee Edge.
A monitorização de APIs da Apigee, as estatísticas de APIs da Apigee e os registos de acesso da Apigee são três ferramentas poderosas que pode usar para recolher, observar e compreender os dados de utilização das suas APIs. Cada uma destas ferramentas oferece estatísticas diferentes e é recomendada para diferentes exemplos de utilização. Este documento oferece uma breve vista geral da finalidade de cada ferramenta e da respetiva utilização recomendada, conforme descrito nas secções seguintes:
Monitorização de APIs
O objetivo da monitorização de APIs é fornecer estatísticas em tempo real sobre o desempenho das APIs, para que possa diagnosticar e corrigir rapidamente problemas para manter as suas APIs a funcionar conforme previsto.
A Monitorização de APIs fornece dados agregados dos seus proxies de API a cada minuto, o que lhe permite monitorizar atentamente o estado e o desempenho das suas APIs. Pode usar a monitorização de APIs para configurar alertas quase em tempo real em parâmetros especificados e tirar partido dos dados agregados durante a resolução de problemas.
A API Monitoring permite-lhe:
- Manter a disponibilidade das suas APIs.
- Tome medidas com base em alertas antes que os consumidores sejam afetados.
- Use códigos de falhas do Apigee para acelerar o diagnóstico de problemas.
- Isole rapidamente as áreas problemáticas para diagnosticar a origem dos problemas de desempenho e latência.
Os clientes do Apigee também podem usar as ferramentas do Cloud Monitoring para suportar a monitorização de APIs. Se quiser fazer a integração com outros sistemas de monitorização, recomendamos que use a API Monitoring para extrair métricas.
Dados de latência quando usa a monitorização de APIs
Uma vez que a monitorização de APIs foi intencionalmente concebida para ser escalável, não regista todas as medições de latência individuais em cada transação. Em alternativa, são usados intervalos de distribuição para medir as latências. Os intervalos de latência usam intervalos predefinidos para agrupar os valores de latência observados.
Para saber mais sobre a utilização da API Monitoring para as suas APIs, consulte a vista geral da API Monitoring.
Para saber mais sobre como usar o Monitoring juntamente com o Apigee para configurar alertas, consulte o artigo Configurar alertas e notificações.
API Apigee do Analytics
O Apigee API Analytics fornece uma análise de tendências do histórico e relatórios detalhados para metadados de chamadas API. O objetivo do Apigee Analytics é ajudar a compreender as tendências a longo prazo do tráfego da sua API, para que possa garantir que as APIs estão a suportar os requisitos da sua empresa ou fazer alterações, se necessário.
Com o Apigee API Analytics, pode escolher entre aproximadamente 50 dimensões disponíveis que especificam os dados que quer capturar para cada chamada de API processada por um proxy. Em seguida, pode criar relatórios personalizados para determinar como as métricas da API específicas mudam ao longo do tempo.
Os dados de estatísticas capturados são armazenados no BigQuery. Pode usar o Apigee API Analytics para criar relatórios personalizados no Looker Studio, configurar tarefas de relatórios personalizados assíncronos ou exportar dados de estatísticas para o seu próprio Google Cloud repositório de armazenamento, como o BigQuery.Se começar com os preços de pagamento conforme o uso, o API Analytics é um suplemento opcional.
Seguem-se algumas das tendências que pode identificar através do Apigee Analytics:
- Qual é a tendência do tráfego da API ao longo do tempo?
- Quais são as suas principais apps?
- Quem são os seus principais programadores?
- Quando é que o tempo de resposta da API é mais rápido ou mais lento?
- Que regiões geográficas têm o maior tráfego da API?
Dados de latência quando usa a API Apigee Analytics
A latência observada no Apigee API Analytics usa uma função de agregação de quantil aproximado em registos individuais armazenados no BigQuery. Isto torna os dados resultantes relativos à latência mais precisos em comparação com a lógica de agrupamento usada na monitorização de APIs. A latência na monitorização de APIs e nas estatísticas de APIs do Apigee é medida a partir do tempo de execução do Apigee e não inclui cálculos de latência de saltos de rede anteriores, incluindo o Istio.
Para saber mais sobre a API Apigee do Analytics, consulte o artigo Vista geral da API Apigee do Analytics.
Registos de acesso do Apigee
Os registos de acesso do Apigee podem ser usados para resolver problemas de chamadas API para o Apigee e identificar que APIs estão a devolver códigos de resposta HTTP específicos.
Os registos de acesso do Apigee capturam registos por transação no gateway de entrada para o Apigee. Isto permite-lhe filtrar registos com base em códigos HTTP específicos e resolver facilmente casos extremos, como um código de estado da resposta de 0 no Istio.
Para saber como usar os registos de acesso do Apigee para resolver problemas com as suas APIs, consulte o artigo Registos de acesso do Apigee.
Diferenças entre os dados apresentados pelos dados de monitorização da API e o Analytics
A monitorização de APIs e a API Apigee Analytics usam pipelines diferentes para aceder aos dados da API. Como resultado, pode ver algumas discrepâncias entre os dados apresentados pelos painéis de controlo do Apigee API Analytics e os dados disponíveis na API Monitoring.
Atualidade e precisão
Em geral, os dados apresentados pelo Apigee API Analytics são mais precisos, mas podem ter um ligeiro atraso (inferior a uma hora) em comparação com os dados apresentados pela API Monitoring.
Retenção de dados
A API Apigee Analytics retém dados durante um período mais longo do que a API Monitoring, o que a torna mais adequada para a análise de tendências a longo prazo.
Os períodos de retenção de dados para o Analytics e a monitorização de APIs são os seguintes:
Google Analytics
- Padrão: 60 dias
- Empresarial: 90 dias
- Enterprise +: 14 meses
Monitorização de APIs: 1 mês