Migrar para a Análise de observabilidade

Visualizar

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se você estiver usando gravadores para exportar dados de rastreamento para o BigQuery, este documento é para você. O uso de coletores para exportar dados de rastreamento não é mais recomendado. Em vez disso, recomendamos usar a análise de observabilidade, que oferece suporte à mesma linguagem de consulta SQL do BigQuery. Este documento descreve como migrar de uma solução baseada em gravador para uma que use o Observability Analytics. Ele também inclui informações sobre como consultar seus dados de rastreamento usando os serviços do BigQuery.

Para começar a usar a análise de observabilidade, consulte Consultar e analisar traces.

Antes de começar

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Para receber as permissões necessárias para carregar a página Análise de observabilidade, executar consultas e criar um conjunto de dados vinculado, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

   • Administrador do Cloud Trace (roles/cloudtrace.admin)
   • Editor de observabilidade (roles/observability.editor)
   • Usuário do BigQuery (roles/bigquery.user)

   Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

   Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

2. No console do Google Cloud , ative o Cloud Shell.

   Ativar o Cloud Shell

   Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

Migrar para a Análise de observabilidade

1. Concluiu as ações listadas na seção Antes de começar deste documento. Essas ações incluem ativar a API Observability.

2. Verifique se você tem acesso aos dados de rastreamento usando o Observability Analytics:

   1. No console Google Cloud , acesse a página Análise de dados de registros:

      Acesse 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. No menu Visualizações, acesse a seção Rastreamentos do e selecione _Trace.Spans._AllSpans.

      O painel Esquema é atualizado e mostra o esquema.

      Se você não encontrar uma visualização chamada _Trace.Spans._AllSpans, seu projetoGoogle Cloud não terá um bucket de observabilidade chamado _Trace. Para informações sobre como resolver essa situação, consulte Falha na inicialização do armazenamento de rastreamentos.

   3. No painel Esquema, selecione Consulta.

      O campo do editor de consultas é atualizado. A cláusula FROM lista uma entrada semelhante a esta:

      `PROJECT_ID.us._Trace.Spans._AllSpans`
      

   4. Na barra de ferramentas, selecione Executar consulta.

      Se a barra de ferramentas mostrar Executar no BigQuery, clique em Configurações e selecione Analytics (padrão).

   Você verificou que pode consultar os dados de rastreamento usando a página Análise de observabilidade.

3. Opcional: se você quiser mesclar os dados de trace a outros dados da empresa disponíveis para o BigQuery, crie um conjunto de dados vinculado do BigQuery. Para mais informações, consulte Consultar um conjunto de dados vinculado do BigQuery.

4. Exclua os coletores de rastreamento e os conjuntos de dados desnecessários:

   1. Para listar os coletores de rastreamento atuais, execute o comando gcloud alpha trace sinks list:

      gcloud alpha trace sinks list
      

   2. Para cada coletor, execute o comando gcloud alpha trace sinks delete:

      gcloud alpha trace sinks delete SINK_NAME
      

   3. Opcional: exclua os conjuntos de dados desnecessários do BigQuery. Para informações sobre como excluir um conjunto de dados do BigQuery, consulte Excluir conjuntos de dados.

Comparação de esquemas

Esta seção fornece informações sobre as diferenças entre os esquemas de exportação baseados em gravadores e a análise de observabilidade.

Nome	Analytics	Legado
ID do Trace	trace_id	extendedFields.traceId
ID do período	span_id	span.spanId
ID do período pai	parent_span_id	span.parentSpanId
Nome do período	name	span.displayName.value
Tipo de período	kind Para valores, consulte OpenTelemetry: SpanKind.	span.spanKind Para valores, consulte a página de referência da API Cloud Trace SpanKind.
Horário de início do período	start_time	span.startTime
Horário de término do período	end_time	span.endTime
Atributos	Os atributos de extensão, recurso e instrumentação têm um formato exclusivo. Esses campos têm o tipo de dados JSON do BigQuery. Exemplos: attributes["somekey"] resource.attributes["somekey"] instrumentation_scope.attributes["somekey"]	Todos os atributos usam o mesmo formato: span.attributes.attributeMap.ATTRIBUTE_KEY Exemplos: span.attributes.attributeMap._http_method span.attributes.attributeMap.g_co_agent span.attributes.attributeMap.rpc_service span.attributes.attributeMap.rpc_method

A seguir

• Consultar e analisar traces.
• Amostras de consultas.