Visualizar traces em projetos

Este documento descreve como visualizar todos os períodos de um trace em um único contexto, quando esses períodos são gerados por aplicativos armazenados em diferentes projetos do Google Cloud em uma organização.

Considere o caso em que você tem os projetos do Google Cloud A e B. supor que um aplicativo hospedado pelo projeto B faz uma chamada um aplicativo hospedado pelo projeto A. Se você abrir o console do Google Cloud e selecionar o projeto A: só é possível visualizar os períodos de trace gerados pelos aplicativos hospedados pelo projeto A. Com a configuração padrão, não é possível conferir os períodos de trace gerados pelo projeto B quando ele faz uma chamada no projeto A.

Para conferir os períodos de trace gerados pelo projeto B quando ele faz uma chamada no projeto A do contexto do projeto A, use o recurso entre projetos do Trace. Ao usar esse recurso, quando você está visualizando os dados de trace do projeto A, também é possível conferir os períodos gerados pelo projeto B quando ele realiza as chamadas no projeto A.

Configurar projetos, permissões e aplicativos

Siga estas etapas de configuração:

  1. Associe cada um dos seus projetos do Google Cloud à mesma organização.

    • Se você criar um novo projeto no contexto da organização, ele será criado automaticamente no recurso da organização.

    • Se você tem um projeto do Google Cloud que não faz parte de uma organização, você poderá movê-lo para sua organização. Para mais detalhes, consulte Migração de projetos existentes.

  2. Para ter as permissões necessárias para visualizar traces em projetos, peça ao administrador para conceder a você seguintes papéis do IAM nos projetos ou na organização:

    • Usuário do Cloud Trace (roles/cloudtrace.user) em cada projeto.
    • Leitor do Logging (roles/logging.viewer) em cada projeto.
    • Leitor da organização (roles/resourcemanager.organizationViewer) na organização. Você recebeu esse papel quando o seletor de projetos inclui uma lista de organizações.

    Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

  3. Configure seus aplicativos para gravar traces nos projetos em que eles estão hospedados.

    Para forçar uma solicitação entre projetos a ser rastreada, anexe um cabeçalho de contexto de trace à solicitação.

Conferir detalhes de trace em projetos

Para visualizar traces depois de concluir as etapas de configuração, em projetos do Google Cloud, faça o seguinte:

  1. No console do Google Cloud, acesse a página Explorador de traces:

    Acessar o Explorador de traces

    Também é possível encontrar essa página usando a barra de pesquisa.

    Selecione o projeto para ver os dados de trace. Por exemplo: selecione o projeto A.

    A página Explorador de traces é aberta e mostra um gráfico de dispersão e uma tabela que mostram os traces mais recentes.

  2. Para analisar um trace específico, selecione-o no gráfico de dispersão ou tabela ou digite o ID dele no campo ID do trace.

    O painel Detalhes do trace é aberto e mostra todos os períodos que você tem permissão de visualização, mesmo quando esses períodos estão em diferentes projetos do Google Cloud na mesma organização.

A seguir