Visualizza la latenza delle richieste di app

1. I vincoli di sicurezza definiti dalla tua organizzazione potrebbero impedirti di completare i passaggi seguenti. Per informazioni sulla risoluzione dei problemi, vedi Sviluppare applicazioni in un ambiente Google Cloud vincolato.

2. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

3. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

4. Make sure that billing is enabled for your Google Cloud project.

5. Enable the Google Kubernetes Engine and Cloud Trace APIs.

   Enable the APIs

6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

7. Make sure that billing is enabled for your Google Cloud project.

8. Enable the Google Kubernetes Engine and Cloud Trace APIs.

   Enable the APIs

Crea un cluster GKE

1. Nella barra degli strumenti, fai clic su terminal. Attiva Cloud Shell, quindi esegui questi passaggi in Cloud Shell.

2. Crea un cluster:

   gcloud container clusters create cloud-trace-demo --zone us-central1-c
   

   Il comando precedente, il cui completamento richiede diversi minuti, crea un cluster standardcon il nome cloud-trace-demo nella zona us-central1-c.

3. Configura kubectl per aggiornare automaticamente le credenziali in modo da utilizzare la stessa identità di Google Cloud CLI:

   gcloud container clusters get-credentials cloud-trace-demo --zone us-central1-c
   

4. Verifica l'accesso al cluster:

   kubectl get nodes
   

   Un output di esempio di questo comando è:

   NAME                                              STATUS   ROLES    AGE   VERSION
   gke-cloud-trace-demo-default-pool-063c0416-113s   Ready    <none>   78s   v1.22.12-gke.2300
   gke-cloud-trace-demo-default-pool-063c0416-1n27   Ready    <none>   79s   v1.22.12-gke.2300
   gke-cloud-trace-demo-default-pool-063c0416-frkd   Ready    <none>   78s   v1.22.12-gke.2300
   

Scarica ed esegui il deployment di un'applicazione

Scarica ed esegui il deployment di un'applicazione Python che utilizza il framework Flask e il pacchetto OpenTelemetry. L'applicazione è descritta nella sezione Informazioni sull'app di questa pagina.

In Cloud Shell:

1. Clona un'app Python da GitHub:

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
   

2. Esegui questo comando per eseguire il deployment dell'applicazione di esempio:

   cd python-docs-samples/trace/cloud-trace-demo-app-opentelemetry && ./setup.sh
   

   Il completamento dello script setup.sh richiede alcuni minuti.

   Lo script configura tre servizi utilizzando un'immagine predefinita, quindi attende che venga eseguito il provisioning di tutte le risorse. I carichi di lavoro sono denominati cloud-trace-demo-a, cloud-trace-demo-b e cloud-trace-demo-c.

   Un output di esempio di questo comando è:

   deployment.apps/cloud-trace-demo-a is created
   service/cloud-trace-demo-a is created
   deployment.apps/cloud-trace-demo-b is created
   service/cloud-trace-demo-b is created
   deployment.apps/cloud-trace-demo-c is created
   service/cloud-trace-demo-c is created
   
   Wait for load balancer initialization complete......
   Completed.
   

Crea i dati di traccia

Una traccia descrive il tempo impiegato da un'applicazione per completare una singola operazione.

Per creare una traccia, in Cloud Shell esegui questo comando:

curl $(kubectl get svc -o=jsonpath='{.items[?(@.metadata.name=="cloud-trace-demo-a")].status.loadBalancer.ingress[0].ip}')

La risposta del comando precedente ha il seguente aspetto:

Hello, I am service A
And I am service B
Hello, I am service C

Puoi eseguire il comando curl più volte per generare più tracce.

Visualizza i dati di latenza

1. Nella console Google Cloud, vai alla pagina Esplora tracce.

   Vai a Trace Explorer

   Puoi trovare questa pagina anche utilizzando la barra di ricerca.

   Ogni traccia è rappresentata da un punto sul grafico e da una riga nella tabella.

   Lo screenshot seguente mostra più tracce:

   

2. Per visualizzare una traccia in dettaglio, seleziona un punto nel grafico o una riga nella tabella.

   Il grafico a dispersione è aggiornato e il punto che hai selezionato viene evidenziato con un cerchio attorno al punto e tutti gli altri punti che tutte le altre tracce sono oscurate.

   Un grafico di Gantt mostra informazioni sulla traccia selezionata. La prima riga del grafico di Gantt è per la traccia ed esiste una riga per ogni intervallo nella traccia. Un intervallo indica il tempo necessario per eseguire un'operazione secondaria completa.

   

3. Per visualizzare informazioni dettagliate su un intervallo, selezionalo nel grafico di Gantt.

Informazioni sull'applicazione

L'applicazione di esempio utilizzata in questa guida rapida è disponibile in un repository GitHub. Questo repository contiene informazioni su come utilizzare l'applicazione in ambienti diversi da Cloud Shell. L'applicazione di esempio è scritta in Python, utilizza il framework Flask e OpenTelemetry e viene eseguito su un cluster GKE.

Strumentazione

Il file app.py nel repository GitHub contiene la strumentazione necessaria per acquisire e inviare i dati di traccia al tuo progetto Google Cloud:

• L'applicazione importa diversi pacchetti OpenTelemetry:

  from opentelemetry import trace
  from opentelemetry.exporter.cloud_trace import CloudTraceSpanExporter
  from opentelemetry.instrumentation.flask import FlaskInstrumentor
  from opentelemetry.instrumentation.requests import RequestsInstrumentor
  from opentelemetry.propagate import set_global_textmap
  from opentelemetry.propagators.cloud_trace_propagator import CloudTraceFormatPropagator
  from opentelemetry.sdk.trace import TracerProvider
  from opentelemetry.sdk.trace.export import BatchSpanProcessor
  

• L'applicazione fornisce strumenti per le richieste web con il contesto di traccia e traccia i gestori di Flask e le richieste ad altri servizi:

  app = flask.Flask(__name__)
  FlaskInstrumentor().instrument_app(app)
  RequestsInstrumentor().instrument()

• L'applicazione configura l'esportatore Cloud Trace come provider di traccia, che propaga il contesto della traccia nel formato Cloud Trace:

  def configure_exporter(exporter):
      """Configures OpenTelemetry context propagation to use Cloud Trace context
  
      Args:
          exporter: exporter instance to be configured in the OpenTelemetry tracer provider
      """
      set_global_textmap(CloudTraceFormatPropagator())
      tracer_provider = TracerProvider()
      tracer_provider.add_span_processor(BatchSpanProcessor(exporter))
      trace.set_tracer_provider(tracer_provider)
  
  
  configure_exporter(CloudTraceSpanExporter())
  tracer = trace.get_tracer(__name__)

• Il seguente snippet di codice mostra come inviare richieste in Python. OpenTelemetry propaga implicitamente il contesto della traccia per le tue richieste in uscita:

  if endpoint is not None and endpoint != "":
      data = {"body": keyword}
      response = requests.get(
          endpoint,
          params=data,
      )
      return keyword + "\n" + response.text
  else:
      return keyword, 200
  
  

Come funziona l'applicazione

Per chiarezza, in questa sezione cloud-trace-demo viene omesso dai nomi dei servizi. Ad esempio, al servizio cloud-trace-demo-c viene fatto riferimento come c.

Questa applicazione crea tre servizi denominati a, b e c. Il servizio a è configurato per chiamare il servizio b, che è configurato per chiamare il servizio c. Per informazioni dettagliate sulla configurazione dei servizi, consulta i file YAML nel repository GitHub.

Quando hai inviato una richiesta HTTP al servizio a in questa guida rapida, hai utilizzato il seguente comando curl:

curl $(kubectl get svc -o=jsonpath='{.items[?(@.metadata.name=="cloud-trace-demo-a")].status.loadBalancer.ingress[0].ip}')

Il comando curl funziona nel seguente modo:

1. kubectl recupera l'indirizzo IP del servizio denominato cloud-trace-demo-a.
2. Il comando curl invia quindi la richiesta HTTP al servizio a.
3. Il servizio a riceve la richiesta HTTP e invia una richiesta al servizio b.
4. Il servizio b riceve la richiesta HTTP e invia una richiesta al servizio c.
5. Il servizio c riceve la richiesta HTTP dal servizio b e restituisce il dalla stringa Hello, I am service C al servizio b.
6. Il servizio b riceve la risposta dal servizio c, la aggiunge alla stringa And I am service B e restituisce il risultato al servizio a.
7. Il servizio a riceve la risposta dal servizio b e la aggiunge alla stringa Hello, I am service A.
8. La risposta del servizio a viene stampata in Cloud Shell.