Visualizza la latenza delle richieste di app

Scopri come raccogliere e visualizzare i dati di latenza dalle tue applicazioni:

  1. Crea un cluster Google Kubernetes Engine (GKE) utilizzando Google Cloud CLI.

  2. Scarica ed esegui il deployment di un'applicazione di esempio nel tuo cluster.

  3. Crea una traccia inviando una richiesta HTTP all'applicazione di esempio.

  4. Visualizza le informazioni sulla latenza della traccia che hai creato.

  5. Eseguire la pulizia.

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud, fai clic su Procedura guidata:

Procedura guidata

Prima di iniziare

  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.

  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

    9.

Crea un cluster GKE

  1. Nella barra degli strumenti, fai clic su Attiva Cloud Shell, quindi esegui i passaggi seguenti 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:

    Finestra dell&#39;esploratore di Trace per la guida rapida.

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

    Il grafico a dispersione viene aggiornato e il punto selezionato viene evidenziato con un cerchio attorno, mentre tutti gli altri punti che rappresentano tutte le altre tracce vengono attenuati.

    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.

    Ulteriori dettagli su ogni intervallo sono visualizzati nel riquadro dei dettagli.

  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 i pacchetti OpenTelemetry ed è eseguita 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 strumenta le richieste web con il contesto della traccia e traccia automaticamente i gestori 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.b 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 introduttiva, 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 ne invia una al servizio b.
  4. Il servizio b riceve la richiesta HTTP e ne invia una al servizio c.
  5. Il servizio c riceve la richiesta HTTP dal servizio b e restituisce la 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.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Se hai creato un nuovo progetto, ma non ne hai più bisogno, eliminalo.

Se hai utilizzato un progetto esistente:

  1. Per eliminare il cluster, in Cloud Shell esegui questo comando:

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

Passaggi successivi