Scegli un approccio alla strumentazione

Questa pagina contiene suggerimenti per implementare l'app su diverse piattaforme Google Cloud, come Google Kubernetes Engine (GKE) e Cloud Run. Se la tua app non è ancora instrumentata, utilizza questi suggerimenti per ottenere indicazioni su come instrumentare l'app per l'invio di dati di telemetria a Google Cloud. I consigli in questa pagina non sono le uniche soluzioni e altri approcci possono funzionare. Per ulteriori indicazioni, 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 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 di log strutturati JSON in stdout e stderr. Per un elenco di 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. Usa Ops Agent per raccogliere metriche e tracce. Ad 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 Ops Agent Prometheus 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 estrarre log strutturati JSON in un file. Per un elenco di framework, consulta Framework di logging consigliati.
  2. Installare Ops Agent e configurare un ricevitore. Ad esempio, consulta 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 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 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 collaterale di Prometheus per Cloud Run per raccogliere le metriche instrumentate utilizzando le librerie client di Prometheus o l'SDK OpenTelemetry.
Log

Configura la tua app per l'output di log strutturati JSON in stdout e stderr. Per un elenco di 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'esportatore di Cloud Trace per il tuo linguaggio.
Log

Configura la tua app per l'output di log strutturati JSON in stdout e stderr. Per un elenco di 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'esportatore di Cloud Monitoring per il tuo linguaggio.
Tracce Utilizza l'SDK e l'esportatore di Cloud Trace per il tuo linguaggio.
Log

Configura la tua app per l'output di log strutturati JSON in stdout e stderr. Per un elenco di 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 può essere configurato per generare oggetti JSON serializzati in stdout, stderr o in un file. L'agente Logging, integrato o installato, esegue lo scraping del file e scrive i log strutturati per Cloud Logging. Per scrivere i dati di log, consigliamo quanto segue:

Esempi di codice

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