Visão geral do Debug

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

Confira a documentação da Apigee Edge.

O Debug é uma ferramenta de solução de problemas e monitoramento de proxies de API em execução na Apigee. A ferramenta Debug permite que você examine os detalhes de cada etapa por meio de um fluxo de proxy da API. A Apigee permite coletar dados de depuração, que mostram todo o fluxo de solicitação/resposta dos proxies da API. Isso inclui todos os parâmetros de solicitação/resposta e as transformações aplicadas a eles no tempo de execução da política. Isso é importante para a depuração e a solução de problemas durante o desenvolvimento e a implantação do proxy de API.

Coleta e transmissão de dados de depuração

Os nós de gateway da Apigee coletam dados da sessão de depuração e os armazenam em cache internamente, antes de transmitir esses dados para o plano de controle na nuvem. De lá, ele é compartilhado com a UI da sessão de depuração para que os operadores analisem.

Se você usar o mascaramento de depuração, a Apigee vai realizar o mascaramento nos nós de gateway antes de transmitir os dados de depuração para o plano de controle.

Como usar a depuração

Crie e gerencie sessões de depuração usando a ferramenta Debug usando a IU ou a API, conforme descrito em Como usar o Debug. Também é possível fazer o download de sessões de depuração, visualizar e analisá-las off-line, conforme descrito em Como usar o Debug Off-line.

Uso do Debug do suporte da Apigee

Only customers can trigger a debug session, but Apigee Support can access non-deleted past debug sessions during the course of a support case to help troubleshoot proxy-specific issues.

Note the following:

  • Apigee Support has read-only permission to Debug data.
  • Apigee Support may request that you run a debug to capture information about an issue, and that you provide the debug session ID or a link to the debug session so that Support may review the captured debug. Since saved debug sessions are valid for only 24 hours, we recommend that you download the debug session and attach it to the case opened with Support to enable offline viewing.

Para usuários da Apigee híbrida

Se você estiver usando a Apigee híbrida, leia as seções a seguir.

Arquitetua do Debug

O exemplo a seguir ilustra o processo de criação de uma nova sessão de depuração:

Visualização de alto nível de uma solicitação para iniciar uma sessão de depuração: 1 Você inicia uma solicitação para começar uma sessão de depuração com a IU ou a API. 2. O plano de gerenciamento emite uma solicitação de criação de sessão de depuração para o plano de execução usando o modelo pub/sub. 3. O sincronizador, que se inscreve para depurar notificações da sessão, propaga a solicitação de criação para os processadores de mensagens. 4. Os MPs coletam dados de depuração e os transmitem para um pod de coleta de dados. 5. O fluentd grava imediatamente os dados de depuração no sistema de arquivos do pod. 6. A UDCA pesquisa novos arquivos de dados no sistema de arquivos do pod. 7. Quando encontra um novo arquivo de dados, a UDCA faz upload dele para o serviço UAP. 8. É possível acessar os dados por meio dos serviços da Apigee, como a IU híbrida da Apigee ou as APIs da Apigee.

Os dados de Debug são mantidos no plano de gerenciamento por até 24 horas.

Requisitos da Apigee híbrida

Esta seção lista informações importantes para usuários da Apigee híbrida.

Suporte à residência de dados

As versões mais antigas da Apigee híbrida não oferecem suporte para residência de dados.

Outros requisitos