Visão geral de roteamento e armazenamento

Neste documento, explicamos como o Cloud Logging processa entradas de registro e descrevemos os principais componentes do roteamento e do armazenamento do Logging. Roteamento refere-se ao processo que o Cloud Logging usa para determinar o que fazer com uma entrada de registro recém-chegada. É possível rotear entradas de registro para destinos como buckets do Logging, que armazenam a entrada de registro, ou para o Pub/Sub. Para exportar os registros para destinos de terceiros, encaminhe-os para um tópico do Pub/Sub e autorize o destino de terceiros a assinar o tópico do Pub/Sub.

De modo geral, é assim que o Cloud Logging roteia e armazena entradas de registro:

Figura ilustrando como o Cloud Logging roteia as entradas de registros.

Rotear registros com o roteador de registros

As seções a seguir explicam como o Logging roteia registros com o roteador usando coletores.

Roteador de registros

Uma entrada de registro é enviada para o Recurso do Google Cloud especificado nalogName campo durante entries.write.

O Cloud Logging recebe entradas de registro com a API Cloud Logging, em que elas passam pelo roteador de registros. Os coletores no roteador de registros verificam cada entrada de registro em comparação com o filtro de inclusão e os filtros de exclusão atuais que determinam quais destinos. incluindo buckets do Cloud Logging, para os quais a entrada de registro precisa ser enviada. Use combinações de coletores para rotear registros para vários destinos.

Ele armazena os registros temporariamente. Esse comportamento armazena em buffer contra interrupções temporárias e paralisações que podem ocorrer quando um coletor encaminha os registros para um destino. O armazenamento em buffer não protege contra erros de configuração do coletor. Se o coletor estiver configurado incorretamente, o Logging descartará os registros, um registro de erro será gerado e um e-mail notificando você sobre um erro de configuração do coletor será enviado.

O armazenamento temporário do roteador de registros é diferente do armazenamento de longo prazo fornecido pelos buckets do Logging.

As entradas de registro recebidas com carimbos de data/hora que são maiores que o período de armazenamento de registros no passado ou que são mais de 24 horas no futuro são descartadas.

Coletores

Os coletores controlam como o Cloud Logging encaminha registros. Usando coletores, é possível rotear alguns ou todos os seus registros para destinos compatíveis. Estes são alguns dos motivos para você controlar como os registros são roteados:

  • Para armazenar registros que provavelmente não serão lidos, mas que precisam ser retidos para fins de conformidade.
  • Para organizar os registros em buckets de um formato que seja útil.
  • Para ferramentas de análise de Big Data nos registros.
  • Para transmitir os registros para outros aplicativos, outros repositórios ou terceiros. Por exemplo, se você quiser exportar seus registros do Google Cloud para poder visualizá-los em uma plataforma de terceiros, configure um coletor para rotear suas entradas de registro para o Pub/Sub.

Os coletores pertencem a um determinado recurso do Google Cloud: projetos, contas de faturamento, pastas e organizações do Google Cloud. Quando o recurso recebe uma entrada de registro, ele encaminha a entrada de registro de acordo com os coletores contidos nele e, se ativado, todos os coletores pertencentes à hierarquia de recursos. de dados. A entrada de registro é enviada para o destino associado a cada coletor correspondente.

O Cloud Logging fornece dois coletores predefinidos para cada projeto, conta de faturamento, pasta e organização do Google Cloud: _Required e _Default. Todos os registros gerados em um recurso são processados automaticamente por meio desses dois coletores e armazenados no nome correspondente._Required ou os_Default Baldes.

Os coletores funcionam de forma independente. Independentemente de como os coletores predefinidos processam as entradas de registro, é possível criar os próprios coletores para rotear alguns ou todos os registros para vários destinos compatíveis ou excluí-los de armazenado pelo Cloud Logging.

O comportamento de roteamento de cada coletor é controlado ao configurar o filtro de inclusão e os filtros de exclusão para esse coletor. Dependendo da configuração do coletor, cada entrada de registro recebida pelo Cloud Logging se enquadra em uma ou mais destas categorias:

  • Armazenada no Cloud Logging e não roteada em outro lugar.

  • Armazenada no Cloud Logging e roteada para um destino compatível.

  • não está armazenado no Cloud Logging, mas foi roteado para um destino compatível.

  • nem armazenados no Cloud Logging nem roteados para outros lugares.

Geralmente, você cria coletores no nível do projeto do Google Cloud. No entanto, se você quiser combinar e rotear registros dos recursos contidos por uma organização ou pasta do Google Cloud, crie coletores agregados.

Não é possível rotear entradas de registro que o Logging recebeu antes da criação do coletor porque o roteamento acontece à medida que os registros são transmitidos pela API Logging, e novas regras de roteamento só se aplicam a registros gravados depois que essas regras são criadas de dados. Se você precisar rotear as entradas de registro de forma retroativa, consulte Copiar registros.

Filtros de inclusão

Para qualquer novo coletor, se você não especificar filtros, todos os registros corresponderão e serão roteados para o destino do coletor. Configure o coletor para selecionar registros específicos definindo um filtro de inclusão. Também é possível definir um ou mais filtros de exclusão para excluir registros do destino do coletor.

Ao configurar coletores, você cria filtros de inclusão usando a linguagem de consulta do Logging. Os coletores também podem conter vários filtros de exclusão.

Cada entrada de registro recebida pelo Logging é roteada com base nestas regras de filtragem:

  • Os filtros de exclusão do coletor modificam os filtros de inclusão definidos. Se um registro corresponder a qualquer filtro de exclusão no coletor, ele não corresponderá ao coletor, independentemente dos filtros de inclusão definidos. A entrada de registro não é roteada para o destino desse coletor.

  • Se o coletor não contiver um filtro de inclusão, ocorrerá o seguinte:

    • Se a entrada de registro corresponder a qualquer filtro de exclusão, ela não será roteada para o destino do coletor.
    • Se a entrada de registro não corresponder a nenhum filtro de exclusão, ela será roteada para o destino do coletor. Um filtro de inclusão vazio seleciona todos os registros.
  • Se o coletor tiver um filtro de inclusão, acontecerá o seguinte:

    • Se a entrada de registro corresponder ao filtro de inclusão, ela será roteada para o destino do coletor.
    • Se a entrada de registro não corresponder ao filtro de inclusão, ela não será roteada para o destino do coletor.

Filtros de exclusão

Ao criar um coletor, você pode definir vários filtros de exclusão. Com os filtros de exclusão, é possível impedir que entradas de registro correspondentes sejam roteadas para o destino do coletor ou armazenadas em um bucket de registros. Você cria filtros de exclusão usando a linguagem de consulta do Logging.

As entradas de registro são excluídas depois de recebidas pela API Logging. Portanto, elas consomem a cota da API entries.write. Não é possível reduzir o número de chamadas de API entries.write excluindo entradas de registro.

As entradas de registro excluídas não ficam disponíveis na Análise de registros.

As entradas de registro que não são roteadas para pelo menos um bucket de registro, seja explicitamente com filtros de exclusão ou porque não correspondem a nenhum coletor com um destino de armazenamento do Logging, também são excluídas do Error Reporting. Portanto, esses registros não estão disponíveis para solucionar falhas.

As métricas com base em registros definidas pelo usuário são calculadas com base nas entradas de registro nos registros incluídos e excluídos. Para mais informações, consulte Monitorar seus registros.

Destinos possíveis

Use o roteador para rotear determinados registros para destinos compatíveis em qualquer projeto do Google Cloud. O Logging é compatível com os seguintes destinos de coletor:

  • Buckets de registros do Cloud Logging: fornece armazenamento no Cloud Logging. Um bucket de registros pode armazenar registros recebidos por vários projetos do Google Cloud. É possível combinar os dados do Cloud Logging com outros dados fazendo upgrade de um bucket de registros para usar a Análise de dados de registros e, em seguida, criando um conjunto de dados do BigQuery vinculado. Para informações sobre como visualizar registros armazenados em buckets de registros, consulte Visão geral de consulta e visualização de registros e Visualizar registros roteados para buckets do Cloud Logging.
  • Projetos do Google Cloud: roteie entradas de registro para outro projeto do Google Cloud. Quando você encaminha registros para um projeto diferente do Google Cloud, o roteador de registros do projeto de destino recebe e processa os registros. Os coletores no projeto de destino determinam como as entradas de registro recebidas são roteadas. As entradas de registro que são roteadas para um projeto diferente do Google Cloud por buckets de registros não podem ser analisadas pelo Error Reporting.
  • Tópicos do Pub/Sub: fornece suporte para integrações de terceiros, como Splunk. As entradas de registro são formatadas em JSON e roteadas para um tópico do Pub/Sub. Para informações sobre como visualizar registros roteados para o Pub/Sub, consulte Visualizar registros roteados para o Pub/Sub.
  • Conjuntos de dados do BigQuery: fornece armazenamento de entradas de registro nos conjuntos de dados do BigQuery. Você pode usar recursos de análise de Big Data nos registros armazenados. Para combinar os dados do Cloud Logging com outras fontes de dados, recomendamos fazer upgrade dos buckets de registros para usar a Análise de dados de registros e, em seguida, criar um conjunto de dados vinculado do BigQuery. Para mais informações sobre como visualizar registros roteados para o BigQuery, consulte Visualizar registros roteados para o BigQuery.
  • Buckets do Cloud Storage: armazenam dados de registro no Cloud Storage. As entradas de registro são armazenadas como arquivos JSON. Para mais informações sobre como visualizar registros roteados para o Cloud Storage, consulte Visualizar registros roteados para o Cloud Storage.

Para mais informações, consulte Rotear registros para destinos compatíveis.

Como armazenar, visualizar e gerenciar registros

A seção a seguir detalha como os registros são armazenados no Cloud Logging e como você pode visualizá-los e gerenciá-los.

Buckets de registros

O Cloud Logging usa buckets de registros como contêineres nos projetos, contas de faturamento, pastas e organizações do Google Cloud para armazenar e organizar dados de registros. Os registros armazenados no Cloud Logging são indexados, otimizados e entregues para que você possa analisar os registros em tempo real. Os buckets do Cloud Logging são entidades de armazenamento diferentes dos buckets do Cloud Storage com nomes semelhantes.

Para cada projeto, conta de faturamento, pasta e organização do Google Cloud, o Logging cria automaticamente dois buckets de registro: _Required e _Default. O Logging cria automaticamente coletores chamados _Required e _Default que, na configuração padrão, encaminham registros para os buckets correspondentes.

É possível desativar o coletor _Default, que encaminha os registros para o bucket _Default. É possível alterar o comportamento dos coletores _Default criados para qualquer novo projeto ou pasta do Google Cloud. Para mais informações, consulte Definir configurações padrão para organizações e pastas.

Não é possível alterar as regras de roteamento do bucket _Required.

Além disso, é possível criar buckets definidos pelo usuário para qualquer projeto do Google Cloud.

Você cria coletores para rotear todos os registros ou apenas um subconjunto deles para qualquer bucket de registro. Essa flexibilidade permite escolher o projeto do Google Cloud em que seus registros serão armazenados e quais outros registros serão armazenados com eles.

Para mais informações, acesse Configurar buckets de registros.

Bucket de registro _Required

O Cloud Logging encaminha automaticamente os seguintes tipos de registros para o bucket _Required:

O Cloud Logging mantém os registros no bucket _Required por 400 dias. Não é possível alterar esse período de armazenamento.

Não é possível modificar ou excluir o bucket _Required. Não é possível desativar o coletor _Required, que encaminha registros para o bucket _Required.

Bucket de registro _Default

Qualquer entrada de registro que não esteja armazenada no bucket _Required será roteada pelo coletor _Default para o bucket _Default, a menos que você desative ou edite o coletor _Default. Para instruções sobre como modificar coletores, consulte Gerenciar coletores.

Por exemplo, o Cloud Logging encaminha automaticamente os seguintes tipos de registros para o bucket _Default:

O Cloud Logging mantém os registros no bucket _Default por 30 dias, a menos que você configure a retenção personalizada para o bucket.

Não é possível excluir o bucket _Default.

Buckets de registros definidos pelo usuário

Também é possível criar buckets de registros definidos pelo usuário em qualquer projeto do Google Cloud. Ao aplicar coletores aos buckets de registro definidos pelo usuário, é possível rotear qualquer subconjunto de registros para qualquer bucket de registros, permitindo escolher em qual projeto do Google Cloud seus registros serão armazenados e quais outros registros serão armazenados com eles.

Por exemplo, em qualquer registro gerado no Projeto A, é possível configurar um coletor para rotear esse registro para buckets definidos pelo usuário no Projeto A ou do Projeto B.

É possível configurar a retenção personalizada para o bucket.

Para mais informações sobre como gerenciar buckets de registros definidos pelo usuário, inclusive excluir ou atualizar, consulte Configurar e gerenciar buckets de registros.

Regionalização

Buckets de registro são recursos regionais. A infraestrutura que armazena, indexa e pesquisa seus registros está localizada em uma localização geográfica específica. O Google gerencia essa infraestrutura para que os aplicativos estejam disponíveis de maneira redundante nas zonas dessa região.

Ao criar um bucket de registros ou definir uma política regional no nível da organização, é possível optar por armazenar seus registros em qualquer uma das seguintes regiões:

África

Nome da região Descrição da região Suporte à Análise de dados de registros
africa-south1 Johannesburgo Sim

Américas

Nome da região Descrição da região Suporte à Análise de dados de registros
northamerica-northeast1 Montreal Sim
northamerica-northeast2 Toronto Sim
southamerica-east1 São Paulo Sim
southamerica-west1 Santiago Sim
us-central1 Iowa Sim
us-east1 Carolina do Sul Sim
us-east4 Virgínia do Norte Sim
us-east5 Columbus Sim
us-south1 Dallas Sim
us-west1 Oregon Sim
us-west2 Los Angeles Sim
us-west3 Salt Lake City Sim
us-west4 Las Vegas Sim
us-west8 Phoenix

Ásia-Pacífico

Nome da região Descrição da região Suporte à Análise de dados de registros
asia-east1 Taiwan Sim
asia-east2 Hong Kong Sim
asia-northeast1 Tóquio Sim
asia-northeast2 Osaka Sim
asia-northeast3 Seul Sim
asia-south1 Mumbai Sim
asia-south2 Délhi Sim
asia-southeast1 Singapura Sim
asia-southeast2 Jacarta Sim
australia-southeast1 Sydney Sim
australia-southeast2 Melbourne Sim

Europa

Nome da região Descrição da região Suporte à Análise de dados de registros
europe-central2 Varsóvia Sim
europe-north1 Finlândia Sim
europe-southwest1 Madri Sim
europe-west1 Bélgica Sim
europe-west2 Londres Sim
europe-west3 Frankfurt Sim
europe-west4 Países Baixos Sim
europe-west6 Zurique Sim
europe-west8 Milão Sim
europe-west9 Paris Sim
europe-west10 Berlim Sim
europe-west12 Turim Sim

Oriente Médio

Nome da região Descrição da região Suporte à Análise de dados de registros
me-central1 Doha Sim
me-central2 Damã Sim
me-west1 Tel Aviv Sim

Outro

Nome da região Descrição da região Suporte à Análise de dados de registros
eu Registros armazenados em data centers na União Europeia, sem garantias de redundância extra Sim
us Registros armazenados em data centers nos Estados Unidos, sem garantias de redundância extra Sim
global Registros armazenados em qualquer data center do mundo, sem garantias adicionais de redundância Sim

Além dessas regiões, é possível definir o local como global, o que significa que você não precisa especificar onde seus registros estão fisicamente armazenados.

É possível aplicar automaticamente uma determinada região de armazenamento aos buckets _Default e _Required criados em uma organização ou pasta. Para mais informações, consulte Definir configurações padrão para organizações e pastas.

Para mais informações sobre regionalidade de dados e onde é possível armazenar os dados dos registros, consulte Entender as regiões de dados.

Política da organização

Crie uma política da organização para garantir que sua organização atenda às necessidades regulatórias e de conformidade. Com uma política da organização, é possível especificar em quais regiões sua organização pode criar novos buckets de registro. Também é possível impedir que sua organização crie novos buckets de registro em regiões específicas.

O Cloud Logging não aplica a política da organização recém-criada aos buckets de registros atuais. Ele apenas aplica a política aos novos buckets de registros.

Saiba como criar uma política da organização com base no local em Restringir locais de recursos.

Além disso, é possível configurar um local de armazenamento padrão para os buckets _Default e _Required em uma organização ou em uma pasta. Se você configurar uma política da organização que restringe o local de armazenamento dos dados, garanta que o local de armazenamento padrão especificado seja consistente com essa restrição. Para mais informações, consulte Definir configurações padrão para organizações e pastas.

Retenção

O Cloud Logging retém registros de acordo com as regras de retenção que se aplicam ao tipo de bucket de registros em que os registros são retidos.

É possível configurar o Cloud Logging para reter registros por 1 dia e até 3.650 dias. As regras de retenção personalizadas se aplicam a todos os registros de um bucket, independentemente do tipo de registro ou se ele foi copiado de outro local.

Para informações sobre como definir regras de retenção para um bucket de registros, consulte Configurar retenção personalizada.

Para informações sobre os períodos de armazenamento para diferentes tipos de registros, consulte Cotas e limites.

Visualizações de registro

Com as visualizações de registros, é possível conceder a um usuário acesso apenas a um subconjunto dos registros armazenados em um bucket de registros. Para informações sobre como configurar visualizações de registros e conceder acesso a visualizações específicas, consulte Configurar visualizações de registros em um bucket de registros.

Para cada bucket de registros, o Cloud Logging cria automaticamente a visualização _AllLogs, que mostra todos os registros armazenados nesse bucket. O Cloud Logging também cria uma visualização para o bucket _Default chamado _Default. A visualização _Default do bucket _Default mostra todos os registros, exceto os de auditoria de acesso a dados. As visualizações _AllLogs e _Default não são editáveis, e não é possível excluir a visualização de registro _Default.

As visualizações de registros personalizadas oferecem uma maneira avançada e granular de controlar o acesso aos dados de registros. Por exemplo, imagine um cenário em que você armazena todos os registros da organização em um projeto central do Google Cloud. Como os buckets de registros podem conter registros de vários projetos do Google Cloud, é recomendável controlar de quais projetos do Google Cloud os diferentes usuários podem visualizar registros. Com as visualizações de registros personalizadas, é possível conceder a um usuário acesso aos registros somente de um único projeto do Google Cloud, e a outro usuário pode acessar os registros de todos os projetos do Google Cloud.

Como usar registros no ecossistema do Google Cloud

A seção a seguir fornece informações sobre como usar registros no Google Cloud mais amplo.

Métricas com base em registros

As métricas com base em registros são métricas do Cloud Monitoring derivadas do conteúdo das entradas de registro. Por exemplo, se o Cloud Logging receber uma entrada de registro para um projeto do Google Cloud que corresponda aos filtros de uma das métricas do projeto do Google Cloud, essa entrada de registro será contada nos dados da métrica.

As métricas com base em registros interagem com o roteamento de maneira diferente, dependendo se são definidas pelo sistema ou por você. As seções abaixo descrevem essas diferenças.

Métricas com base em registros e filtros de exclusão

Os filtros de exclusão de coletores são aplicados às métricas com base em registros definidas pelo sistema, que contam apenas os registros armazenados em buckets.

Os filtros de exclusão de coletor não se aplicam a métricas com base em registros definidas pelo usuário. Mesmo que você exclua os registros para que não sejam armazenados em qualquer bucket do Logging, é possível ver os registros contados nessas métricas.

Escopo das métricas com base em registros

As métricas com base em registros definidas pelo sistema são aplicadas a projetos do Google Cloud. Essas métricas são calculadas pelo roteador de registros e se aplicam apenas aos registros no projeto do Google Cloud em que são recebidos.

As métricas com base em registros definidas pelo usuário podem ser aplicadas a projetos do Google Cloud ou a buckets de registros específicos:

  • As métricas no nível do projeto são calculadas como as métricas com base em registros definidas pelo sistema. Essas métricas definidas pelo usuário se aplicam somente aos registros no projeto do Google Cloud em que são recebidas.
  • As métricas com escopo de bucket se aplicam a registros no bucket de registros em que são recebidas, independentemente do projeto do Google Cloud de onde as entradas de registro foram originadas.

    Com as métricas com base em registro com escopo de bucket, é possível criar métricas que avaliam os registros nos seguintes casos:

    • Registros que são encaminhados de um projeto a um bucket em outro projeto.
    • Registros que são encaminhados a um bucket com um coletor agregado.

Para mais informações, consulte Visão geral das métricas com base em registros.

Como encontrar registros em destinos compatíveis

Para saber mais sobre o formato das entradas de registro roteadas e como os registros são organizados nos destinos, consulte Visualizar registros nos destinos do coletor.

Casos de uso comuns

Para abordar casos de uso comuns de roteamento e armazenamento de registros, consulte os seguintes documentos e tutoriais:

Requisitos de conformidade

Para conferir as práticas recomendadas sobre o uso do roteamento para governança de dados, consulte os seguintes documentos:

Controle de acesso com o IAM

Para informações sobre como usar papéis e permissões do Identity and Access Management (IAM) para controlar o acesso aos dados do Cloud Logging, consulte Controle de acesso com o IAM.

Preços

O Cloud Logging não cobra para rotear os registros para um destino compatível. No entanto, o destino pode aplicar cobranças. Com exceção do bucket de registros _Required, o Cloud Logging cobra para transmitir registros para buckets de registros e para armazenamento mais longo que o período de armazenamento padrão do bucket de registros.

O Cloud Logging não cobra pela cópia de registros ou por consultas emitidas na página Análise de registros ou na Análise de registros.

Para mais informações, consulte estes documentos:

A seguir

Para ajudar você a rotear e armazenar dados do Cloud Logging, consulte os seguintes documentos: