Puoi instrumentare le tue applicazioni per Cloud Trace per acquisire dati di tracciamento distribuito, esaminare la latenza per le singole richieste e visualizzare la latenza aggregata tra i servizi nella console Trace.
Questo documento fornisce una panoramica degli approcci di instrumentazione e delle opzioni di configurazione. Per istruzioni passo passo per linguaggi di programmazione specifici, consulta le pagine di configurazione specifiche per il linguaggio.
Quando instrumentare l'applicazione
Se i dati di traccia per la convalida delle prestazioni o la risoluzione dei problemi non vengono acquisiti automaticamente, instrumenta l'applicazione.
Instrumenta l'applicazione per raccogliere informazioni specifiche che ti aiutino a comprenderne le prestazioni e a risolvere i problemi. Diversi framework di instrumentazione open source raccolgono dati di log, metriche e tracce e possono inviarli a qualsiasi fornitore, tra cui Google Cloud. Per le tue applicazioni agentiche, alcuni framework possono raccogliere i prompt e le risposte o passare il contesto che consente di tracciare alcune chiamate ai server MCP di Google Cloud remoti.
Per instrumentare l'applicazione, ti consigliamo di utilizzare un framework di instrumentazione open source e indipendente dal fornitore, come OpenTelemetry, anziché API o librerie client specifiche del fornitore e del prodotto. Per informazioni su questi framework, consulta Instrumentazione e osservabilità e Scegliere un approccio di instrumentazione.
Come instrumentare le applicazioni
Esistono diversi approcci che puoi utilizzare per instrumentare l'applicazione:
Consigliato: utilizza OpenTelemetry, configura la tua applicazione con un esportatore OTLP che invia i dati di traccia a un agente di raccolta e configura l'agente di raccolta per inviare i dati di traccia al tuo Google Cloud progetto utilizzando l'API Telemetry (OTLP). Per saperne di più sui nostri consigli, consulta Scegliere un approccio di instrumentazione.
Utilizza OpenTelemetry e configura l'applicazione con un esportatore OTLP che invia i dati di traccia al tuo Google Cloud progetto utilizzando l' API Telemetry.
Se scrivi applicazioni in esecuzione su Compute Engine, puoi utilizzare Ops Agent e il ricevitore OpenTelemetry Protocol (OTLP) per raccogliere tracce e metriche dalla tua applicazione. Ops Agent può anche raccogliere i log, ma non utilizzando OTLP. Per saperne di più, consulta Utilizzare Ops Agent e OTLP e Panoramica di Ops Agent.
Richiama direttamente l'API Telemetry o l'API Cloud Trace.
Per le applicazioni Spring Boot, configurale in modo che inoltrino i dati di traccia raccolti a Cloud Trace. Per informazioni su questa procedura, consulta Spring Cloud per Google Cloud: Cloud Trace.
Utilizza le librerie client di Cloud Trace o l'esportatore di Cloud Trace per OpenTelemetry.
Esempi di instrumentazione
Gli esempi di instrumentazione che forniamo utilizzano OpenTelemetry:
Per gli esempi che utilizzano un'esportazione basata su raccoglitore, consulta:
Questi esempi inviano i dati di metriche e tracce in formato OpenTelemetry Protocol (OTLP) al tuo progetto utilizzando l' API Telemetry. Gli esempi utilizzano un Google Cloud esportatore per i dati di log.
Per informazioni su come utilizzare un'esportazione diretta dei dati di traccia e inviare tali dati all'API Telemetry, vedere Eseguire la migrazione dall'esportatore di Trace all'endpoint OTLP.
Per esempi che mostrano come configurare un'applicazione agentica per raccogliere prompt e risposte, consulta Come instrumentare le applicazioni di AI generativa.