Usar a depuração off-line

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

Confira a documentação da Apigee Edge.

A ferramenta de depuração off-line permite ver e analisar sessões de depuração "off-line" que foram transferidas por download anteriormente na visualização Depurar no Editor de proxy. Uma sessão de depuração salva é basicamente uma "gravação" de uma sessão de depuração e pode ser útil para casos em que a solução de problemas e análises adicionais são necessárias. A IU da ferramenta de depuração off-line é semelhante à visualização Depurar no Editor de proxy.

Para saber mais sobre a IU da ferramenta de depuração e o download de sessões de depuração, consulte Como usar a depuração.

Observação:a ferramenta de depuração está disponível no console do Google Cloud, na interface clássica, e algumas ações de depuração podem ser realizadas usando a API, conforme descrito nas guias a seguir. As opções do console do Google Cloud são Debug v2 (nova) e Debug v1 (lançada em 07/01/2022). É possível alternar entre as versões da ferramenta de depuração no console do Google Cloud e na IU clássica.

Interface do Console do CloudIU clássica

Depuração v2 (novo)Depuração v1

Para ver dados de depuração salvos usando a depuração off-line, siga estas etapas:

1. Faça login no console do Google Cloud.

2. Selecione Desenvolver > Depuração off-line.

   A visualização Depuração off-line é exibida:

   

3. Para carregar dados na visualização Off-line de depuração, clique em Abrir sessão de depuração, selecione um arquivo de sessão de depuração off-line salvo anteriormente no formato JSON e clique em Abrir.

   Observação:quando você faz o download de uma sessão de depuração na visualização Depurar do Editor de proxy, o nome do arquivo de download tem o formato debug-{session ID}.json, em que {session id} é o ID da sessão de depuração. No entanto, você pode renomear o arquivo se quiser.

   A interface da Apigee carrega os dados do arquivo de depuração e exibe todas as transações na lista no painel Transactions.

   
4. Clique na linha da transação no painel Transações para mostrar a transação no Mapa de transações.

Agora, você pode explorar a sessão de depuração como faria para uma sessão de depuração recém-criada. Consulte Como criar uma sessão de depuração para mais informações.

Para ver dados de depuração salvos usando a depuração off-line, siga estas etapas:

1. Faça login no console do Google Cloud.
2. Selecione Proxies de API na visualização principal.

3. Selecione Desenvolver > Depuração off-line.

   A visualização Depuração off-line é exibida:

   

4. Para carregar dados na visualização Off-line de depuração, clique no botão Abrir sessão de depuração e selecione um arquivo de sessão de depuração off-line salvo anteriormente no formato JSON.

   Observação:quando você faz o download de uma sessão de depuração na visualização Debug do Editor de proxy, o nome do arquivo de download tem o formato "debug-{session ID}.json", em que {session id} é o ID da sessão de depuração. No entanto, você pode renomear o arquivo, se quiser.

   A interface da Apigee carrega os dados do arquivo de depuração e exibe uma nova linha para a transação no painel à esquerda.

   

5. Clique na linha da transação no painel à esquerda para exibir um gráfico de Gantt da transação.

   

Agora, você pode explorar a sessão de depuração como faria na visualização Depurar no novo Editor de proxy. Consulte a seção "Como visualizar o gráfico de Gantt para uma solicitação e uma resposta".

Para ver dados de depuração salvos usando a depuração off-line, siga estas etapas:

1. Faça login na IU da Apigee.
2. Selecione Proxies de API na visualização principal.

3. Selecione Desenvolver > Depuração off-line.

   A visualização Depuração off-line é exibida:

   

   Observe as seguintes regiões da visualização da Depuração off-line:

   • Depurar arquivo: exibe o tipo de solicitação. Use essa área para navegar entre as solicitações.
   • Opções de visualização:exibe as opções de configuração, conforme descrito em Como usar a depuração.
   • Detalhes da sessão de depuração: exibe detalhes sobre a sessão de depuração.
   • Mapa de transações:mostra o caminho da solicitação pelo proxy da API. Este caminho é conhecido como o mapa de transações. Ele mostra quais políticas foram encontradas e indica se houve algum erro durante a execução delas.
   • Detalhes da fase:mostra os cabeçalhos da solicitação selecionada.

   Ao visualizar dados de depuração na interface da Apigee, é possível alternar várias opções, por exemplo, se quer visualizar políticas que estão desativadas ou variáveis e propriedades. Para mais informações, consulte Como depurar com a ferramenta de depuração.

4. Para carregar dados na visualização Off-line Debug, clique no botão Choose File no painel à esquerda da ferramenta Off-line Debug e selecione um arquivo de sessão de trace off-line salvo anteriormente no formato JSON.

   

   Observação:não use o botão Choose File no painel à direita, porque ele não aceita arquivos JSON.

   A IU da Apigee carrega os dados do arquivo de depuração e os exibe: