Visão geral do armazenamento de rastreamentos

Este documento descreve o modelo de armazenamento de dados do Cloud Trace. Ele apresenta buckets e visualizações de observabilidade, além de links. Se você criar um link, poderá consultar os dados de trace no BigQuery.

Este documento não descreve o esquema, que especifica como os intervalos individuais são armazenados. Para saber mais, consulte Esquema de trace.

Modelo de armazenamento de observabilidade

O modelo de armazenamento da API Observability depende da seguinte arquitetura:

Buckets de observabilidade
Um bucket de observabilidade é a entidade de gerenciamento de conjuntos de dados, que armazenam dados. Um bucket de observabilidade está em um local específico e tem uma política de retenção de dados. Quando um Google Cloud serviço usa a API Observability para armazenar dados, o sistema cria um bucket de observabilidade com base no nome do serviço, um conjunto de dados para armazenar dados e uma visualização para fornecer acesso de leitura aos dados armazenados. Por exemplo, para o serviço Cloud Trace, o sistema nomeia o bucket criado pelo sistema como _Trace, o conjunto de dados como Spans e a visualização _AllSpans. Para saber mais sobre a estrutura de um bucket de observabilidade, consulte Bucket.
Conjuntos de dados
Um conjunto de dados armazena dados. O sistema cria automaticamente um conjunto de dados quando cria um bucket de observabilidade, que gerencia o conjunto de dados. Por exemplo, quando o sistema cria o bucket _Trace, ele também cria um conjunto de dados chamado Spans, que armazena os dados de trace. Para saber mais sobre a estrutura de um conjunto de dados, consulte Dataset.
Visualizações em conjuntos de dados
Cada conjunto de dados hospeda uma ou mais visualizações. Uma visualização fornece acesso de leitura a um subconjunto de entradas no conjunto de dados. O sistema cria uma visualização quando cria um conjunto de dados. Essa visualização inclui todos os dados no conjunto de dados. O nome da visualização depende do serviço. Por exemplo, para o serviço Cloud Trace, o sistema cria uma visualização chamada _AllSpans no conjunto de dados Spans. Para saber mais sobre a estrutura de uma visualização, consulte View.
Links em conjuntos de dados

Cada conjunto de dados pode conter no máximo um link. Quando você cria um link para um conjunto de dados, o sistema cria um conjunto de dados vinculado do BigQuery. Em seguida, você pode consultar os dados no conjunto de dados usando o BigQuery ou outros serviços que usam a API BigQuery. Para saber mais sobre a estrutura de um link, consulte Link.

O sistema não cria links automaticamente em conjuntos de dados.

Configuração de armazenamento para dados de trace

Os dados de trace são armazenados em um bucket de observabilidade chamado _Trace. O sistema cria um conjunto de dados chamado Spans nesse bucket. Nesse conjunto de dados, o sistema cria uma visualização chamada _AllSpans. Essa visualização inclui todos os dados no conjunto de dados.

O sistema tenta criar o bucket de observabilidade chamado _Trace quando o bucket não existe e uma das seguintes condições é verdadeira:

  • Um aplicativo envia dados de trace para seu Google Cloud projeto usando a API Cloud Trace ou a API Telemetry.

  • Você ativa o Cloud Trace para um Google Cloud serviço, e esse serviço envia dados de trace para seu Google Cloud projeto. Por exemplo, o Cloud Service Mesh oferece suporte à coleta de traces. No entanto, a coleta de traces está desativada por padrão. Se você ativar o trace para o Cloud Service Mesh, os dados enviados por esse serviço farão com que o sistema crie o bucket.

    Os dados de trace gerados pelas funções do Cloud Run, pelo Cloud Run e pelo App Engine não fazem com que o sistema crie o bucket de observabilidade. Os intervalos desses serviços são armazenados apenas quando o bucket de observabilidade existe.

Se você puder visualizar os dados de trace usando a página Explorador de traces, o bucket de observabilidade chamado _Trace existe. Se você não encontrar dados ou se vir um banner informando que o armazenamento não foi inicializado, tente uma das seguintes opções:

Residência de dados para buckets de observabilidade

Se você tiver requisitos de compliance ou regulamentares para armazenar seus dados em locais específicos ou usar a CMEK, recomendamos que você configure as configurações padrão para buckets de observabilidade:

  • Para organizações, pastas e projetos, as configurações padrão para buckets de observabilidade permitem configurar o seguinte:

    • Um local de armazenamento padrão.
    • Para cada local, uma chave padrão do Cloud Key Management Service.

    Os descendentes na hierarquia de recursos usam essas configurações automaticamente, exceto aqueles em que você configurou as configurações padrão.

    As configurações padrão para buckets de observabilidade se aplicam apenas a novos recursos, não aos recursos atuais. Para saber mais, consulte Definir padrões para buckets de observabilidade.

As configurações padrão para buckets de observabilidade não se aplicam a buckets de registros, que armazenam dados de registro. Para saber como definir o local padrão ou exigir a CMEK para buckets de registros, consulte Configurar as configurações de recursos padrão para o Cloud Logging.

Limitações

Não é possível fazer o seguinte:

  • Modificar ou excluir buckets de observabilidade.
  • Criar, excluir ou modificar conjuntos de dados.
  • Criar, excluir ou modificar visualizações.
  • Use o Google Cloud console para listar buckets, conjuntos de dados, visualizações ou links.

A seguir