Cloud Trace e Cloud Service Mesh

Nota: questa guida supporta solo Cloud Service Mesh con le API Istio non supportano le API Google Cloud. Per ulteriori informazioni, consulta la panoramica di Cloud Service Mesh.

Cloud Trace è un sistema di tracciamento distribuito che raccoglie i dati di latenza dalle applicazioni e li visualizza quasi in tempo reale. Consente seguire una richiesta di esempio attraverso il sistema distribuito, osserva le chiamate di rete e la profilazione end-to-end del tuo sistema.

Cloud Trace è disponibile per le installazioni di Cloud Service Mesh nel seguenti piattaforme:

• GKE su Google Cloud
• di cluster GKE Enterprise on-premise Autorità di certificazione Cloud Service Mesh

Tieni presente che Cloud Trace è disabilitato per impostazione predefinita. Una volta attivata la funzionalità, Le pagine Cloud Service Mesh nella console Google Cloud forniscono un link nella pagina Cloud Trace . Per informazioni dettagliate sui prezzi, consulta la pagina dei prezzi di Cloud Trace.

Attivare Cloud Trace

Questa sezione mostra come abilitare Cloud Trace.

Gestito (TD)

Nota: Cloud Service Mesh solo con un piano di controllo Cloud Service Mesh gestito supporta la configurazione dell'API di telemetria a livello di cluster con un singolo Istio risorsa personalizzata (CR) dell'API di telemetria nello spazio dei nomi principale. Non eseguire il deployment più RP dell'API di telemetria Istio in un cluster. Se esegui il deployment di più Istio RP delle API di telemetria in un cluster, viene applicata solo la prima. Se hai già una RP dell'API di telemetria Istio, includila nel nuovo RP sull'API Istio Telemetry per conservare le impostazioni di personalizzazione precedenti in la tua RP di telemetria Istio esistente.

Questa sezione mostra come abilitare Cloud Trace su Cloud Service Mesh con un piano di controllo Cloud Service Mesh gestito.

1. Esegui questo comando per abilitare Cloud Trace:

   cat <<EOF | kubectl apply -n istio-system -f -
   apiVersion: telemetry.istio.io/v1alpha1
   kind: Telemetry
   metadata:
      name: enable-cloud-trace
      namespace: istio-system
   spec:
      tracing:
      - providers:
        - name: stackdriver
   EOF
   

Gestito (Istiod)

Questa sezione mostra come abilitare Cloud Trace su Cloud Service Mesh con il piano di controllo Istiod gestito.

Avviso: puoi sovrascrivere le tue modifiche. Se hai già una mappa di configurazione esistente, devi includere tutte le impostazioni di personalizzazione precedenti nella sezione mesh: per conservare le modifiche.

1. Esegui questo comando:

   cat <<EOF | kubectl apply -f -
   apiVersion: v1
   data:
      mesh: |-
         defaultConfig:
           tracing:
             stackdriver: {}
   kind: ConfigMap
   metadata:
      name: istio-release-channel
      namespace: istio-system
   EOF
   

   dove release-channel è il tuo canale di rilascio (asm-managed, asm-managed-stable o asm-managed-rapid).

2. Esegui il seguente comando per visualizzare il configmap:

   kubectl get configmap istio-release-channel -n istio-system -o yaml
   

3. Per verificare che Cloud Trace sia abilitato, assicurati che il parametro le seguenti righe vengono visualizzate nella sezione mesh:.

   ...
   apiVersion: v1
   data:
      mesh: |
      ....
      defaultConfig:
         tracing:
            stackdriver:{}
   ...
   

4. Riavvia i proxy.

   Tieni presente che la configurazione del tracker fa parte della configurazione di bootstrap del proxy, pertanto ogni pod deve essere riavviato e reiniettato per rilevare l'aggiornamento del tracker. Ad esempio, puoi utilizzare il seguente comando per riavviare i pod che appartengono a un deployment:

   kubectl rollout restart deployment -n NAMESPACE DEPLOYMENT_NAME

Nel cluster

Questa sezione mostra come abilitare Cloud Trace su Cloud Service Mesh con un piano di controllo nel cluster.

Per abilitare Cloud Trace, esegui nuovamente il deployment del control plane gestito dal cliente utilizzando il seguente file overlay. Per ulteriori informazioni sui file di overlay, vedi Informazioni sui file di overlay.

Attenzione: l'utilizzo di asmcli install sovrascrive la configurazione esistente del piano di controllo. Quando attivi l'opzione facoltativa funzioni a un'installazione esistente, assicurati di specificare tutti i file che mantenere la configurazione originale, oltre ai file di overlay le funzionalità che vuoi attivare. Ti consigliamo di archiviare i file di overlay utilizzati per l'installazione nel controllo del codice sorgente in modo da poter applicare le stesse configurazioni al piano di controllo con gli upgrade o quando attivi funzionalità facoltative aggiuntive.

Predefinito

Esegui questo comando per abilitare Cloud Trace:

 ./asmcli install \
    OTHER_FLAGS \
    --option cloud-trace

Questo comando applica il seguente file di overlay per abilitare il tracciamento con opzioni predefinite. Tieni presente che la frequenza di campionamento predefinita è dell'1%. Se vuoi override il valore predefinito, devi utilizzare --custom-overlay.

 apiVersion: install.istio.io/v1alpha1
 kind: IstioOperator
 spec:
   meshConfig:
     enableTracing: true
   values:
     global:
       proxy:
         tracer: stackdriver

Per un elenco di opzioni, consulta il pacchetto anthos-service-mesh.

Personalizzato

Puoi eseguire l'override del valore predefinito specificando un valore tracing.sampling. La deve essere compreso tra 0,0 e 100,0 con una precisione di 0,01. Per Ad esempio, per tracciare 5 richieste ogni 10.000,usa 0, 05.

L'esempio seguente mostra una frequenza di campionamento del 100% (che vorreste solo a scopo dimostrativo o di risoluzione dei problemi).

 apiVersion: install.istio.io/v1alpha1
 kind: IstioOperator
 spec:
   meshConfig:
     enableTracing: true
     defaultConfig:
        tracing:
        sampling: 100
   values:
     global:
       proxy:
         tracer: stackdriver

Esegui il comando seguente per abilitare Cloud Trace:

 ./asmcli install \
    OTHER_FLAGS \
    --custom_overlay PATH_TO_FILE

Tieni presente che la configurazione dell'utilità di traccia fa parte della configurazione del bootstrap del proxy, quindi i pod devono riavviarsi e essere reinjects per recuperare l'aggiornamento del tracciamento. Utilizza le funzionalità di il comando seguente per riavviare i pod che appartengono a un deployment:

kubectl rollout restart deployment -n NAMESPACE DEPLOYMENT_NAME

Propagazione del contesto della traccia

Sebbene i proxy collaterali possano inviare automaticamente intervalli di traccia, devono Suggerimenti per collegare l'intera traccia. Le applicazioni devono propagare le intestazioni HTTP appropriate in modo che, quando i proxy inviano informazioni sugli span, gli span possano essere correlati correttamente in una singola traccia.

Per farlo, un'applicazione deve raccogliere e propagare intestazioni dalla richiesta in entrata a qualsiasi richiesta in uscita. La La configurazione di tracciamento di Stackdriver per Cloud Service Mesh accetterà uno qualsiasi dei i seguenti formati di intestazione e propagherà tutti i seguenti formati:

• B3 (x-b3-traceid, x-b3-spanid, x-b3parentspanid, x-b3-sampled, x-b3-flags)
• TraceContext W3C (traceparent)
• Google Cloud Trace (x-cloud-trace-context)
• TraceBin gRPC (grpc-trace-bin)

Ciò significa che le applicazioni possono utilizzare uno qualsiasi di questi formati per propagare il contesto di tracciamento e le tracce verranno generate e impostate su Stackdriver in modo appropriato.

Esempio

Ecco un esempio di richiesta HTTP-Get con un'intestazione traceparent nella richiesta originale. Tieni presente le intestazioni aggiuntive del contesto traccia aggiunte dal proxy.

$ kubectl exec -it sleep-557747455f-n6flv -- curl "httpbin:8000/anything?freeform=" -H "accept: application/json" -H "Traceparent: 00-7543d15e09e5d61801d4f74cde1269b8-604ef051d35c5b3f-01" -vv
*   Trying 10.12.3.52:8000...
* Connected to httpbin (10.12.3.52) port 8000 (#0)
> GET /anything?freeform= HTTP/1.1
> Host: httpbin:8000
> User-Agent: curl/7.80.0-DEV
> accept: application/json
> Traceparent: 00-7543d15e09e5d61801d4f74cde1269b8-604ef051d35c5b3f-01
>
* Mark bundle as not supporting multiuse
< HTTP/1.1 200 OK
< server: envoy
< date: Wed, 10 Nov 2021 20:36:04 GMT
< content-type: application/json
< content-length: 1032
< access-control-allow-origin: *
< access-control-allow-credentials: true
< x-envoy-upstream-service-time: 5
<
{
  "args": {
    "freeform": ""
  },
  "data": "",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "application/json",
    "Grpc-Trace-Bin": "AAB1Q9FeCeXWGAHU90zeEmm4AaDHmGRtdM7wAgE",
    "Host": "httpbin:8000",
    "Traceparent": "00-7543d15e09e5d61801d4f74cde1269b8-a0c798646d74cef0-01",
    "User-Agent": "curl/7.80.0-DEV",
    "X-B3-Sampled": "1",
    "X-B3-Spanid": "a0c798646d74cef0",
    "X-B3-Traceid": "7543d15e09e5d61801d4f74cde1269b8",
    "X-Cloud-Trace-Context": "7543d15e09e5d61801d4f74cde1269b8/11585396123534413552;o=1",
    "X-Envoy-Attempt-Count": "1",
    "X-Forwarded-Client-Cert": "<REDACTED>"
  },
  "json": null,
  "method": "GET",
  "origin": "127.0.0.6",
  "url": "http://httpbin:8000/anything?freeform="
}

Tieni presente che nel set di intestazioni delle richieste restituito è presente l'intero set di intestazioni del contesto della traccia.

Per altri esempi di propagazione delle intestazioni, consulta Propagazione del contesto di tracciamento.

Crea una traccia dal client con ID personalizzato

Per creare una traccia da un client con un ID personalizzato, utilizza il comando curl per creare una richiesta con un client esterno e forzarne la visualizzazione di una traccia. Ad esempio:

curl $URL --header "x-client-trace-id: 105445aa7843bc8bf206b12000100000"

Per ulteriori informazioni su x-client-trace-id, consulta le Documentazione di Envoy.

Nota: se stai testando i container collaterali di Cloud Service Mesh che inviano i dati di Cloud Trace utilizzando microservices-demo, assicurati di disabilitare la funzionalità integrata di Cloud Trace. La demo microservices è in grado di inviare dati di Cloud Trace senza Istio. Se non disattivi questa funzionalità, le tracce verranno duplicate perché sia il contenitore dell'applicazione sia il contenitore sidecar invieranno tracce. Esistono diversi DISABLE_TRACING variabili da configurare nel file di release microservizi-demo.

Accedere alle tracce

Visualizza esempi di traccia per un servizio

Per visualizzare un campione di tracce per un servizio nella tua app:

1. Vai alla pagina Cloud Service Mesh nella console Google Cloud.

   Vai alla pagina Cloud Service Mesh

2. In Servizi, seleziona il nome del servizio che vuoi ispezionare.

   Lo screenshot seguente mostra un esempio di servizio frontend.

   

3. In Richiedi tracce, fai clic su una traccia per visualizzare ulteriori informazioni.

   Lo screenshot seguente mostra un esempio del riquadro secondario della richiesta di traccia.

   

Visualizza tutte le tracce

Per visualizzare tutte le tracce di un servizio:

1. Vai alla pagina Cloud Service Mesh nella console Google Cloud.

   Vai alla pagina Cloud Service Mesh

2. In Servizi, seleziona il nome del servizio che vuoi ispezionare.

3. Vai alla pagina Metriche.

4. Specifica un intervallo di tempo dal menu a discesa Intervallo di tempo o imposta un intervallo personalizzato con la cronologia.

5. Fai clic su Visualizza tracce.

Le tracce per un servizio in Cloud Service Mesh contengono le seguenti informazioni:

• Latenze di richiesta nei diversi servizi della mesh.
• Proprietà della richiesta HTTP, tra cui ID, URL, dimensioni, latenza e protocollo.
• Nome del servizio, spazio dei nomi e ID mesh come parte delle etichette istio.canonical_service, istio.namespace e istio.mesh_id, rispettivamente.

Passaggi successivi

• Visualizzare le tracce nella console Google Cloud