Scegli un approccio di misurazione

Questa pagina contiene consigli per l'ispezione della tua 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 Google Cloud.

Esistono consigli per quanto riguarda:

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 in modo da generare log in formato JSON in stdout e stderr. Per un elenco dei framework, consulta Framework di logging consigliati.

GKE raccoglie automaticamente i log scritti in stdout e stderr. Per saperne di più, 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. Per un esempio, consulta Raccogliere 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 sottoposte a ispezione utilizzando le biblioteche client 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'Ops Agent e configura un ricevitore. Per un esempio, consulta Recepitori 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 l'SDK OpenTelemetry e l'esportatore OTLP per la tua lingua.
  2. Configura il sidecar OpenTelemetry per raccogliere metriche e tracce. Per un esempio, consulta Scrivere metriche OTLP utilizzando un sidecar OpenTelemetry.
  3. Imposta la CPU in modo che sia sempre allocata in Cloud Run. Poiché la instrumentation OpenTelemetry esegue l'elaborazione in background, consigliamo di utilizzare una CPU sempre allocata per i servizi Cloud Run instrumentati. Per ulteriori informazioni, consulta Allocazione della CPU (servizi).

In alternativa, se vuoi configurare la raccolta solo per le metriche in formato Prometheus, puoi utilizzare il sidecar Prometheus per Cloud Run per raccogliere le metriche sottoposte a ispezione utilizzando le biblioteche client Prometheus o l'SDK OpenTelemetry.
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.

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 Cloud Run, consulta la panoramica delle funzioni Cloud Run.

Tipo Consiglio
Metriche La scrittura diretta delle metriche non è supportata nelle funzioni Cloud Run. Per generare metriche, ti consigliamo di utilizzare 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, consulta Visualizzare e scrivere i log delle funzioni 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 dei framework, consulta Framework di logging consigliati.

App Engine raccoglie automaticamente i log scritti in stdout e stderr. Per ulteriori informazioni, consulta Scrivere e visualizzare i 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 di logging, integrato o installato, esegue lo scraping del file e scrive log strutturati per Cloud Logging. Per scrivere i dati di log, ti consigliamo quanto segue:

Esempi di codice

Per esempi di codice che illustrano come instrumentare l'applicazione per inviare la 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