Visão geral do armazenamento de rastreamentos

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

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

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 para 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 serviço Google Cloud usa a API Observability para armazenar dados, o sistema cria um bucket de observabilidade com base no nome do serviço. Por exemplo, para o serviço Cloud Trace, o bucket criado pelo sistema é chamado de _Trace. Para saber mais sobre a estrutura de um bucket de observabilidade, consulte Bucket.
Conjuntos de dados
Um conjunto de dados é uma entidade de armazenamento. Cada conjunto de dados é filho de um bucket de observabilidade. Quando o sistema cria um bucket de observabilidade para um serviço Google Cloud , ele também cria um conjunto de dados. Por exemplo, depois que o sistema cria o bucket _Trace, ele cria o conjunto de dados chamado Spans. Esse conjunto de dados armazena seus dados de rastreamento. 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 oferece acesso de leitura a um subconjunto de entradas no conjunto de dados. Quando um conjunto de dados é criado, o sistema cria automaticamente uma visualização. Essa visualização inclui todos os dados do conjunto. 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 vínculo 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 rastreamento

Seus dados de rastreamento 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 do conjunto de dados.

O sistema faz uma única tentativa de criar o bucket chamado _Trace quando ele não existe e uma das seguintes condições é verdadeira:

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

  • Você ativa o Cloud Trace para um serviço Google Cloud , e esse serviço envia dados de rastreamento para seu projeto Google Cloud . Por exemplo, o Cloud Service Mesh aceita a coleta de rastreamentos, mas ela fica desativada por padrão. Se você ativar o rastreamento para o Cloud Service Mesh, os dados enviados por esse serviço farão com que o sistema crie o bucket.

    Os dados de rastreamento 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ó são armazenados quando o bucket de observabilidade existe.

Para determinar se o bucket de observabilidade chamado _Trace existe ou para acionar um fluxo que cria esse bucket, faça o seguinte:

  1. No console Google Cloud , acesse a página Explorador de traces:

    Acessar o Explorador de traces

    Também é possível encontrar essa página usando a barra de pesquisa.

  2. Escolha uma destas opções:

    • Se a página mostrar dados de rastreamento, não é preciso fazer nada. Seu projetoGoogle Cloud contém um bucket de observabilidade chamado _Trace.

    • Se a página mostrar o banner a seguir, significa que ela não tem dados de rastreamento ou só tem dados do Cloud Run functions, do Cloud Run e do App Engine.

      Trace storage is not initialized for this project. Enable trace storage to begin collecting trace data.

      Se você quiser acionar um fluxo que cria um bucket de observabilidade chamado _Trace, acesse o banner e clique em Ativar.

    • Se a página mostrar o banner a seguir, a inicialização do bucket de observabilidade chamado _Trace falhou. Se você receber essa mensagem, acesse o banner e clique em Enviar um tíquete.

      Initializing trace storage has failed for an unexpected reason. Please file a support ticket for assistance.

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 console do Google Cloud para listar intervalos, conjuntos de dados, visualizações ou links.
  • Crie buckets de observabilidade em locais diferentes de us. Um bucket de observabilidade precisa estar no local us.

A seguir