Esta página foi traduzida pela API Cloud Translation.

Criar e gerenciar escopos de registro

Neste documento, descrevemos como criar e gerenciar escopos de registros, que podem ser usados para encontrar com eficiência as entradas de registro que você quer visualizar ou analisar. Se você quiser apenas ver e analisar as entradas de registro que se originam em um projeto, uma pasta ou uma organização, este documento não é para você. No entanto, se você usa coletores de registros para rotear registros para outros projetos ou para buckets de registro definidos pelo usuário, ou se você usa visualizações de registros, as informações neste documento podem ajudar você a encontrar entradas de registro específicas com eficiência.

Este documento não descreve como visualizar seus registros. Para mais informações sobre esse assunto, consulte Ver registros usando o Explorador de registros.

Sobre escopos de registros

Os escopos de registros são recursos persistentes no nível do projeto que listam um conjunto de recursos. Esses recursos podem ser projetos, pastas, organizações e visualizações de registros. Por exemplo, é possível definir um escopo de registro que liste os projetos que contêm recursos usados para produção ou um que liste as visualizações de registros que incluem entradas de registro para um tipo de recurso específico.

Quando você cria um recurso de projeto, pasta ou organização do Google Cloud , o Logging cria um escopo de registros chamado _Default. Esse escopo inclui o projeto, a pasta ou a organização que foi criada. Quando um recurso pesquisado é um projeto, uma pasta ou uma organização do Google Cloud , os resultados incluem as entradas de registro originadas no recurso e armazenadas em um bucket de registros. O bucket de registros pode estar em qualquer projeto. Quando um projeto é pesquisado, os resultados também incluem entradas de registro que são roteadas para o projeto por um coletor em outro projeto e armazenadas em um bucket de registros.

É possível criar escopos de registros. Também é possível editar e excluir os escopos de registro que você cria. No entanto, não é possível editar ou excluir o escopo de registro chamado _Default.

Você usa um escopo de registro para controlar quais recursos a página do Explorador de registros pesquisa em busca de dados de registro. Quando você abre essa página e seleciona um escopo de registros, ela pesquisa os recursos listados nesse escopo e atualiza a exibição.

Também é possível usar um escopo de registros para controlar quais recursos um painel de registros pesquisa por dados de registros. Um painel de registros é um widget de painel personalizado que mostra dados de registros. Cada painel de registros tem uma configuração própria, o que permite criar um painel com vários painéis de registros, em que cada um mostra dados de registros diferentes. Para mais informações, consulte Mostrar registros e erros em um painel personalizado.

Para projetos, o escopo de registro padrão determina o conjunto de recursos que a página Análise de registros pesquisa quando é aberta. No entanto, suas funções do Identity and Access Management (IAM) nos recursos pesquisados e a configuração de período determinam quais entradas de registro são buscadas do armazenamento. Quando os projetos são criados, o escopo de registros chamado _Default é designado como o padrão. É possível definir qual escopo de registro é o padrão.

Como os escopos de registros são diferentes do armazenamento centralizado de registros

O armazenamento centralizado de registros e os escopos de registros oferecem uma maneira de ver dados de registro originados em diferentes projetos.

Ao centralizar o armazenamento de registros, você configura os coletores em uma organização ou pasta para encaminhar entradas de registro a um único local de armazenamento. O armazenamento centralizado oferece um único lugar para consultar dados de registro, o que simplifica suas consultas ao pesquisar tendências ou investigar problemas. Do ponto de vista da segurança, você também tem um local de armazenamento, o que simplifica as tarefas dos seus analistas de segurança.

Quando uma consulta é emitida para os recursos listados em um escopo de registros, os resultados individuais são combinados. Um escopo de registro facilita a agregação de dados de registro em tempo de leitura, que podem ser armazenados em locais diferentes. No entanto, um escopo de registro também pode ser usado para fornecer acesso de leitura a uma ou mais visualizações de registro em um bucket de registros centralizado.

Quando a página Análise de registros é aberta, ela emite consultas para os recursos listados no escopo de registro padrão. Portanto, configure o escopo padrão para que a página mostre os dados que você costuma querer ver. Por exemplo, é possível definir o escopo de registro padrão para listar uma visualização de registros que, quando consultada, retorna os dados de registro de um aplicativo do App Hub.

Práticas recomendadas

Como os escopos de registros oferecem uma maneira de definir e salvar uma configuração para uso futuro, recomendamos que você crie escopos de registros para configurações de pesquisa complexas.

Por exemplo, suponha que você esteja resolvendo um problema e queira ver as entradas de registro de todas as instâncias de máquina virtual (VM) pertencentes à sua equipe. Para realizar essa tarefa, faça o seguinte:

Você determina que as entradas de registro que quer ver estão armazenadas em vários buckets e projetos. Para a maioria dos buckets de registros, existe uma visualização que inclui as entradas que você quer analisar. Se não houver uma visualização de registros, crie uma.
Você decide criar um escopo de registros porque espera ter uma tarefa de solução de problemas semelhante no futuro.
Abra a página Explorador de registros no console do Google Cloud e use o menu Refinar escopo para selecionar o novo escopo de registros.
Você revisa as entradas de registro e encontra as informações necessárias para resolver o problema que estava investigando.
Depois de resolver o problema, compartilhe a causa da falha com seus colegas. Você também compartilha que espera ver falhas semelhantes no futuro. Por isso, criou um escopo de registros que permite que você ou quem estiver investigando a falha encontre rapidamente as entradas de registro relevantes.

Aplicativos e escopos de registros do App Hub

Seus aplicativos do App Hub podem gravar dados de registro em vários projetos. Os dados de registro podem ser armazenados no projeto em que foram gerados ou um administrador da organização pode ter configurado o armazenamento centralizado. Para ver os dados de registro do seu aplicativo, crie um escopo de registros, configure para listar os projetos ou visualizações de registros que armazenam os dados de registro do aplicativo e, em seguida, configure como o escopo de registros padrão. Quando você conclui essas etapas, a página do Explorador de registros mostra automaticamente os dados gravados pelo aplicativo, mesmo que eles estejam armazenados em projetos diferentes ou em um bucket de registros centralizado.

Crie o escopo de registro personalizado no projeto em que você vai ver os dados de registro. Esse projeto é o host do App Hub ou o projeto de gerenciamento da sua pasta habilitada para gerenciar apps. Por exemplo, se o nome de exibição da pasta for My Folder, o nome de exibição do projeto de gerenciamento será My Folder-mp.

Limitações

Não é possível excluir ou modificar o escopo de registro chamado _Default.
Somente projetos Google Cloud podem ter um escopo de registros padrão.
Não é possível adicionar pastas ou organizações a um escopo de registros definido pelo usuário.
Os escopos de registros são criados no local global.

Antes de começar

Para ter as permissões necessárias para criar e visualizar escopos de registros e definir o escopo de registros padrão, peça ao administrador para conceder a você os seguintes papéis do IAM:
- Para criar e visualizar escopos de registros ou receber o escopo de registros padrão: Gravador de configuração de registros (roles/logging.configWriter) no seu projeto, pasta ou organização
- Para definir ou receber o escopo de registros padrão: Editor de observabilidade (roles/observability.editor) no seu projeto, pasta ou organização
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para criar e visualizar escopos de registros e definir o escopo de registro padrão. Para conferir 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 registros e definir o escopo de registros padrão:
- Para definir o escopo de registro padrão: observability.scopes.{get, update}
- Para criar e gerenciar escopos de registros: logging.logScopes.{create, delete, get, list, update}
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud

Listar escopos de registros

Console

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

No Google Cloud console, 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.
Na barra de ferramentas do console Google Cloud , selecione seu projeto, pasta ou organização. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Selecione a guia Escopos de registros.

A tabela lista seus escopos de registro. Quando você seleciona um projeto Google Cloud , uma entrada na tabela é mostrada com um ícone "Padrão",, que indica que esse escopo de registro lista os recursos que a Análise de registros pesquisa quando essa página é aberta.

gcloud

Para listar os escopos de registros em um projeto, use o comando gcloud logging scopes list:

 gcloud logging scopes list --project=PROJECT_ID

Antes de executar o comando, atualize os seguintes campos:

PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.

Para conferir os detalhes de um escopo de registros em um projeto, use o comando gcloud logging scopes describe:

 gcloud logging scopes describe LOG_SCOPE_ID --project=PROJECT_ID

Antes de executar o comando, atualize os seguintes campos:

PROJECT_ID: o identificador do projeto.
LOG_SCOPE_ID: o ID do escopo de registro. Por exemplo, my-scope.

Terraform

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

REST

A API Cloud Logging contém comandos que listam os escopos de registro em um recurso ou que informam os detalhes de um escopo de registro específico. Para uma lista completa de comandos, consulte a documentação de referência da API.

Para projetos Google Cloud , use os seguintes comandos:

Nos comandos anteriores, o campo parent tem a seguinte sintaxe:

projects/PROJECT_ID/locations/LOCATION_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 do App Hub ou o projeto de gerenciamento da pasta com app ativado.
LOCATION_ID precisa ser definido como global.

Definir o escopo de registro padrão

Esta seção não se aplica a pastas ou organizações. Para pastas e organizações, quando a página Análise de registros é aberta, ela pesquisa as entradas de registro originadas na pasta ou organização.

Quando um projeto é criado, um escopo de registros chamado _Default é criado. Esse escopo lista um recurso, que é seu projeto, e é designado como o escopo de registros padrão. Se você criar um projeto e não modificar o escopo de registro padrão, quando a página Análise de registros for aberta, ela vai pesquisar todas as entradas de registro originadas no projeto.

Você pode criar seu próprio escopo de registro em registros e designá-lo como o escopo padrão. Com esse recurso, é possível configurar quais recursos a página Análise de registros pesquisa em entradas de registro.

Console

Para definir o escopo de registros padrão de um projeto, faça o seguinte:

Enable the Observability API.
Enable the API

Antes de ativar a API Observability, verifique se o projeto correto está selecionado. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Na barra de ferramentas do console Google Cloud , selecione seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado. . Só é possível definir o escopo de registros padrão para um projeto.
No Google Cloud console, 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.

A página Configurações tem várias guias. Cada guia mostra a configuração de escopo para um tipo específico de telemetria.
Selecione a guia Escopos de registros.
Encontre o escopo de registros que você quer designar como o padrão, clique em Mais e selecione Definir como padrão.

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

gcloud

Para conferir e definir o escopo de observabilidade padrão, faça o seguinte:

Para conferir as configurações do escopo padrão, 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
name: projects/my-project/locations/global/scopes/_Default
```
Para atualizar o escopo padrão, execute o comando gcloud observability scopes update.

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 ID totalmente qualificado do escopo de 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 de registros. Por exemplo, my-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\
   --location=LOCATION\
   --project=PROJECT_ID
```
Windows (PowerShell)
```
gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
   --log-scope=LOG_SCOPE_FQN_ID`
   --location=LOCATION`
   --project=PROJECT_ID
```
Windows (cmd.exe)
```
gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
   --log-scope=LOG_SCOPE_FQN_ID^
   --location=LOCATION^
   --project=PROJECT_ID
```
Por exemplo, se o valor de LOG_SCOPE_ID for my-scope, a resposta será semelhante a esta:
```
Updated scope [_Default].
logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-scope
name: projects/my-project/locations/global/scopes/_Default
```

Terraform

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

REST

Para usar a API Observability e receber ou definir o escopo de registro padrão, faça o seguinte:

Verifique se a API Observability está ativada:
1. After installing the Google Cloud CLI, initialize it by running the following command:
```
gcloud init
```
  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
2. Defina o projeto padrão para a Google Cloud CLI:
```
gcloud config set project PROJECT_ID
```
  Antes de executar o comando anterior, substitua o seguinte:
  - PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
3. Enable the Observability API:
```
gcloud services enable observability.googleapis.com
```
Escolha uma destas opções:
- Para receber o escopo de registros 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 de registro padrão.
- Para atualizar o escopo de registro padrão de um projeto, envie uma solicitação ao 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 foram alterados. A resposta é um objeto Scope.
  
  O parâmetro de caminho para ambos os 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 do App Hub ou o projeto de gerenciamento da pasta com app ativado.
  - 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 armazena informações sobre o escopo de registros padrão e é criado automaticamente.
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 receber o escopo padrão atual, faça o seguinte:
1. Clique em projects.locations.scopes.get.
2. No widget Testar este método, insira o seguinte no campo name:
```
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.
  
  A resposta é semelhante a:
```
{
"name": "projects/my-project/locations/global/scopes/_Default",
"logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
}
```

Criar um escopo de registro

É possível criar 100 escopos de registros por projeto. Um escopo de registro pode incluir um total de 100 visualizações de registro e projetos, mas apenas 5 projetos. Não é possível adicionar pastas ou organizações a um escopo de registros.

Console

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

No Google Cloud console, 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.
Na barra de ferramentas do console Google Cloud , selecione seu projeto, pasta ou organização. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Selecione a guia Escopos de registros e clique em Criar escopo de registros.
Para adicionar um ou mais projetos, clique em Adicionar projetos e preencha a caixa de diálogo.

Depois de adicionar um projeto, seus papéis do IAM nele determinam quais entradas de registro podem ser visualizadas. Por exemplo, sua função do IAM pode permitir que você veja apenas as entradas de registro acessíveis por uma visualização específica em um bucket de registros. Para mais informações sobre papéis, consulte Papéis do Logging.
Para adicionar uma ou mais visualizações de registros, clique em Adicionar visualizações de registros e preencha a caixa de diálogo.

A caixa de diálogo lista todas as visualizações de registros que têm entradas originadas no projeto atual ou que foram encaminhadas para ele por um gravador em outro projeto. Por exemplo, se você não tiver configurado nenhum coletor, essa caixa de diálogo vai listar as visualizações de registros no projeto atual.

Para listar visualizações de registros armazenadas em outro projeto Google Cloud , clique em Importar projeto e selecione o projeto Google Cloud .

Depois de adicionar uma visualização de registros, seus papéis do IAM na visualização ou no projeto que a armazena determinam quais entradas de registro podem ser acessadas. Para mais informações, consulte Controlar o acesso a uma visualização de registro.
Na seção Nomear o escopo de registros, insira o nome e a descrição que você quer que apareçam na guia Escopos de registros.

O nome de um escopo de registro não pode ser modificado e precisa ser exclusivo no projeto.
Clique em Criar escopo de registros.

gcloud

Para criar um escopo de registros em um projeto, use o comando gcloud logging scopes create:

 gcloud logging scopes create LOG_SCOPE_ID --project=PROJECT_ID \
   --description=DESCRIPTION \
   --resource-names=RESOURCE_NAMES

Antes de executar o comando, atualize os seguintes campos:

PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
LOG_SCOPE_ID: o ID do escopo de registro. Por exemplo, my-scope.
DESCRIPTION: opcional. A descrição do escopo de registro. Formate a descrição como uma string.
RESOURCE_NAMES: uma lista separada por vírgulas dos nomes totalmente qualificados de projetos ou visualizações de registros. Por exemplo, para incluir my-project no escopo de registros, especifique projects/my-project.

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 Terraform.

Para criar um escopo de registros em um projeto, pasta ou organização usando o Terraform, use o recurso google_logging_log_scope.

No comando, defina os seguintes campos:

parent: o nome completo do projeto, da pasta ou da organização. Por exemplo, você pode definir esse campo como "projects/PROJECT_ID", em que PROJECT_ID é o ID do seu projeto Google Cloud . Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Defina locations como "global".
name: definido como o nome totalmente qualificado do escopo de registro. Para projetos, o formato desse campo é:
```
"projects/PROJECT_ID/locations/global/logScopes/LOG_SCOPE_ID"
```
Na expressão anterior, LOG_SCOPE_ID é o nome de um escopo de registro, como "production".
resource_names: uma matriz de projetos e visualizações de registros, em que cada projeto e visualização de registros é especificado usando o nome totalmente qualificado.
description: uma breve descrição. Por exemplo, "Escopo para recursos de produção".

REST

A API Cloud Logging também permite criar escopos de registros em uma pasta ou organização. Para mais informações, consulte a documentação de referência da API.

Para projetos Google Cloud , use o seguinte comando:

projects.locations.logScopes.create.

Nos comandos anteriores, o campo parent tem a seguinte sintaxe:

projects/PROJECT_ID/locations/LOCATION_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 do App Hub ou o projeto de gerenciamento da pasta com app ativado.
LOCATION_ID precisa ser definido como global.

Modificar ou excluir um escopo de registros

Console

Para modificar ou excluir um escopo de registros criado por você ou um colega, faça o seguinte:

No Google Cloud console, 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.
Na barra de ferramentas do console Google Cloud , selecione seu projeto, pasta ou organização. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
Selecione a guia Escopos de registros.
Encontre os escopos de registros que você quer modificar ou excluir, clique em Mais e faça o seguinte:
- Para modificar, selecione Editar escopo e preencha a caixa de diálogo.
- Para excluir, selecione Excluir escopo e preencha a caixa de diálogo.

gcloud

Para modificar a descrição da lista de recursos em um escopo de registros em um projeto, use o comando gcloud logging scopes update:

 gcloud logging scopes update LOG_SCOPE_ID --project=PROJECT_ID \
   --description=DESCRIPTION \
   --resource-names=RESOURCE_NAMES

Antes de executar o comando, atualize os seguintes campos:

PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
LOG_SCOPE_ID: o ID do escopo de registro. Por exemplo, my-scope.
DESCRIPTION: a descrição do escopo do registro. Formate a descrição como uma string. Omita esse campo quando não quiser mudar a descrição do escopo de registro.
RESOURCE_NAMES: uma lista separada por vírgulas dos nomes totalmente qualificados de projetos ou visualizações de registros. Omita esse campo quando não quiser mudar a lista de recursos.

Para excluir um escopo de registros em um projeto, use o comando gcloud logging scopes delete:

 gcloud logging scopes delete LOG_SCOPE_ID --project=PROJECT_ID

Antes de executar o comando, atualize os seguintes campos:

PROJECT_ID: o identificador do projeto. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.
LOG_SCOPE_ID: o ID do escopo de registro. Por exemplo, my-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 Terraform.

Para modificar um escopo de registros em um projeto, pasta ou organização usando o Terraform, use o recurso do Terraform google_logging_log_scope.

REST

A API Cloud Logging contém comandos que podem modificar ou excluir um escopo de registros. Para uma lista completa de comandos, consulte a documentação de referência da API.

Para projetos Google Cloud , use os seguintes comandos:

Nos comandos anteriores, o campo parent tem a seguinte sintaxe:

projects/PROJECT_ID/locations/LOCATION_ID/logScopes/LOG_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 do App Hub ou o projeto de gerenciamento da pasta com app ativado.
LOCATION_ID precisa ser definido como global.
LOG_SCOPE_ID: o ID do escopo de registro. Por exemplo, my-scope.

Criar e gerenciar escopos de registro Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Sobre escopos de registros

Como os escopos de registros são diferentes do armazenamento centralizado de registros

Práticas recomendadas

Aplicativos e escopos de registros do App Hub

Limitações

Antes de começar

Permissões necessárias

Console

gcloud

Terraform

REST

Listar escopos de registros

Console

gcloud

Terraform

REST

Definir o escopo de registro padrão

Console

gcloud

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Linux, macOS ou Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Terraform

REST

Criar um escopo de registro

Console

gcloud

Terraform

REST

Modificar ou excluir um escopo de registros

Console

gcloud

Terraform

REST

A seguir

Criar e gerenciar escopos de registro