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:

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

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

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

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

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

  • Creare un link 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 ed 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 consente di sostituire il campo della località nel parametro del percorso 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 regionale.

    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à è diversa dalla regione dell'endpoint.

Riferimento API

Informazioni sull'API Telemetry

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

  • Log: l'API Telemetry consente di importare record di log in formato OTLP nel 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 Panoramica dell'importazione di metriche OTLP.

  • Tracce: l'API Telemetry consente di inviare dati di traccia in formato OTLP al progetto. Inoltre, i limiti di traccia per l' API Telemetry sono spesso più generosi rispetto ai limiti 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 ed endpoint regionali:

  • Endpoint globale: telemetry.googleapis.com. Per questo endpoint, dopo che Google Cloud Observability ha completato 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 ha completato 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, se necessario.
    • I dati delle metriche vengono archiviati solo quando l'etichetta della località collegata 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 di 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 località di un bucket di osservabilità utilizzando le impostazioni predefinite, le policy dell'organizzazione e l'insieme delle località dei bucket supportate.

Riferimento API

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