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 instrumentata, 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.

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 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 in 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 ulteriori informazioni, vedi 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. 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 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 che instrumentato i servizi Cloud Run utilizzano CPU sempre allocata; Per ulteriori informazioni, vedi Allocazione della CPU (servizi).

In alternativa, se vuoi configurare la raccolta metriche in formato Prometheus, puoi utilizzare Prometeo per Cloud Run per raccogliere metriche strumentate 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 di framework, vedi Framework di logging consigliati.

Cloud Run raccoglie i log scritti in stdout e stderr automaticamente. Per ulteriori informazioni, vedi Scrivi i log dei container.

Cloud Functions

Per informazioni generali su Cloud Functions, consulta Panoramica di Cloud Functions.

Tipo Consiglio
Metriche La scrittura diretta delle metriche non è supportata in Cloud Functions. 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 per l'output Log strutturati JSON in stdout e stderr. Per un elenco di framework, vedi Framework di logging consigliati.

Cloud Functions raccoglie i log scritti in stdout e stderr automaticamente. Per ulteriori informazioni, vedi Visualizza e scrivi i log Cloud Function Functions.

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 la SDK e l'utilità di esportazione di Cloud Trace per lingua.
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, vedi Scrittura e visualizzazione dei 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 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