Scegli un approccio alla strumentazione

Questa pagina contiene consigli per implementare la tua app su diversi piattaforme Google Cloud, come Google Kubernetes Engine (GKE) e in Cloud Run. Se la tua app non è ancora dotata di strumenti, poi segui questi consigli come strumentazione per inviare dati di telemetria a Google Cloud. I consigli in questa pagina non sono le uniche soluzioni e altre diversi possono funzionare. Per ulteriori indicazioni, contatta l'assistenza di Google Cloud.

Esistono consigli per quanto riguarda:

Per informazioni sugli esempi di strumentazione, 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 strumentazione, esegui una delle seguenti operazioni:
Tracce

Segui questi passaggi:

  1. Utilizza la SDK OpenTelemetry ed esportatore OTLP per la tua lingua.
  2. Configura il raccoglitore OpenTelemetry per inviare 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 i log scritti stdout e stderr automaticamente. 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 la SDK OpenTelemetry ed 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 la tua app per estrarre log strutturati JSON in un file. Per un elenco di framework, vedi Framework di logging consigliati.
  2. Installare Ops Agent e configurare un ricevitore. Ad esempio, vedi Ricevitori di Logging.

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 file collaterale 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 strumentate utilizzando Librerie client di Prometheus o l'SDK OpenTelemetry.
Log

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

Cloud Run raccoglie i log scritti in stdout e stderr automaticamente. 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 la SDK e l'utilità di esportazione di Cloud Trace per lingua.
Log

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

Cloud Run Functions raccoglie i log scritti in stdout e stderr automaticamente. 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 la SDK e l'esportatore di Cloud Monitoring per lingua.
Tracce Utilizza l'SDK e l'esportatore Cloud Trace per il tuo linguaggio.
Log

Configura l'app per l'output Log strutturati 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, consulta Scrivere e visualizzare i log.

Framework di logging consigliati

Per raccogliere i log, consigliamo di utilizzare un framework che può essere configurato per produrre oggetti JSON serializzati su stdout, stderr o su un . 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, 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