Visualizar traces em projetos

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

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

Para conferir os períodos de trace gerados pelo projeto B ao fazer uma chamada para o projeto A no contexto do projeto A, use o recurso entre projetos do Trace. Ao usar esse recurso, ao visualizar dados de trace do projeto A, você também poderá conferir os períodos gerados pelo projeto B quando ele executar 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, será possível movê-lo para sua organização. Para mais detalhes, consulte Como migrar projetos atuais.

  2. Para ter as permissões necessárias para visualizar traces nos projetos, peça ao administrador para conceder a você os 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ê recebe esse papel quando o seletor de projetos inclui uma lista de organizações.

    Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

    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 solicitações entre projetos a serem rastreadas, anexe um cabeçalho de contexto de trace à solicitação.

Visualizar detalhes de traces entre projetos

Depois de concluir as etapas de configuração, para visualizar traces nos projetos do Google Cloud, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Trace e, em seguida, Trace Explorer:

    Acessar o Explorador de traces

    Selecione o projeto com os dados de trace que você quer visualizar. Por exemplo, é possível selecionar o projeto A.

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

  2. Para explorar um trace específico, selecione o trace do gráfico de dispersão ou da tabela ou insira o código no campo ID do trace.

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

A seguir