Criar e gerenciar escopos de rastreamento

Os escopos de trace permitem pesquisar e analisar dados do Cloud Trace em vários projetos na página Explorador de traces. Se você quiser apenas visualizar e analisar períodos originados em um único projeto do Google Cloud , não precisará configurar nenhum escopo de trace. Para informações sobre como visualizar traces e períodos, consulte Encontrar e explorar traces.

Sobre os escopos de trace

Os escopos de trace permitem que você tenha uma visualização agregada dos dados de trace armazenados em vários projetos. Esses escopos são recursos persistentes no nível do projeto que listam visualizações. Cada visualização fornece acesso aos dados de trace armazenados por um projeto. Páginas como o Trace Explorer usam escopos de trace para determinar onde pesquisar dados. No entanto, essas páginas também usam seus papéis do Identity and Access Management (IAM) nesses recursos para determinar se você tem permissão para ver os dados encontrados.

Ao criar um escopo de trace, você fornece um nome e uma lista de projetos. O sistema inclui automaticamente a visualização de trace padrão de cada projeto, que tem o caminho _Trace/Spans/_AllSpans. Os campos de caminho _Trace, Spans e _AllSpans se referem a um bucket de observabilidade, ao conjunto de dados que armazena os dados e a uma visualização no conjunto de dados. A visualização _AllSpans fornece acesso a todos os dados de trace armazenados pelo projeto.

A página Explorador de traces inclui uma opção que permite selecionar um escopo de trace. Quando você faz uma seleção, a página pesquisa as visualizações listadas no escopo do trace e atualiza a exibição.

Você também pode compartilhar a visualização configurada copiando o URL do navegador. O URL codifica o escopo de trace selecionado e outras configurações de página, substituindo as seleções de escopo padrão para qualquer pessoa que abrir o link. Para mais informações, consulte Compartilhar traces e períodos.

É possível designar um escopo de trace como "padrão". Quando você faz essa designação, ocorre o seguinte:

  • O sistema atualiza o escopo de observabilidade. Esse escopo contém ponteiros para o escopo do registro padrão e o escopo de trace padrão, o que ajuda o sistema a correlacionar dados de registro e de trace quando esses dados são armazenados em vários projetos. Para mais informações, consulte Configurar escopos de observabilidade para consultas de vários projetos.

  • O sistema atualiza qual escopo de trace a página do Explorador de trace usa automaticamente para pesquisar dados de trace. Se a página não puder acessar o escopo de trace padrão, ela vai pesquisar dados de trace no projeto.

É possível modificar e excluir os escopos de trace que você criar.

Aplicativos do App Hub e escopos de trace

Os aplicativos do App Hub podem gravar dados de trace em vários projetos. Para ter uma visualização agregada desses dados, crie um escopo de trace, configure-o para listar a visualização de trace padrão de todos os projetos que armazenam dados de trace e, em seguida, configure-o como o escopo de trace padrão. Ao concluir essas etapas, a página do Trace Explorer exibe automaticamente os dados gravados pelo aplicativo, mesmo quando eles estão armazenados em projetos diferentes.

Crie o escopo de trace personalizado no projeto em que você visualiza os dados de trace. Este projeto é o projeto host ou de gerenciamento do App Hub. Por exemplo, se o nome de exibição de uma pasta for My Folder, o nome de exibição do projeto de gerenciamento da pasta será My Folder-mp.

Antes de começar

Configure o projeto, os papéis do IAM e selecione a interface que você planeja usar.

Configurar o projeto e os papéis

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Observability API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  4. Para receber as permissões necessárias para criar e visualizar escopos de trace, peça ao administrador para conceder a você o papel do IAM de Editor de escopos de observabilidade (roles/observability.scopesEditor) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Esse papel predefinido contém as permissões necessárias para criar e visualizar escopos de trace. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

    Permissões necessárias

    As seguintes permissões são necessárias para criar e visualizar escopos de trace:

    • observability.traceScopes.{create, delete, get, list, update}
    • observability.scopes.{get, update}

    Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Selecione a interface que você quer usar

Console

Quando você usa o console do Google Cloud para acessar os serviços e as APIs do Google Cloud , não é necessário configurar a autenticação.

gcloud

Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

gcloud init

Terraform

Para usar os exemplos do Terraform desta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.

  1. Instale a CLI do Google Cloud.

  2. Configure a CLI gcloud para usar sua identidade federada.

    Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.

  3. Crie credenciais de autenticação local para sua conta de usuário:

    gcloud auth application-default login

    Se um erro de autenticação for retornado, confirme se você fez login na CLI gcloud com sua identidade federada.

Saiba mais em Configurar o ADC para um ambiente de desenvolvimento local na documentação de autenticação do Google Cloud .

REST

Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

    Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Listar escopos de trace

Console

Para listar os escopos de trace, faça o seguinte:

  1. No console do Google Cloud , acesse a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

  2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  3. Selecione a guia Escopos de trace.

    A janela mostra uma lista dos seus escopos de trace. A entrada que inclui um ícone "Padrão", , é o escopo de trace padrão.

  4. Para conferir os detalhes de um escopo de trace, abra-o.

    Se você expandir um escopo de trace, poderá ver a lista de visualizações incluídas no escopo. Cada linha lista um ID do projeto com uma entrada como _Trace/Spans/_AllSpans, que identifica o local de armazenamento padrão dos dados de trace. Os campos _Trace, Spans e _AllSpans se referem ao bucket, ao conjunto de dados e à visualização de observabilidade dos dados de trace. A visualização _AllSpans corresponde a cada entrada no bucket:

    Nome Descrição Tipo Recursos
    _Default Trace scope 1
    myscope My description Trace scope 2
      _Trace/Spans/_AllSpans myproject Trace view
      _Trace/Spans/_AllSpans project-b Trace view

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • LOCATION: o local do escopo do trace. Esse campo precisa ter um valor de global.
  • PROJECT_ID: o identificador do projeto.

Execute o comando gcloud observability trace-scopes list:

Linux, macOS ou Cloud Shell

gcloud observability trace-scopes list \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes list `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes list ^
 --location=LOCATION --project=PROJECT_ID

Os dados de resposta são uma lista de escopos de trace. Para cada escopo, o nome e as informações relevantes são mostrados. Por exemplo, o exemplo a seguir ilustra o resultado do comando list para um projeto que tem dois escopos de trace:

name: projects/my-project/locations/global/traceScopes/_Default
resourceNames:
- projects/my-project
---
createTime: '2026-03-26T13:43:54.772326947Z'
description: a test
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:43:54.772326947Z'

Terraform

É possível usar o Terraform para criar e modificar um escopo de trace. No entanto, não é possível usar o Terraform para listar escopos de trace.

REST

Para listar todos os escopos de trace em um projeto do Google Cloud , use o comando projects.locations.traceScopes.list. É necessário especificar um parâmetro de caminho.

O parâmetro de caminho para esse endpoint tem a seguinte sintaxe:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Os campos na expressão anterior têm o seguinte significado:

  • PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  • LOCATION_ID precisa ser definido como global.

A resposta é uma matriz de objetos TraceScope. Cada objeto inclui um nome e uma lista de recursos.

Para receber informações sobre um escopo de trace específico, use o comando projects.locations.traceScopes.get.

Criar um escopo de trace

Os períodos mostrados na página Explorador de traces dependem das visualizações pesquisadas, dos seus papéis do IAM nessas visualizações, da configuração do período e dos filtros aplicados.

É possível criar 100 escopos de trace por projeto. Um escopo de trace pode incluir um total de 200 visualizações. Se você criar um escopo de trace que liste mais de 10 visualizações, poderá ter problemas de desempenho.

Console

Para criar um escopo de trace, faça o seguinte:

  1. No console do Google Cloud , acesse a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

  2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  3. Selecione a guia Escopos de trace e clique em Criar escopo de trace.
  4. Clique em Adicionar projetos e preencha a caixa de diálogo.

  5. Na seção Nomear escopo de trace, insira o nome e a descrição que você quer que apareçam na guia Escopos de trace.

    O nome de um escopo de trace não pode ser modificado e precisa ser exclusivo no projeto.

  6. Clique em Criar escopo de trace.

    Por padrão, a tabela Escopos de trace lista os escopos de trace de forma recolhida. Para cada escopo, a tabela lista um nome, uma descrição, um tipo e um número de recursos.

    Se você expandir um escopo de trace, poderá ver a lista de visualizações incluídas no escopo. Cada linha lista um ID do projeto com uma entrada como _Trace/Spans/_AllSpans, que identifica o local de armazenamento padrão dos dados de trace. Os campos _Trace, Spans e _AllSpans se referem ao bucket, ao conjunto de dados e à visualização de observabilidade dos dados de trace. A visualização _AllSpans corresponde a cada entrada no bucket:

    Nome Descrição Tipo Recursos
    _Default Trace scope 1
    myscope My description Trace scope 2
      _Trace/Spans/_AllSpans myproject Trace view
      _Trace/Spans/_AllSpans project-b Trace view

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • TRACE_SCOPE_NAME: o nome de um escopo de trace. Por exemplo, my-trace-scope.
  • DESCRIPTION: opcional. A descrição do escopo do trace. Formate a descrição como uma string.
  • RESOURCE_NAMES: uma lista separada por vírgulas dos nomes totalmente qualificados dos projetos. Por exemplo, projects/my-project.
  • LOCATION: o local do escopo do trace. Esse campo precisa ter um valor de global.
  • PROJECT_ID: o identificador do projeto.

Execute o comando gcloud observability trace-scopes create:

Linux, macOS ou Cloud Shell

gcloud observability trace-scopes create TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes create TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes create TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Quando bem-sucedida, a resposta do comando create inclui o nome do novo escopo de trace:

Created traceScope [my-test-scope].

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform. Para mais informações, consulte a documentação de referência do provedor do Terraform.

Para criar um escopo de trace em um projeto usando o Terraform, use o recurso do Terraform google_observability_trace_scope.

No comando, defina os seguintes campos:

  • project: o nome do projeto, da pasta ou da organização. Por exemplo, my-project. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.

  • trace_scope_id: definido como um ID de escopo. Por exemplo, my-trace-scope.

  • Defina location como "global".

  • resource_names: uma matriz de projetos, em que cada projeto é especificado pelo nome totalmente qualificado.

  • description: uma breve descrição. Por exemplo, "Escopo para recursos de produção".

REST

Para criar um escopo de trace, use o comando projects.locations.traceScopes.create. É preciso especificar um parâmetro de caminho e fornecer um objeto TraceScope. A resposta é um objeto TraceScope.

O parâmetro de caminho para esse endpoint tem a seguinte sintaxe:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

Os campos na expressão anterior têm o seguinte significado:

  • PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  • LOCATION_ID precisa ser definido como global.

Modificar um escopo de trace

Não é possível modificar o escopo de trace chamado _Default. É possível modificar todos os outros escopos de trace.

Console

Para modificar um escopo de trace, faça o seguinte:

  1. No console do Google Cloud , acesse a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

  2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  3. Selecione a guia Escopos de trace.
  4. Encontre o escopo de trace que você quer modificar, clique em  Mais, selecione Editar escopo e conclua a caixa de diálogo.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • TRACE_SCOPE_NAME: o nome de um escopo de trace. Por exemplo, my-trace-scope.
  • DESCRIPTION: opcional. A descrição do escopo do trace. Formate a descrição como uma string.
  • RESOURCE_NAMES: uma lista separada por vírgulas dos nomes totalmente qualificados dos projetos. Por exemplo, projects/my-project.
  • LOCATION: o local do escopo do trace. Esse campo precisa ter um valor de global.
  • PROJECT_ID: o identificador do projeto.

Execute o comando gcloud observability trace-scopes update:

Linux, macOS ou Cloud Shell

gcloud observability trace-scopes update TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes update TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes update TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

Quando bem-sucedidos, os dados de resposta de um comando update exibem o escopo de trace atualizado:

Updated traceScope [my-test-scope].
createTime: '2026-03-26T13:43:54.772326947Z'
description: A scope for testing
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:48:05.262142872Z'

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform. Para mais informações, consulte a documentação de referência do provedor do Terraform.

Para modificar um escopo de trace em um projeto usando o Terraform, use o recurso do Terraform google_observability_trace_scope.

REST

Para modificar um escopo de trace, use o comando projects.locations.traceScopes.patch. É necessário especificar um parâmetro de caminho, parâmetros de consulta e fornecer um objeto TraceScope. Os parâmetros de consulta identificam quais campos foram alterados. A resposta é um objeto TraceScope.

O parâmetro de caminho para esse endpoint tem a seguinte sintaxe:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Os campos na expressão anterior têm o seguinte significado:

  • PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  • LOCATION_ID precisa ser definido como global.
  • TRACE_SCOPE_NAME: o nome de um escopo de trace. Por exemplo, my-trace-scope.

Excluir um escopo de trace

Não é possível excluir o escopo de trace chamado _Default. É possível excluir todos os outros escopos de trace.

Console

Para excluir um escopo de trace, faça o seguinte:

  1. No console do Google Cloud , acesse a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

  2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  3. Selecione a guia Escopos de trace.
  4. Encontre o escopo de trace que você quer excluir, clique em  Mais, selecione Excluir escopo e conclua a caixa de diálogo.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • TRACE_SCOPE_NAME: o nome de um escopo de trace. Por exemplo, my-trace-scope.
  • LOCATION: o local do escopo do trace. Esse campo precisa ter um valor de global.
  • PROJECT_ID: o identificador do projeto.

Execute o comando gcloud observability trace-scopes delete:

Linux, macOS ou Cloud Shell

gcloud observability trace-scopes delete TRACE_SCOPE_NAME \
 --location=LOCATION --project=PROJECT_ID

Windows (PowerShell)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME `
 --location=LOCATION --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME ^
 --location=LOCATION --project=PROJECT_ID

Se você emitir um comando delete, será solicitado que confirme a ação. Veja a seguir um exemplo de execução:

You are about to delete traceScope [my-test-scope]

Do you want to continue (Y/n)?  Y

Deleted traceScope [my-test-scope].

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform. Para mais informações, consulte a documentação de referência do provedor do Terraform.

Para excluir um escopo de trace em um projeto usando o Terraform, use o recurso do Terraform google_observability_trace_scope.

REST

Para excluir um escopo de trace, use o comando projects.locations.traceScopes.delete. É necessário especificar um parâmetro de caminho.

O parâmetro de caminho para esse endpoint tem a seguinte sintaxe:

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

Os campos na expressão anterior têm o seguinte significado:

  • PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  • LOCATION_ID precisa ser definido como global.
  • TRACE_SCOPE_NAME: o nome de um escopo de trace. Por exemplo, my-trace-scope.

Configurar o escopo de trace padrão

Quando a página Explorador de traces é aberta, ela pesquisa os dados de trace nas visualizações listadas no escopo de trace padrão. Se o escopo padrão não estiver acessível, a página vai pesquisar dados de trace no projeto. Essa pesquisa equivale a consultar a visualização _AllSpans do projeto no conjunto de dados padrão.

Quando os projetos são criados, o escopo de trace chamado _Default é criado e designado como o escopo de trace padrão. No entanto, é possível criar seu próprio escopo de trace e designá-lo como o escopo de trace padrão.

Console

Para definir o escopo de trace padrão, faça o seguinte:

  1. No console do Google Cloud , acesse a página  Configurações:

    Acessar Configurações

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

  2. Na barra de ferramentas do console do Google Cloud , selecione seu projeto do Google Cloud . Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  3. Selecione a guia Escopos de trace.

    A guia exibe os escopos de trace e inclui um botão para criar um escopo de trace personalizado. O escopo de trace mostrado com um ícone "Padrão", , é o escopo de trace padrão atual.

  4. Para mudar o escopo de trace padrão, encontre o escopo de trace que você quer designar como padrão, clique em  Mais e selecione Definir como padrão.

    O escopo de trace selecionado é mostrado com um ícone "Padrão", .

gcloud

Para conferir e atualizar o escopo de observabilidade, faça o seguinte:

  1. Para ver as configurações do escopo de observabilidade, execute o comando gcloud observability scopes describe.

    Antes de usar os dados do comando abaixo, faça estas substituições:

    • OBSERVABILITY_SCOPE_ID: o nome de um objeto Scope. Esse valor precisa ser definido como _Default.
    • LOCATION: o campo de local precisa ser definido como global.
    • PROJECT_ID: o identificador do projeto.

    Execute o comando gcloud observability scopes describe:

    Linux, macOS ou Cloud Shell

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
       --location=LOCATION\
       --project=PROJECT_ID

    Windows (PowerShell)

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
       --location=LOCATION`
       --project=PROJECT_ID

    Windows (cmd.exe)

    gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
       --location=LOCATION^
       --project=PROJECT_ID

    A resposta ao comando é semelhante a esta:

    logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default
    traceScope: projects/my-project/locations/global/traceScopes/_Default
    name: projects/my-project/locations/global/scopes/_Default
    
  2. Para atualizar o escopo de observabilidade, execute o comando gcloud observability scopes update. No comando update, é possível incluir a flag --log-scope, a flag --trace-scope ou ambas.

    Antes de usar os dados do comando abaixo, faça estas substituições:

    • OBSERVABILITY_SCOPE_ID: o nome de um objeto Scope. Esse valor precisa ser definido como _Default.
    • LOG_SCOPE_FQN_ID: o nome totalmente qualificado do recurso do escopo do registro. Esse campo tem o seguinte formato:
      logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

      Na expressão anterior, LOG_SCOPE_ID é o ID do escopo do registro. Por exemplo, my-scope.

    • TRACE_SCOPE_FQN_ID: o nome totalmente qualificado do recurso do escopo do trace. Esse campo tem o seguinte formato:
      projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME

      Na expressão anterior, TRACE_SCOPE_NAME é o nome do escopo do trace. Por exemplo, my-trace-scope.

    • LOCATION: o campo de local precisa ser definido como global.
    • PROJECT_ID: o identificador do projeto.

    Execute o comando gcloud observability scopes update:

    Linux, macOS ou Cloud Shell

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
       --log-scope=LOG_SCOPE_FQN_ID\
       --trace-scope=TRACE_SCOPE_FQN_ID\
       --location=LOCATION\
       --project=PROJECT_ID

    Windows (PowerShell)

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
       --log-scope=LOG_SCOPE_FQN_ID`
       --trace-scope=TRACE_SCOPE_FQN_ID`
       --location=LOCATION`
       --project=PROJECT_ID

    Windows (cmd.exe)

    gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
       --log-scope=LOG_SCOPE_FQN_ID^
       --trace-scope=TRACE_SCOPE_FQN_ID^
       --location=LOCATION^
       --project=PROJECT_ID

    Por exemplo, se o valor de LOG_SCOPE_ID for my-log-scope e o valor de TRACE_SCOPE_NAME for my-trace-scope, a resposta será semelhante a esta:

    Updated scope [_Default].
    logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope
    traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope
    name: projects/my-project/locations/global/scopes/_Default
    

Terraform

É possível usar o Terraform para criar e modificar um escopo de trace. No entanto, não é possível usar o Terraform para definir o escopo de trace padrão.

REST

Para acessar e definir o escopo do registro padrão ou o escopo de trace padrão usando uma chamada de API, configure o escopo de observabilidade. O escopo de observabilidade lista o escopo do registro padrão e o escopo do trace padrão:

  • Para receber o escopo de observabilidade padrão de um projeto, envie uma solicitação ao endpoint projects.locations.scopes.get. É necessário especificar um parâmetro de caminho. A resposta é um objeto Scope, que lista o escopo do registro padrão e o escopo de trace padrão.
  • Para atualizar o escopo de observabilidade padrão de um projeto, envie uma solicitação para o endpoint projects.locations.scopes.patch. É necessário especificar um parâmetro de caminho, parâmetros de consulta e fornecer um objeto Scope. Os parâmetros de consulta identificam quais campos são alterados. A resposta é um objeto Scope.

O parâmetro de caminho para os dois endpoints tem o seguinte formato:

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

Os campos na expressão anterior têm o seguinte significado:

  • PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host ou de gerenciamento do App Hub.
  • LOCATION: o campo de local precisa ser definido como global.
  • OBSERVABILITY_SCOPE_ID: o nome de um objeto Scope. Esse campo precisa ser definido como _Default. O objeto Scope com o nome _Default, que é criado automaticamente, armazena informações sobre o escopo do registro padrão e o escopo de trace padrão.

Para enviar um comando a um endpoint de API, use o APIs Explorer, que permite emitir um comando em uma página de referência. Por exemplo, para ver o escopo padrão atual, faça o seguinte:

  1. Clique em projects.locations.scopes.get.
  2. No widget Teste este método, insira o seguinte no campo nome:
        projects/PROJECT_ID/locations/global/scopes/_Default
        

    Antes de copiar o campo anterior, substitua PROJECT_ID pelo nome do projeto.

  3. Selecione Executar.
  4. Na caixa de diálogo de autorização, conclua as etapas necessárias.

    O resultado parecido com este:

        {
        "name": "projects/my-project/locations/global/scopes/_Default",
        "logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
        "traceScope": "projects/my-project/locations/global/traceScopes/_Default"
        }
        

Limites nos escopos de trace

Limites nos escopos de trace Valor
Número máximo de escopos de trace por projeto 100
Número máximo de visualizações por escopo de trace 200

Para ter o melhor desempenho, limite o número de visualizações em um escopo de trace a 10.

A seguir