Scegli un approccio alla strumentazione

Questa pagina contiene suggerimenti per la strumentazione della tua app su diverse piattaforme Google Cloud, come Google Kubernetes Engine (GKE) e Cloud Run. Se la tua app non è già strumentata, utilizza questi suggerimenti come guida su come instrumentare la tua app per inviare dati di telemetria a Google Cloud. I consigli in questa pagina non sono le uniche soluzioni e altri approcci possono funzionare. Per indicazioni aggiuntive, contatta l'assistenza Google Cloud.

Ecco alcuni consigli:

Per informazioni sugli esempi di strumentazione, consulta i documenti elencati nella sezione Esempi di codice.

GKE

Per informazioni generali su GKE, consulta la panoramica di GKE.

Tipo Suggerimento
Metriche

Ti consigliamo di utilizzare Google Cloud Managed Service per Prometheus.

Per la strumentazione, esegui una delle seguenti operazioni:
Tracce

Segui questi passaggi:

  1. Utilizza l'SDK OpenTelemetry e l'esportatore OTLP per la tua lingua.
  2. Configura il raccoglitore OpenTelemetry per inviare tracce OTLP a Google Cloud.
Log

Configura la tua app per l'output dei log strutturati JSON su stdout e stderr. Per un elenco dei framework, consulta Framework di logging consigliati.

GKE raccoglie automaticamente i log scritti in stdout e stderr. Per maggiori informazioni, consulta Informazioni sui log di GKE.

Compute Engine

Per informazioni generali su Compute Engine, consulta Istanze di macchine virtuali.

Tipo Suggerimento
Metriche e tracce

Segui questi passaggi:

  1. Utilizza l'SDK OpenTelemetry e l'esportatore OTLP per la tua lingua.
  2. Utilizza Ops Agent per raccogliere metriche e tracce. Ad esempio, consulta Raccogli metriche e tracce OpenTelemetry Protocol (OTLP).

In alternativa, se vuoi configurare la raccolta solo per le metriche in formato Prometheus, puoi utilizzare il ricevitore Prometheus di Ops Agent per raccogliere le metriche instrumentate utilizzando le librerie client di Prometheus o l'SDK OpenTelemetry.
Log

Segui questi passaggi:

  1. Configura la tua app per l'output di log strutturati JSON su un file. Per un elenco dei framework, consulta Framework di logging consigliati.
  2. Installa Ops Agent e configura un ricevitore. Ad esempio, vedi Ricevitori di Logging.

Cloud Run

Per informazioni generali su Cloud Run, consulta Che cos'è Cloud Run.

Tipo Suggerimento
Metriche e tracce

Segui questi passaggi:

  1. Utilizza l'SDK OpenTelemetry e l'esportatore OTLP per la tua lingua.
  2. Configura il file collaterale OpenTelemetry per raccogliere metriche e tracce. Per un esempio, consulta Scrivere metriche OTLP utilizzando un file collaterale OpenTelemetry.
  3. Imposta la CPU in modo che sia sempre allocata in Cloud Run. Poiché la strumentazione OpenTelemetry esegue l'elaborazione in background, consigliamo che i servizi Cloud Run instrumentati utilizzino una CPU sempre allocata. Per saperne di più, consulta la pagina relativa all'allocazione della CPU (servizi).

In alternativa, se vuoi configurare la raccolta solo per le metriche in formato Prometheus, puoi utilizzare il file collaterale Prometheus per Cloud Run per raccogliere metriche instrumentate utilizzando le librerie client di Prometheus o l'SDK OpenTelemetry.
Log

Configura la tua app per l'output dei log strutturati JSON su stdout e stderr. Per un elenco dei framework, consulta Framework di logging consigliati.

Cloud Run raccoglie automaticamente i log scritti in stdout e stderr. Per maggiori informazioni, consulta Scrivere log dei container.

Cloud Functions

Per informazioni generali su Cloud Functions, consulta la panoramica di Cloud Functions.

Tipo Suggerimento
Metriche La scrittura diretta delle metriche non è supportata in Cloud Functions. Per generare metriche, ti consigliamo di utilizzare metriche basate su log.
Tracce Utilizza l'SDK e l'utilità di esportazione Cloud Trace per la tua lingua.
Log

Configura la tua app per l'output dei log strutturati JSON su stdout e stderr. Per un elenco dei framework, consulta Framework di logging consigliati.

Cloud Functions raccoglie automaticamente i log scritti in stdout e stderr. Per maggiori informazioni, consulta Visualizzare e scrivere i log Cloud Function Functions.

App Engine

Per informazioni generali su App Engine, consulta Panoramica di App Engine.

Tipo Suggerimento
Metriche Utilizza l'SDK e l'utilità di esportazione Cloud Monitoring per il tuo linguaggio.
Tracce Utilizza l'SDK e l'utilità di esportazione Cloud Trace per la tua lingua.
Log

Configura la tua app per l'output dei log strutturati JSON su stdout e stderr. Per un elenco dei framework, consulta Framework di logging consigliati.

App Engine raccoglie automaticamente i log scritti in stdout e stderr. Per maggiori informazioni, consulta Scrittura e visualizzazione dei log.

Framework di logging consigliati

Per raccogliere i log, consigliamo di utilizzare un framework che possa essere configurato per eseguire l'output di oggetti JSON serializzati in stdout, stderr o su un file. L'agente Logging, integrato o installato, esegue lo scraping del file e scrive log strutturati per Cloud Logging. Per scrivere dati di log, consigliamo quanto segue:

Esempi di codice

Per esempi di codice che illustrano come instrumentare l'applicazione per inviare telemetria a Google Cloud, consulta quanto segue:

Riferimenti a OpenTelemetry

Questa sezione fornisce link all'SDK OpenTelemetry e agli esportatori per OTLP, Cloud Trace e Cloud Monitoring.

Riferimenti generali:

Go

Java

JavaScript

Python