Esta página aplica-se ao Apigee e ao Apigee Hybrid.
Veja a documentação do
Apigee Edge.
A vista de investigação da monitorização da API apresenta tabelas dinâmicas de métricas e atributos para todo o tráfego da API, para ajudar a comparar a atividade de diferentes métricas.
Para aceder à vista Investigar, siga os passos em Aceder à monitorização de APIs e selecione Investigar.
A figura abaixo mostra a IU com a opção Investigar selecionada.
Por predefinição, a vista Investigar apresenta três tabelas:
- Código de falha por tempo
- Código de falha por código de estado
- Origem da falha por proxy
Tal como na vista Linha cronológica, pode selecionar qualquer combinação de tabelas no menu Gráficos para apresentar. Todas as outras opções de gráficos são iguais às da vista Linha cronológica.
Cada célula numa tabela mostra o número de respostas para um subconjunto dos dados. Por exemplo, veja as três primeiras colunas da tabela Código de falha por hora.
A primeira célula na linha 1 mostra o número de respostas (444) com o código de falha steps.json2xml.SourceUnavailable que foram devolvidas de 18:18 - 18:24 na data selecionada.
A primeira célula na linha 2 mostra o número de respostas (64) no mesmo intervalo de tempo para o qual o código de falha não foi definido por algum motivo.
Para saber mais acerca deste código de falha específico, consulte o artigo Resolução de problemas de erros de tempo de execução da política de JSON para XML.
Códigos de estado 2xx
Os pedidos que devolvem um código de estado 2xx foram recebidos e compreendidos com êxito. Normalmente, a maioria dos pedidos devolve um código de estado 2xx. Se tiver interesse principalmente em ver dados de pedidos sem êxito, pode querer restringir os dados apresentados a pedidos com códigos de estado diferentes de 2xx, para facilitar a interpretação dos dados. Para o fazer, ative/desative o botão Mostrar código de estado 2xx na parte superior direita da vista Investigar.
Com esta definição, a vista Investigar apresenta apenas dados de pedidos com códigos de resposta diferentes de 2xx.
Ver a distribuição dos dados das células
Pode obter uma vista mais detalhada dos dados de uma célula individual da tabela clicando na célula. Apresenta a distribuição dos dados das células por vários atributos diferentes.
Para ver um exemplo disto, selecione primeiro Região no menu Gráficos para apresentar a tabela apresentada abaixo.
Nos dados deste exemplo, existe apenas uma região, us-central1.
Se existissem dados para outras regiões, veria linhas adicionais na tabela.
Agora, clique na primeira célula da tabela.
São apresentadas várias tabelas no painel do lado direito da vista Investigar. A primeira tabela é apresentada abaixo.
A parte superior do painel apresenta as condições que especificam os dados da célula, neste caso, a região e o intervalo de tempo.
Abaixo, a tabela "Distribuição por código de falha" apresenta o número de respostas para cada código de falha nos dados. Neste exemplo, existem apenas dois valores de código de falha:
| Código de falha | Contagem |
|---|---|
steps.json2xml.SourceUnavailable |
432 |
not set |
64 |
As contagens dos códigos de falhas totalizam 496, a contagem total na célula.
Como outro exemplo, desloque a página para baixo no painel do lado direito até chegar à tabela com a etiqueta "Distribuição por código de estado", conforme mostrado abaixo.
Neste caso, existem dois códigos de estado nos dados:
500:432200:64
| Código de estado | Contagem |
|---|---|
500 |
432 |
200 |
64 |
Mais uma vez, as contagens totalizam 496.
Usar a vista Investigar para diagnosticar um problema
Pode usar a vista Investigar para diagnosticar problemas de API. Por exemplo, suponhamos que recebe um alerta que indica que a taxa de erros 5xx excede o limite especificado. Para investigar este problema, pode realizar as seguintes tarefas na vista Investigar:
- Veja a tabela CÓDIGO DE FALHA POR HORA para ver a atividade do código de falha na última hora.
- Consulte a tabela CÓDIGO DE FALHA POR CÓDIGO DE ESTADO para identificar códigos de estado HTTP específicos associados aos códigos de falha cujas contagens aumentaram na última hora, conforme identificado no passo anterior.
- Veja a matriz FAULT CODE BY PROXY para identificar os proxies de API que estão a acionar os códigos de falha identificados no passo anterior.
- Configure um alerta para ajudar a diagnosticar o problema.