Ver dados da mensagem com a ferramenta de depuração

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

Confira a documentação da Apigee Edge.

O que você vai aprender

Neste tutorial, você aprenderá a:

• Ver os cabeçalhos e o conteúdo do corpo da mensagem da resposta.
• Ver mensagens de erro.

Pré-requisitos

• Antes de começar, conclua as etapas em Visão geral e pré-requisitos.
• Pelo menos uma política no proxy.
• curl instalado na máquina para fazer chamadas de API a partir da linha de comando.

Ver dados da mensagem

A visualização de depuração no editor de proxy da Apigee permite visualizar cabeçalhos, variáveis, objetos e outros detalhes, como o tempo de resposta na solicitação de proxy de API e no fluxo de resposta. A ferramenta de depuração também permite ver como uma solicitação ou uma resposta é alterada conforme é processada por um proxy de API. Para ver uma descrição mais detalhada da visualização de depuração, consulte Como usar a depuração.

No tutorial anterior, você restringiu o número de solicitações com a política SpikeArrest. Esta página descreve como usar a visualização de depuração para ver o que acontece quando essa taxa é excedida.

Observação: a Apigee está introduzindo uma nova versão do Editor de proxy, que facilitará o gerenciamento de proxies.

As instruções nas duas primeiras guias abaixo explicam como usar o novo Editor de proxy ou o Proxy Editor clássico.

Novo Editor de Proxy

1. Na guia Desenvolver do proxy da API, edite o <Rate> da política do Speike Arrest para 1pm e depois clique em Salvar o proxy. Com isso, você poderá ver chamadas de API bem-sucedidas e com falha (acima do limite).
2. No editor de proxy, clique na guia Depuração.
3. Clique em Iniciar sessão do Debug.

Na caixa de diálogo, faça o seguinte:

1. Selecione o Ambiente em que você quer executar a sessão de depuração.
2. Opcional: na lista suspensa Filtrar, selecione um filtro a ser aplicado a todas as transações na sessão de depuração que você está criando. O padrão é None (All transactions), que inclui todas as transações nos dados de depuração.

   Para informações sobre o uso de filtros, consulte Como usar filtros em uma sessão de depuração. Para informações sobre os filtros integrados, consulte Como usar filtros predefinidos.

3. Clique em Iniciar.

4. Chamar o proxy de API novamente usando curl (ou o URL em um navegador da Web) várias vezes até ver pelo menos uma resposta 200 e Uma resposta 429 no painel à esquerda.

   

   Observação: o código de status HTTP padrão para exceder o limite de taxa é 429 Too many requests.
5. Clique na transação 429 no painel Transações à esquerda. Isso exibirá um gráfico de Gantt para a transação no painel à direita.

   

   Observe que há uma linha para a política Spike Arrest, que é exibida com um ícone de erro.

6. Clique na linha Erro. Os detalhes do erro serão exibidos à direita do gráfico. A imagem abaixo mostra a seção Propriedades dos detalhes do erro:

   

Você pode clicar nos botões Voltar e Próxima abaixo do gráfico "Gannt" para alternar entre as etapas no fluxo e ver os detalhes de cada uma.

Para fazer o download de toda a sessão de depuração como um único documento, clique em Fazer o download da sessão. Uma sessão de depuração é excluída em até 24 horas após a conclusão. Portanto, se você quiser visualizá-la depois desse período, precisará fazer o download dela antes disso.

Editor de Proxy clássico

1. Na guia Desenvolver do proxy da API, edite o <Rate> da política do Speike Arrest para 1pm e depois clique em Salvar o proxy. Com isso, você poderá ver chamadas de API bem-sucedidas e com falha (acima do limite).
2. No editor de proxy, clique na guia Depuração.
3. Em Iniciar uma sessão de depuração, selecione o ambiente em que seu proxy está implantado.
4. Clique em Iniciar sessão do Debug.

5. Chame o proxy de API novamente usando curl (ou a URL em um navegador da Web) até ver pelo menos uma resposta 200 e uma 429 no painel Transações de depuração.

   curl -v https://YOUR_ENV_GROUP_HOSTNAME/my-proxy

   em que YOUR ENV_GROUP_HOSTNAME é o nome do host do grupo de ambiente. Consulte Encontrar o nome do host do grupo de ambientes.

   As respostas 200 e 429 são mostradas abaixo.

   

   Observação: o código de status HTTP padrão para exceder o limite de taxa é 429 Too many requests.

   Se você quiser que o código de status seja diferente (500, por exemplo) para todas as políticas do Spike Arrest usadas em uma organização, será preciso definir uma propriedade na organização. Se você for cliente do Cloud, entre em contato com o Suporte do Google Cloud para definir essa propriedade.

6. Clique na transação 200 no painel Transações à esquerda. Os detalhes da depuração são carregados na janela principal do Mapa de transações, que mostra um diagrama de solicitação/resposta. O ícone do Spike Arrest está no fluxo de solicitação.
7. No diagrama de fluxo, clique no ícone de círculo na resposta, o mais à direita (mostrado no diagrama a seguir).

   O painel Detalhes da fase mostra os dados disponíveis nesse ponto do fluxo. Ao rolar o painel, você verá os cabeçalhos de resposta HTTP e o conteúdo do corpo.

8. Agora veja um erro na depuração.

   Clique na transação 429 no painel "Transações". Na janela principal do editor, você vê um diagrama de fluxo com itens somente na solicitação, incluindo um ícone de detenção de pico com um ponto de exclamação vermelho indicando um erro.

   Clique no pequeno tubo ícone de erro à direita do ícone "Detenção de pico" e observe os detalhes da violação de detenção de pico no painel Detalhes da fase.

   

Clique nos botões Voltar e Avançar no diagrama de fluxo para se mover entre os pontos no fluxo e ver os detalhes da depuração.

Se você quiser ver toda a sessão de depuração como um único documento, faça o download clicando em Fazer o download da sessão de depuração.

Para mais informações, consulte Como usar a depuração.