Panoramica dell'API

Questa pagina fornisce una breve panoramica dell'API Observability e dell'API Telemetry (OTLP).

Informazioni sull'API Observability

L'API Observability ti consente di:

  • Configura le impostazioni predefinite per i bucket di osservabilità per progetti, cartelle e organizzazioni. Queste impostazioni ti aiutano a soddisfare i requisiti normativi e di conformità. Puoi configurare quanto segue:

    • Una posizione di archiviazione predefinita per i nuovi bucket di osservabilità.
    • Per ogni località, una chiave Cloud Key Management Service predefinita. Questa chiave viene utilizzata per criptare i nuovi bucket di osservabilità.

    Per saperne di più, consulta Imposta i valori predefiniti per i bucket di osservabilità.

  • Configura l'ambito di osservabilità per il tuo progetto. Questo ambito controlla le risorse in cui le pagine di esplorazione cercano i dati di log, metriche e traccia. Per saperne di più, consulta Configura gli ambiti di osservabilità.

  • Elenca le informazioni sui bucket di osservabilità nel tuo progetto Google Cloud . I dati di traccia vengono archiviati in un bucket osservabilità. Per informazioni sul modello dei datii, consulta Panoramica dell'archiviazione.

  • Crea un collegamento a un set di dati, che consente a BigQuery di avere accesso in lettura al set di dati. Per scoprire come creare un set di dati collegato, consulta Gestire l'archiviazione.

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. L'API Observability supporta un endpoint globale e endpoint regionali:

  • Endpoint globale: observability.googleapis.com.

    Puoi utilizzare l'endpoint di servizio globale per eseguire qualsiasi operazione supportata dall'API Observability. Inoltre, per questo endpoint, il comando list observability buckets ti consente di sostituire il campo della località nel parametro path con il carattere jolly (-).

  • Endpoint regionali: observability.REGION.rep.googleapis.com, dove REGION è una regione supportata. Per un elenco degli endpoint, consulta Endpoint di servizio a livello di regione.

    Puoi utilizzare un endpoint di servizio regionale solo quando la località fornita nel parametro del percorso corrisponde alla regione dell'endpoint. I comandi inviati a questi endpoint di servizio non vanno a buon fine se includono un carattere jolly o se la località differisce dalla regione dell'endpoint.

Riferimento API

Informazioni sull'API Telemetry

L'API Telemetry (OTLP) è un'implementazione del protocollo OpenTelemetry OTLP. L'API Telemetry offre compatibilità e supporto per l'ecosistema open source OpenTelemetry:

  • Log: l'API Telemetry consente di importare record di log in formato OTLP nel tuo progetto. Per saperne di più, consulta Scrivere log OTLP nell'API Telemetry.

  • Metriche: l'API Telemetry consente di importare metriche in formato OTLP in Cloud Monitoring utilizzando l'esportatore otlphttp e un agente di raccolta OpenTelemetry o un SDK OpenTelemetry. Per saperne di più, consulta la panoramica dell'importazione delle metriche OTLP.

  • Tracce: l'API Telemetry consente di inviare dati di traccia in formato OTLP al tuo progetto. Inoltre, i limiti di traccia per l'API Telemetry sono spesso più generosi di quelli per l'Cloud Trace API.

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. L'API Telemetry supporta un endpoint globale e endpoint regionali:

  • Endpoint globale: telemetry.googleapis.com. Per questo endpoint, dopo che Google Cloud Observability completa correttamente tutti i passaggi di convalida, invia i dati a un servizio di backend per l'archiviazione.

  • Endpoint regionali: telemetry.REGION.rep.googleapis.com, dove REGION è una regione supportata. Per questi endpoint, dopo che Google Cloud Observability completa correttamente tutti i passaggi di convalida, invia i dati a un servizio di backend. Questo servizio archivia o elimina i dati:

    • I dati di log e traccia vengono archiviati. Il servizio di backend sposta automaticamente i dati tra le regioni quando necessario.
    • I dati delle metriche vengono archiviati solo quando l'etichetta di località allegata ai dati corrisponde alla regione dell'endpoint o a una zona all'interno di quella regione.

    Per un elenco degli endpoint regionali supportati, consulta le pagine di riferimento dell'API.

L'importazione dei dati di traccia può attivare la creazione di un bucket osservabilità. Tuttavia, l'utilizzo di un endpoint regionale non influisce sulla posizione in cui il sistema crea il bucket di osservabilità. Il sistema determina la posizione di un bucket di osservabilità utilizzando le impostazioni predefinite, le policy dell'organizzazione e l'insieme delle posizioni dei bucket supportate.

Riferimento API

Per saperne di più sull'API Telemetry, consulta i seguenti documenti: