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 projetos A e B do Google Cloud e suponha que um aplicativo hospedado pelo projeto B faça uma chamada em um aplicativo hospedado pelo projeto A. Se você abrir o console do Google Cloud e selecionar o projeto A, só poderá ver 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ê tiver um projeto do Google Cloud que não faz parte de uma organização, ele poderá ser movido para sua organização. Para mais detalhes, consulte Como migrar projetos atuais.

  2. Para ter as permissões necessárias para visualizar rastros em vários projetos, peça ao administrador para conceder a você os seguintes papéis do IAM nos seus 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 essa função 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

Depois de concluir as etapas de configuração, para ver os rastros 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 em que você quer acessar os dados de rastreamento. Por exemplo, selecione o projeto A.

    A página Trace Explorer é 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 na tabela ou insira 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 para visualizar, mesmo que estejam em projetos diferentes do Google Cloud na mesma organização.

A seguir