Scegli un approccio alla strumentazione

Questa pagina contiene consigli per l'instrumentazione dell'app su diverse piattaforme Google Cloud, come Google Kubernetes Engine (GKE) e Cloud Run. Se la tua app non è ancora sottoposta a ispezione, consulta questi consigli per sapere come sottoporla a ispezione in modo da inviare i dati di telemetria a Google Cloud. I consigli riportati in questa pagina non sono le uniche soluzioni e possono essere utili anche altri approcci. Per ulteriori indicazioni, contatta l'assistenza di Google Cloud.

Ecco alcuni consigli:

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

GKE

Per informazioni generali su GKE, consulta Panoramica di GKE.

Tipo Consiglio
Metriche

Ti consigliamo di utilizzare Google Cloud Managed Service per Prometheus.

Per la misurazione, 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 collector OpenTelemetry per inviare le tracce OTLP a Google Cloud.
Log

Configura l'app per l'output Log strutturati JSON in stdout e stderr. Per un elenco di framework, vedi 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 Consiglio
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 Raccogliere Metriche e tracce OpenTelemetry Protocol (OTLP).

In alternativa, se vuoi configurare la raccolta metriche in formato Prometheus, puoi utilizzare Ricevitore Ops Agent Prometheus per raccogliere metriche strumentate utilizzando Librerie client di Prometheus o l'SDK OpenTelemetry.
Log

Segui questi passaggi:

  1. Configura l'app in modo che esamini i log strutturati in JSON in un file. Per un elenco dei framework, consulta Framework di logging consigliati.
  2. Installa l'agente operativo e configura un ricevitore. Per un esempio, consulta Recipienti di log.

Cloud Run

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

Tipo Consiglio
Metriche e tracce

Segui questi passaggi:

  1. Utilizza la SDK OpenTelemetry ed esportatore OTLP per la tua lingua.
  2. Configura il sidecar OpenTelemetry per raccogliere metriche e tracce. Per un vedi gli esempi Scrittura Metriche OTLP utilizzando un file collaterale OpenTelemetry.
  3. Imposta la CPU in modo che venga sempre allocata in Cloud Run. Poiché la strumentazione OpenTelemetry esegue l'elaborazione in background, consigliamo di utilizzare una CPU sempre allocata per i servizi Cloud Run strumentati. Per ulteriori informazioni, consulta Allocazione della CPU (servizi).

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

Configura l'app per l'output Log strutturati JSON in 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 ulteriori informazioni, consulta Scrivere log dei container.

Funzioni Cloud Run

Per informazioni generali sulle funzioni di Cloud Run, consulta Panoramica delle funzioni di Cloud Run.

Tipo Consiglio
Metriche La scrittura diretta delle metriche non è supportata nelle funzioni di Cloud Run. A generare metriche, ti consigliamo di usare metriche basate su log.
Tracce Utilizza l'SDK e l'esportatore Cloud Trace per il tuo linguaggio.
Log

Configura l'app in modo da generare log in formato JSON in stdout e stderr. Per un elenco dei framework, consulta Framework di logging consigliati.

Le funzioni Cloud Run raccolgono automaticamente i log scritti in stdout e stderr. Per ulteriori informazioni, vedi Visualizza e scrivi i log delle funzioni di Cloud Run.

App Engine

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

Tipo Consiglio
Metriche Utilizza l'SDK e l'esportatore di Cloud Monitoring per la tua lingua.
Tracce Utilizza l'SDK e l'esportatore Cloud Trace per il tuo linguaggio.
Log

Configura l'app in modo da generare log in formato JSON in stdout e stderr. Per un elenco di framework, vedi Framework di logging consigliati.

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

Framework di logging consigliati

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

Esempi di codice

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

Riferimenti a OpenTelemetry

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

Riferimenti generali:

Vai

Java

JavaScript

Python