Crea un set di dati BigQuery collegato

Puoi creare un set di dati BigQuery collegato al tuo set di dati di osservabilità, che ti consente di utilizzare i servizi BigQuery per eseguire query sui dati di traccia. Puoi quindi unire i dati di traccia ai set di dati aziendali e analizzare gli intervalli utilizzando BigQuery Studio o l'API BigQuery.

Se utilizzi Observability Analytics, non hai bisogno di un set di dati BigQuery collegato per analizzare i dati di traccia con SQL. Puoi anche unire i dati di traccia e di log quando utilizzi Observability Analytics. Per ulteriori informazioni, consulta Eseguire query e analizzare le tracce con SQL e Eseguire query e analizzare i log con Observability Analytics.

Quando hai bisogno di un set di dati collegato

Hai bisogno di un set di dati BigQuery collegato quando vuoi eseguire una delle seguenti operazioni:

  • Unire i dati di traccia ad altri set di dati BigQuery.
  • Esegui query sui dati di traccia da un altro servizio come BigQuery Studio o Data Studio.

  • Esegui query dalla pagina Observability Analytics sul motore BigQuery.

    La pagina Observability Analytics esegue automaticamente query sul motore di query predefinito, che utilizza slot senza costi. Tuttavia, puoi configurare questa pagina per eseguire query sul motore BigQuery.

  • Monitora i risultati delle query SQL con una policy di avviso.

  • Esegui pipeline di dati automatizzate, query analitiche continue o flussi di lavoro dell'agente AI che leggono in modo programmatico grandi volumi di dati di traccia senza limiti di frequenza dell'API Trace.

Crea un set di dati BigQuery collegato

Questa sezione descrive come creare un set di dati BigQuery collegato a un set di dati di osservabilità, che ti consente di utilizzare i servizi BigQuery per eseguire query sui dati di traccia. Ogni set di dati di osservabilità supporta un set di dati BigQuery collegato.

Quando crei un link in un set di dati di osservabilità, si verifica quanto segue:

  • Google Cloud Observability potrebbe creare i seguenti service account o modificare le relative concessioni di ruoli IAM:

  • I log di controllo registrano la richiesta di creazione di un collegamento e la richiesta dell'amministratore dell'agente di servizio di concedere all'account di servizio Monitoring il ruolo IAM di agente di servizio Monitoring. Questi log registrano anche il completamento dell'operazione a lunga esecuzione.

Prima di iniziare

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Cloud Monitoring and Observability APIs.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  5. 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Cloud Monitoring and Observability APIs.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

    8.

  8. Per ottenere le autorizzazioni necessarie per creare un link a un set di dati di osservabilità, chiedi all'amministratore di concederti il ruolo IAM Observability Editor (roles/observability.editor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

    Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea set di dati

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • LINK_ID: il nome del set di dati BigQuery.
  • DATASET_ID: l'ID del set di dati. I dati di tracciamento vengono archiviati in un set di dati denominato Spans.
  • BUCKET_ID: l'ID del bucket di osservabilità. Ad esempio, questo ID potrebbe essere _Trace.
  • LOCATION: la posizione dei bucket di osservabilità.
  • PROJECT_ID: L'identificatore del progetto.

Esegui il comando gcloud beta observability buckets datasets links create:

Linux, macOS o Cloud Shell

gcloud beta observability buckets datasets links create \
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID \
 --dataset=DATASET_ID\
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID

Windows (PowerShell)

gcloud beta observability buckets datasets links create `
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID `
 --dataset=DATASET_ID`
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID

Windows (cmd.exe)

gcloud beta observability buckets datasets links create ^
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID ^
 --dataset=DATASET_ID^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID

Il comando create avvia un'operazione a lunga esecuzione. Di seguito è riportato un esempio di risposta quando il comando ha esito positivo: 

Create request issued for: [mydataset]
Waiting for operation [projects/my-project/locations/us/operations/operation-1775164903749-64e80c9817833-9ff804b6-c3e9cbe7] to complete...done.
Created link [mydataset].

Terraform

Per creare un link in un set di dati di osservabilità, utilizza la risorsa Terraform google_observability_link e imposta i seguenti campi:

  • project: l'ID del progetto.
  • location: la posizione del link. Questa località deve corrispondere a quella del bucket di osservabilità.
  • bucket: l'ID del bucket di osservabilità. Ad esempio, _Trace.
  • dataset: l'ID del set di dati di osservabilità. Ad esempio, Spans.
  • link_id: l'ID del set di dati BigQuery.

Puoi anche aggiornare ed eliminare i link.

REST

Per creare un link a un set di dati BigQuery, invia una richiesta all'endpoint projects.locations.buckets.datasets.links.create.

Devi specificare il parametro padre, che ha il seguente formato:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

I campi nell'espressione precedente hanno i seguenti significati:

  • PROJECT_ID: l'identificatore del progetto.
  • LOCATION: la posizione del bucket di osservabilità.
  • BUCKET_ID: l'ID del bucket di osservabilità. Ad esempio, questo ID potrebbe essere _Trace.
  • DATASET_ID: l'ID del set di dati su cui viene eseguita la query. Ad esempio, questo ID potrebbe essere Spans.

Questo comando richiede un parametro di query e un corpo della richiesta:

  • Il parametro della query, linkId, deve essere specificato e impostato sul nome del set di dati BigQuery. Ad esempio, linkId="my_link". Il nome del set di dati BigQuery deve essere univoco per il tuo progetto Google Cloud , deve essere limitato a 100 caratteri e può includere solo lettere, cifre e trattini bassi.

  • Il corpo della richiesta è un oggetto Link. Il valore del campo name ha il seguente formato:

    projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID

    Il valore che fornisci per il campo name deve corrispondere al set di dati BigQuery collegato a cui fa riferimento il parametro della query.

    Il campo LINK_ID è il nome del set di dati BigQuery.

La risposta è un oggetto Operation. Questo oggetto contiene informazioni sullo stato di avanzamento del metodo. Al termine del metodo, l'oggetto Operation contiene i dati di stato.

Per un elenco completo degli endpoint dell'API Observability, consulta la documentazione di riferimento dell'API Observability.

Se si verificano errori di autorizzazione durante la creazione di un set di dati collegato, consulta Risolvere i problemi relativi alle autorizzazioni.

Passaggi successivi