Desempenho do proxy da API

Esta página se aplica à Apigee e à Apigee híbrida.

Confira a documentação da Apigee Edge.

O que esse painel informa?

O painel "Desempenho do proxy" ajuda a ver padrões de tráfego do proxy de API e tempos de processamento. É possível visualizar facilmente quanto do tráfego suas APIs geram e quanto tempo leva para que as chamadas de API sejam processadas, desde o momento em que são recebidas pela Apigee até o retorno ao aplicativo cliente.

Painel de desempenho do proxy

Acesse o painel de desempenho do proxy, conforme descrito abaixo.

Para acessar o painel de desempenho do proxy:

Se você usar oIU da Apigee no Console do Cloud: selecione Analytics > Métricas da API e clique no Desempenho de proxy de API.
Se você estiver usando a interface clássica da Apigee: selecione Analisar > Métricas de API > Desempenho do proxy de API.

O painel Métricas de API é aberto com a guia Desempenho do proxy de API selecionada, conforme mostrado abaixo:

O que esse painel mede?

O painel inclui estes gráficos:

Tráfego
Tempo médio de resposta
Tráfego por proxy
Tempo médio de resposta por proxy

Observação: esse valor de client.received.start.timestamp é usado para calcular as métricas de tráfego dos proxies da API nos painéis de análise. Para mais informações, consulte a referência de variável do fluxo do cliente.

Tráfego

Métrica	Descrição
Tráfego total	O número total de solicitações de API recebidas pela Apigee para um ambiente de API em uma organização.
Sucesso do tráfego	O número total de solicitações que resultaram em uma resposta bem-sucedida. As respostas de erro não são contabilizadas.
Erros de tráfego	O número total de todas as solicitações da API que não são bem-sucedidas, ou seja, a solicitação não fornece uma resposta conforme esperado pelo usuário final. A contagem inclui erros de proxy e de destino.
TPS médio	O número médio de solicitações de API e as respostas resultantes por segundo.

Tempo médio de resposta

Veja também este artigo interessante no site da comunidade da Apigee (em inglês): Quando o tempo total de resposta total pode ser menor que o tempo médio de resposta?

Métrica	Descrição
Tempo médio de resposta	A média do tempo total de resposta medido para todas as chamadas de API feitas para um ambiente de organização da Apigee. O tempo total de resposta é o tempo necessário para uma chamada de API ser retornada à Apigee (em milissegundos). Ou, de outra forma, o tempo total de resposta é o tempo medido desde o momento em que uma chamada de API inteira é recebida na Apigee até o momento em que a Apigee começa a enviar uma resposta de volta para o aplicativo cliente. Esse gráfico mede a média de todos os proxies. Para proxies individuais, consulte o gráfico "Tempo médio de resposta por proxy" abaixo.
Tempo médio de resposta por proxy	Esse valor é calculado como a média do Tempo de resposta total menos o tempo de resposta de destino para todas as chamadas de API feitas para um ambiente de organização da Apigee. É basicamente uma medida do tempo que as chamadas de API passam fluindo pela Apigee (em milissegundos).
Tempo médio de resposta do destino	O número médio de milissegundos que leva do ponto em que o último byte de uma solicitação é enviado da Apigee para um destino de back-end até o momento em que a Apigee recebe o último byte da resposta. Ela basicamente mede quanto tempo a chamada de API gasta no sistema de destino.

Métrica

Descrição

Tempo médio de resposta

A média do tempo total de resposta medido para todas as chamadas de API feitas para um ambiente de organização da Apigee. O tempo total de resposta é o tempo necessário para uma chamada de API ser retornada à Apigee (em milissegundos).

Ou, de outra forma, o tempo total de resposta é o tempo medido desde o momento em que uma chamada de API inteira é recebida na Apigee até o momento em que a Apigee começa a enviar uma resposta de volta para o aplicativo cliente.

Esse gráfico mede a média de todos os proxies. Para proxies individuais, consulte o gráfico "Tempo médio de resposta por proxy" abaixo.

Tempo médio de resposta por proxy

Esse valor é calculado como a média do Tempo de resposta total menos o tempo de resposta de destino para todas as chamadas de API feitas para um ambiente de organização da Apigee.

É basicamente uma medida do tempo que as chamadas de API passam fluindo pela Apigee (em milissegundos).

Tempo médio de resposta do destino

O número médio de milissegundos que leva do ponto em que o último byte de uma solicitação é enviado da Apigee para um destino de back-end até o momento em que a Apigee recebe o último byte da resposta.

Ela basicamente mede quanto tempo a chamada de API gasta no sistema de destino.

O tempo médio de resposta do proxy é calculado como a diferença entre as médias do tempo de resposta total e do tempo de resposta pretendido. A expectativa é que o tempo de resposta total seja sempre maior que o tempo de resposta desejado. No entanto, há também chamadas que são processadas pelo próprio proxy: solicitações simuladas, respostas em cache, tokens OAuth etc. que não chegam ao sistema de back-end. Essas chamadas "mais rápidas" feitas pelo proxy reduzem o Tempo médio total de resposta sem reduzir o tempo de resposta de destino. Portanto, o tempo de resposta total médio nem sempre é maior do que o tempo de resposta desejado, o que pode resultar em valores negativos para o tempo de resposta de proxy. Quando você analisa TPS maiores sem aumentar muito o zoom na escala de tempo, essas exceções não têm muito peso e, portanto, fornecem dados mais precisos e acionáveis.

Os dados de resposta média mais significativos são obtidos quando um grande número de solicitações é coletado por um longo período, em vez de apenas algumas solicitações coletadas em um curto período. Se você observar apenas um pequeno número de solicitações que chegam em um curto período, ainda há uma chance de que mesmo uma chamada que não vá para o alvo resulte em um tempo médio de resposta do proxy negativo. Ao avaliar os tempos médios de resposta, é melhor visualizar períodos mais longos com tráfego alto.

Tráfego por proxy

Métrica	Descrição
*<Nome do proxy>*	Para o proxy de API especificado, o número de solicitações e respostas de API registradas.

Tempo médio de resposta por proxy

Métrica	Descrição
*<Nome do proxy>*	Para o proxy de API especificado, a média do tempo total de resposta medido para todas as chamadas de API feitas para um ambiente da Apigee. O tempo total de resposta é o tempo que uma chamada de API leva para a Apigee retornar (em milissegundos). Passe o cursor sobre o gráfico para ver a quantidade total de tempo gasto no lado do proxy e do lado do destino, bem como a média.