Algumas ou todas as informações nesta página podem não se aplicar ao Cloud de Confiance da S3NS. Consulte Diferenças do Google Cloud para saber mais.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Regionalizar seus registros

Neste documento, descrevemos como usar o gravador _Default para encaminhar suas entradas de registro a um bucket do Cloud Logging em uma região específica. Para conferir uma lista de regiões com disponibilidade, consulte Locais.

Também é possível definir um local de armazenamento padrão para novos buckets do _Default e do _Required configurando as definições padrão da sua organização ou pasta. Para mais informações, consulte Definir o local de armazenamento padrão.

Este guia explica esse processo usando o exemplo de redirecionamento de todos os registros para uma região. Esse processo envolve as seguintes etapas:

Criar um bucket de registro na região designada para armazenar os registros.
Redirecionar o coletor _Default para rotear os registros para o novo bucket de registro.
Pesquise registros na Análise de registros.

Visão geral

No Logging, os buckets de registros são recursos regionais: a infraestrutura que armazena, indexa e pesquisa seus registros está localizada em uma localização geográfica específica. Com exceção dos buckets de registros nas regiões global, eu ou us, oCloud de Confiance by S3NS gerencia a infraestrutura para que seus aplicativos estejam disponíveis de maneira redundante em todas as zonas da região do bucket de registros.

Talvez sua organização precise armazenar os dados de registros em regiões específicas. Os principais fatores para selecionar a região em que seus registros são armazenados incluem atender aos requisitos de latência, disponibilidade ou conformidade de sua organização. Ao selecionar uma região para o armazenamento de registros, considere os locais dos outros produtos e serviços doCloud de Confiance by S3NS que seu aplicativo usa.

Se você tiver requisitos de residência de dados, não ative serviços que possam consultar dados de registro e armazenar o resultado da consulta em um local do global. Um exemplo desse serviço é o Gemini Cloud Assist.

Principais conceitos

Os principais conceitos a seguir se aplicam à regionalidade de dados do Logging.

Locais do roteador de registros

O Log Router processa todas as entradas de registro gravadas na API Cloud Logging. Ele verifica cada entrada de registro em relação às regras atuais para determinar quais entradas de registro armazenar em buckets do Logging e quais entradas de registro rotear para destinos suportados usando coletores. Para rotear registros de forma confiável, o Log Router também armazena os registros temporariamente, o que protege contra interrupções temporárias em qualquer coletor.

O Log Router processa os registros na região em que são recebidos.

Locais dos buckets de registros

Os buckets de registros são os contêineres no seu projeto, conta de faturamento, pasta e organização doCloud de Confiance que armazenam e organizam os dados de registros.

Para cada projeto, conta de faturamento, pasta e organização do Cloud de Confiance , o Logging cria automaticamente dois buckets de registros: _Required e _Default, que estão no local global. Não é possível mudar o local dos buckets atuais. No entanto, sua organização pode criar uma política que defina um local padrão diferente para esses buckets. Para mais informações, consulte Definir configurações padrão para organizações e pastas.

Também é possível criar buckets de registros definidos pelo usuário para qualquer projeto doCloud de Confiance . Ao criar um bucket de registros definido pelo usuário, é possível especificar o local dele. Depois de criar o bucket de registros, não é possível mudar o local, mas você pode criar um novo bucket e direcionar as entradas de registro para ele usando coletores. Para saber como definir o local dos buckets, consulte Regionalizar seus registros.

O Cloud Logging permite consultar registros de várias regiões ao mesmo tempo. Nesse caso, as consultas são processadas nos mesmos locais dos buckets consultados e agregadas na região de onde a consulta foi recebida para retornar os resultados.

A região de um bucket de registros é mostrada na página Armazenamento de registros e em algumas caixas de diálogo. Por exemplo, quando você acessa a página da Análise de registros e usa o seletor Refinar escopo para listar visualizações de registros, as informações da região também são mostradas.

Antes de começar

Identifique o projeto Cloud de Confiance que vai armazenar suas entradas de registro.
Identifique o nome e o local do bucket de registros que vai armazenar suas entradas de registro.
Determine as entradas de registro que você quer encaminhar para o bucket de registros. Neste guia, incluímos todos os registros encaminhados pelo gravador _Default.
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
```

Regiões compatíveis

Ao criar um bucket de registros, você pode escolher onde armazenar os registros. Para conferir uma lista de regiões com disponibilidade, consulte Locais.

Criar o bucket de registros

Os buckets de registros armazenam entradas de registro. Projetos, pastas e organizações contêm coletores de registros que encaminham entradas de registro para buckets de registros ou outros destinos. Quando o destino de um coletor de registros é um bucket de registros, esse bucket de registros pode estar no mesmo recurso que o coletor de registros ou em um recurso diferente. Para mais informações, consulte Configurar buckets de registro.

Abra um shell.
Para criar um bucket de registros, execute o comando gcloud logging buckets create no shell. Antes de executar o comando de exemplo, faça as seguintes substituições:
- BUCKET_ID: o nome ou ID do bucket de registros.
- LOCATION: o local do bucket de registros.
- PROJECT_ID: o identificador do projeto.
Exemplo de comando:
```
gcloud logging buckets create BUCKET_ID \
  --location=LOCATION \
  --project=PROJECT_ID
```
Observação: depois de criar o bucket, não será possível mudar a localização dele.

Verifique se o bucket foi criado:

gcloud logging buckets list --project=PROJECT_ID

Depois de criar um bucket de registros, é possível mudar algumas propriedades, como a descrição e o período de armazenamento de dados. Para fazer essas mudanças, use o comando gcloud logging buckets update.

Redirecionar o coletor de registros `_Default`

Você encaminha registros para um bucket de registros criando um coletor. Um coletor inclui um filtro, que seleciona quais entradas de registro serão exportadas por meio do coletor, e um destino. Neste guia, atualizamos o coletor _Default para rotear entradas de registro para o bucket de registros criado na etapa anterior.

Para atualizar um gravador, execute o comando gcloud logging sinks update. Antes de executar o comando de exemplo, faça as seguintes substituições:

_Default: este exemplo atualiza o destino do coletor chamado _Default. Se você quiser atualizar um coletor diferente, mude o nome dessa variável.
BUCKET_ID: o nome ou ID do bucket de registros.
LOCATION: o local do bucket de registros.
PROJECT_ID: o identificador do projeto.

Exemplo de comando:

gcloud logging sinks update _Default \
  logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID \
  --log-filter='NOT LOG_ID("cloudaudit.googleapis.com/activity") AND NOT
    LOG_ID("externalaudit.googleapis.com/activity") AND NOT
    LOG_ID("cloudaudit.googleapis.com/system_event") AND NOT
    LOG_ID("externalaudit.googleapis.com/system_event") AND NOT
    LOG_ID("cloudaudit.googleapis.com/access_transparency") AND NOT
    LOG_ID("externalaudit.googleapis.com/access_transparency")' \
  --description="Updated the _Default sink to route logs to the LOCATION region"

Criar uma entrada de registro para testar o coletor

Para verificar se você atualizou o coletor corretamente, siga estas etapas:

Envie uma mensagem de registro de teste para seu bucket regionalizado usando o comando gcloud logging write. Antes de executar o comando de exemplo, faça as seguintes substituições:
- LOG_NAME: o nome do seu registro.
- BUCKET_ID: o nome ou ID do bucket de registros.
- PROJECT_ID: o identificador do projeto.
Exemplo de comando:
```
gcloud logging write LOG_NAME "Test to route logs to BUCKET_ID" \
--project=PROJECT_ID
```
Observação :pode levar vários minutos para que a mensagem de teste seja enviada.
Confira a entrada de registro:
1. No console do Cloud de Confiance , acesse a página Análise de registros:
  Acessar a Análise de registros
  
  Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
2. Na barra de ferramentas, clique em Refinar escopo e selecione Projeto atual.
  
  A Análise de registros é configurada para mostrar entradas de registro que se originam no seu projeto.
3. No painel Campo de registro, selecione o tipo de recurso Global.
4. A entrada de registro de teste é exibida no painel Resultados da consulta.

Pesquisar registros no console do Cloud de Confiance

Para conferir as entradas de registro no bucket de registros, acesse o console do Cloud de Confiance e siga estas etapas:

No console do Cloud de Confiance , acesse a página Análise de registros:
Acessar a Análise de registros

Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
Selecione Refinar escopo.
No painel Refinar escopo, selecione Visualização de registros.
Selecione a visualização do _AllLogs associada ao seu BUCKET_NAME.
Clique em Aplicar.

O Explorador de registros é atualizado para mostrar registros do bucket.

Para informações sobre como usar a Análise de registros, consulte Ver registros usando a Análise de registros.