Este documento descreve como pode criar e gerir um âmbito de rastreio, que permite à página Explorador de rastreios encontrar os intervalos de rastreio que quer ver ou analisar. Se só quiser ver e analisar os intervalos que têm origem no seu Google Cloud projeto, não precisa de configurar âmbitos de rastreio. No entanto, se os seus dados de rastreio estiverem armazenados em vários projetos, como pode acontecer quando usa uma arquitetura de microsserviços, tem de realizar algumas atividades de configuração para ver todos os intervalos de um único projeto Google Cloud .
Este documento não descreve como ver os seus rastreios e intervalos. Para obter informações sobre esse tópico, consulte o artigo Encontre e explore rastreios.
Esta funcionalidade só é suportada para projetos do Google Cloud . Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
Acerca dos âmbitos de rastreio
Os âmbitos de rastreio são recursos persistentes ao nível do projeto que listam um conjunto de Google Cloud projetos. Pode configurar a página Explorador de rastreios para pesquisar por âmbito de rastreio, o que significa que a página pesquisa os projetos listados no âmbito selecionado. As suas funções de gestão de identidade e de acesso (IAM) nos projetos pesquisados e a definição do intervalo de tempo determinam os dados obtidos do armazenamento e, em seguida, apresentados.
Quando cria um Google Cloud projeto, é criado um âmbito de rastreio com o nome _Default. Este âmbito inclui apenas o projeto Google Cloud . Não pode adicionar projetos a este âmbito nem eliminar este âmbito.
Pode criar âmbitos de rastreio, bem como modificar e eliminar quaisquer âmbitos de rastreio que criar. Quer criar um âmbito de rastreio quando tem um serviço que escreve dados de intervalos em vários Google Cloud projetos.
A menos que abra a página do Explorador de rastreios com um URL que inclua um âmbito de rastreio ou um ID de rastreio e intervalo, a página do Explorador de rastreios pesquisa os projetos listados no âmbito de rastreio predefinido para dados de rastreio.Google Cloud
Quando cria o projeto, o âmbito de rastreio denominado _Default é
definido como o âmbito de rastreio predefinido. No entanto, pode selecionar um âmbito de rastreio diferente para usar como âmbito de rastreio predefinido.
Aplicações do App Hub e âmbitos de rastreio
As suas aplicações do App Hub podem escrever dados de rastreio em vários projetos. Para obter uma vista agregada destes dados, crie um âmbito de rastreio, configure-o para listar todos os projetos que armazenam os seus dados de rastreio e, em seguida, configure-o como o âmbito de rastreio predefinido. Quando concluir esses passos, a página Explorador de rastreios apresenta automaticamente os dados escritos pela sua aplicação, mesmo quando esses dados estão armazenados em projetos diferentes.
Crie o âmbito do rastreio personalizado no projeto a partir do qual vai ver
os dados de registo. Este projeto é o projeto anfitrião do App Hub ou
o projeto de gestão da sua pasta com apps ativadas.
Por exemplo, se o nome a apresentar da pasta for
My Folder, o nome a apresentar do projeto de gestão é
My Folder-mp.
Antes de começar
Para receber as autorizações de que
precisa para criar e ver âmbitos de rastreio,
peça ao seu administrador para lhe conceder a função de IAM de
utilizador do Cloud Trace (roles/cloudtrace.user)
no seu projeto.
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Esta função predefinida contém as autorizações necessárias para criar e ver âmbitos de rastreio. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
São necessárias as seguintes autorizações para criar e ver âmbitos de rastreio:
-
Para criar e gerir âmbitos de rastreio:
cloudtrace.traceScopes.{create, delete, get, list, update}
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
São necessárias autorizações adicionais para definir o âmbito do rastreio predefinido. Essas autorizações estão descritas na secção Configure o âmbito do rastreio predefinido deste documento.
Apresentar âmbitos de rastreio
Consola
Para listar os âmbitos de rastreio, faça o seguinte:
-
Na Google Cloud consola, aceda à página settings Definições:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
- Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
Selecione o separador Âmbitos de rastreio.
A tabela apresenta os âmbitos de rastreio. Quando seleciona um Google Cloud projeto, é apresentada uma entrada com um ícone "Predefinição",
,
que indica que é o âmbito de rastreio predefinido.
A página Explorador de rastreios pesquisa os projetos listados no âmbito de rastreio predefinido para dados de rastreio quando a página é aberta.
Crie um âmbito de rastreio
Os intervalos apresentados na página Explorador de rastreios dependem dos projetos pesquisados, das suas funções da IAM nesses projetos, da definição do intervalo de tempo e dos filtros que aplica.
Pode criar 100 âmbitos de rastreio por projeto. Um âmbito de rastreio pode incluir um total de 20 projetos.
Consola
Para criar um âmbito de rastreio, faça o seguinte:
-
Na Google Cloud consola, aceda à página settings Definições:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
- Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
- Selecione o separador Âmbitos de rastreio e, de seguida, clique em Criar âmbito de rastreio.
Clique em Adicionar projetos e conclua a caixa de diálogo.
Quando adiciona um projeto, os intervalos armazenados nesse projeto são incluídos no âmbito do rastreio. Se não souber que projetos incluir num âmbito, pode usar a página do Explorador de rastreio antigo para ajudar a identificá-los. Para mais informações, consulte a secção Migre para âmbitos de rastreio deste documento.
Na secção Nome do âmbito do rastreio, introduza o nome e a descrição que quer apresentar no separador Âmbitos do rastreio.
Não é possível modificar o nome de um âmbito de rastreio, e este tem de ser exclusivo no projeto.
Clique em Criar âmbito do rastreio.
Migre para âmbitos de rastreio
A página Explorador de rastreios requer que especifique os Google Cloud projetos nos quais pesquisar dados de rastreio, o que representa uma alteração no comportamento em relação à página Explorador de rastreios antiga. A página Explorador de rastreios antigo pesquisa todos os projetos numa organização. Devido a estas diferenças, a página Explorador de rastreios pode não apresentar intervalos que as páginas do Explorador de rastreios antigo apresentam.
Pode usar a secção do painel Detalhes do rastreio da página do Explorador de rastreios antigo para ajudar a compilar uma lista de Google Cloud projetos que armazenam os seus dados de rastreio:
Aceda à página do Explorador de rastreios antigo:
Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
Selecione um rastreio.
Pode experimentar o seguinte:
- Ver um rastreio introduzindo o respetivo ID no campo ID do rastreio.
- Adicionar filtros.
No painel Detalhes do rastreio, selecione o rastreio e, de seguida, aceda ao separador Projetos.
Este separador apresenta os projetos que armazenam intervalos para o rastreio.
Para criar um âmbito de rastreio que contenha os projetos indicados, aceda à barra de ferramentas do separador Projetos e selecione Criar âmbito com estes projetos e, de seguida, conclua a caixa de diálogo.
Repita os passos anteriores até compilar uma lista de projetos.
Depois de compilar uma lista de projetos, crie um âmbito de rastreio. Também pode defini-lo como o âmbito do rastreio predefinido.
Modifique ou elimine um âmbito de rastreio
Não pode eliminar nem modificar o âmbito do rastreio com o nome _Default. Pode modificar ou eliminar todos os outros âmbitos de rastreio.
Consola
Para modificar ou eliminar um âmbito de rastreio, faça o seguinte:
-
Na Google Cloud consola, aceda à página settings Definições:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
- Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
- Selecione o separador Âmbitos de rastreio.
Encontre o âmbito do rastreio que quer modificar ou eliminar, clique em more_vert Mais e, em seguida, faça uma das seguintes ações:
- Para modificar, selecione Editar âmbito e, de seguida, conclua a caixa de diálogo.
- Para eliminar, selecione Eliminar âmbito e, de seguida, conclua a caixa de diálogo.
Configure o âmbito do rastreio predefinido
Quando a página Explorador de rastreios é aberta, pesquisa os projetos listados no âmbito do rastreio predefinido para dados de rastreio. Se esse âmbito de rastreio não for acessível, o projeto é pesquisado quanto a dados de rastreio.
Quando os projetos são criados, o âmbito do rastreio denominado _Default é criado e é designado como o âmbito do rastreio predefinido. No entanto, pode criar o seu próprio âmbito de rastreio e designá-lo como o âmbito de rastreio predefinido.
Antes de começar
-
Enable the Observability API.
Antes de ativar a API, certifique-se de que selecionou o projeto correto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
-
Para receber as autorizações de que precisa para criar e ver âmbitos de rastreio, e para definir o âmbito de rastreio predefinido, peça ao seu administrador para lhe conceder as seguintes funções de IAM no seu projeto:
-
Utilizador do Cloud Trace (
roles/cloudtrace.user) -
Editor de observabilidade (
roles/observability.editor)
Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.
Estas funções predefinidas contêm as autorizações necessárias para criar e ver âmbitos de rastreio, bem como para definir o âmbito de rastreio predefinido. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
São necessárias as seguintes autorizações para criar e ver âmbitos de rastreio, e para definir o âmbito de rastreio predefinido:
-
Para criar e gerir âmbitos de rastreio:
cloudtrace.traceScopes.{create, delete, get, list, update} -
Para definir o âmbito do rastreio predefinido:
observability.scopes.{get, update}
Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.
-
Utilizador do Cloud Trace (
Defina o âmbito predefinido
Consola
Para definir o âmbito do rastreio predefinido, faça o seguinte:
-
Na Google Cloud consola, aceda à página settings Definições:
Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
- Na barra de ferramentas da Google Cloud consola, selecione o seu Google Cloud projeto. Para configurações do App Hub, selecione o projeto anfitrião do App Hub ou o projeto de gestão da pasta com apps ativadas.
Selecione o separador Âmbitos de rastreio.
O separador apresenta os âmbitos de rastreio e inclui um botão para criar um âmbito de rastreio personalizado.
Encontre o âmbito do rastreio que quer designar como o âmbito do rastreio predefinido, clique em more_vert Mais e, de seguida, selecione Definir como predefinição.
O âmbito do rastreio que selecionou é apresentado com um ícone "Predefinição",
.
Limitações
Não existe apoio técnico da API Cloud Trace nem da CLI Google Cloud para criar ou gerir âmbitos de rastreio.
Limites nos âmbitos de rastreio
| Limites nos âmbitos de rastreio | Valor |
|---|---|
| Número máximo de âmbitos de rastreio por projeto | 100 |
| Número máximo de projetos por âmbito de rastreio | 20 |
O que se segue?
O Cloud Logging e o Cloud Monitoring contêm construções semelhantes que lhe permitem controlar os dados de registo ou os dados de métricas que pode ver ou monitorizar. Para informações sobre esses âmbitos, consulte os seguintes documentos: