Visualizar traces em projetos

Neste documento, descrevemos como visualizar todos os períodos de um trace em um único contexto, quando eles 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 do Google Cloud A e B 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 visualizar 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 quando ele faz uma chamada no projeto A no contexto do projeto A, use o capability entre projetos do Trace. Ao usar esse recurso, ao visualizar dados de trace do projeto A, também é possível visualizar os períodos gerados pelo projeto B ao realizar as chamadas para o 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, é possível movê-lo para sua organização. Para mais detalhes, consulte Como migrar projetos atuais.

  2. Para receber 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ê recebeu 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 receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

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

    Para forçar o rastreamento das solicitações entre projetos, anexe um cabeçalho de contexto de trace à solicitação.

Visualizar detalhes do trace em projetos

Depois de concluir as etapas de configuração, para visualizar traces 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, é possível selecionar 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 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 quando eles estão em projetos diferentes do Google Cloud que estão na mesma organização.

A seguir