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:
|
Log | Configura la tua app per l'output
di log strutturati JSON in GKE raccoglie automaticamente i log scritti in |
Compute Engine
Per informazioni generali su Compute Engine, consulta Istanze di macchine virtuali.
Tipo | Suggerimento |
---|---|
Metriche e tracce | Segui questi passaggi:
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:
|
Cloud Run
Per informazioni generali su Cloud Run, consulta Che cos'è Cloud Run.
Tipo | Suggerimento |
---|---|
Metriche e tracce | Segui questi passaggi:
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 Cloud Run raccoglie automaticamente i log scritti in |
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 Cloud Functions raccoglie automaticamente i log scritti in |
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 App Engine raccoglie automaticamente i log scritti in |
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:
- Genera tracce e metriche con Go.
- Genera tracce e metriche con Java.
- Genera tracce e metriche con Node.js.
- Genera tracce e metriche con Python.
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
- SDK JavaScript
- Esportatore OTLP JavaScript
- Esportatore Cloud Trace JavaScript
- Esportatore JavaScript Cloud Monitoring
Python
- SDK Python
- Esportatore OTLP per Python
- Esportatore Cloud Trace per Python
- Esportatore Python Cloud Monitoring