Ativar a geração de registros

Este documento descreve como ativar a geração de registros no Rust. Registrar solicitações e respostas no console pode facilitar a solução de problemas de aplicativos.

Aviso: esses registros descritos neste documento são destinados ao uso na depuração de aplicativos. Os registros incluem solicitações completas e mensagens de resposta, que podem incluir informações sensíveis. Se você decidir ativar esses registros na produção, considere as implicações de segurança e privacidade primeiro.

Pré-requisitos

Este guia usa a API Secret Manager, que precisa ser ativada antes de você começar. Para saber como ativar os serviços, siga o Guia de início rápido do serviço.

Para instruções completas de configuração das bibliotecas do Rust, consulte Começar a usar o Rust.

Dependências

É necessário declarar as dependências no arquivo Cargo.toml:

cargo add google-cloud-secretmanager-v1 google-cloud-gax

Ativar a geração de registros

As bibliotecas de cliente do Rust usam o crate de rastreamento do Tokio para coletar diagnósticos com escopo, estruturados e com reconhecimento assíncrono. O crate de rastreamento separa as fontes de diagnósticos (como as bibliotecas de cliente do Rust) dos componentes que coletam esses diagnósticos usando a característica Subscriber. Há muitas implementações disponíveis para o Subscriber. Neste exemplo, vamos usar o fmt subscriber incluído no tracing-subscriber crate.

1. Adicione uma dependência ao crate tracing-subscriber:

   cargo add tracing tracing-subscriber
   

2. Escreva uma função que receba o ID do projeto como um parâmetro de função:

   /// # Parameters
   /// - `project_id`: the id of a Google Cloud project, or its numeric ID.
   ///   For example: `my-project`.
   pub async fn sample(project_id: &str) -> anyhow::Result<()> {

3. Introduza algumas declarações de uso para tornar o exemplo mais legível:

   use google_cloud_gax::paginator::ItemPaginator;
   use google_cloud_secretmanager_v1::client::SecretManagerService;
   use tracing_subscriber;

4. Inicialize o subscriber de rastreamento padrão:

   tracing_subscriber::fmt::init();

5. Inicialize um cliente com o rastreamento ativado. Observe a chamada para .with_tracing():

   let client = SecretManagerService::builder()
       .with_tracing()
       .build()
       .await?;

6. Em seguida, use o cliente para enviar uma solicitação:

   let mut items = client
       .list_secrets()
       .set_parent(format!("projects/{project_id}"))
       .by_item();
   println!("listing all secrets in project {project_id}");
   while let Some(secret) = items.next().await.transpose()? {
       println!("  {secret:?}");
   }
   println!("DONE");

Resposta esperada

A saída (ligeiramente editada para facilitar a leitura) vai incluir uma linha como:

2025-11-03T14:17:31.759452Z  INFO list_secrets{self=SecretManagerService ...

Essa linha inclui a solicitação:

req=ListSecretsRequest { parent: "projects/... }

A resposta:

return=Ok(Response { parts: ..., body: ListSecretsResponse { ...

Mais informações

O subscriber padrão criado usando tracing_subscriber::fmt::init() pode ser configurado dinamicamente usando a variável de ambiente RUST_LOG. Consulte a documentação para mais detalhes.