Cloud Trace et Cloud Service Mesh

Cloud Trace est un système de traçage distribué qui recueille les données de latence des applications et les affiche en quasi-temps réel. Il vous permet de suivre un échantillon de requêtes à travers votre système distribué, d'observer les appels réseau et de profiler votre système de bout en bout.

Cloud Trace est disponible avec les installations Cloud Service Mesh sur les plates-formes suivantes:

• GKE sur Google Cloud
• Clusters GKE Enterprise sur site si vous effectuez l'installation avec l'autorité de certification Cloud Service Mesh

Notez que Cloud Trace est désactivé par défaut. Une fois activées, les pages Cloud Service Mesh de la console Google Cloud fournissent un lien vers les traces de la page Cloud Trace . Pour en savoir plus sur la tarification, consultez la page des tarifs de Cloud Trace.

Activer Cloud Trace

Cette section vous explique comment activer Cloud Trace.

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

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

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

 ./asmcli install \
    OTHER_FLAGS \
    --custom_overlay PATH_TO_FILE

kubectl rollout restart deployment -n NAMESPACE DEPLOYMENT_NAME

Propagation du contexte de trace

Même si les proxys side-car peuvent envoyer automatiquement des délais de trace, ils ont besoin d'indications pour relier l'intégralité de la trace. Les applications doivent propager les en-têtes HTTP appropriés de sorte que, lorsque les proxys envoient des informations de délais, ceux-ci soient correctement corrélés en une seule trace.

Pour ce faire, une application doit collecter et propager les en-têtes appropriés de la requête entrante vers les requêtes sortantes : La configuration de traçage Stackdriver de Cloud Service Mesh accepte l'un des formats d'en-tête suivants et propage tous les formats suivants:

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

Cela signifie que vos applications peuvent utiliser n'importe lequel de ces formats pour propager le contexte de traçage, et les traces sont générées et définies de manière appropriée sur Stackdriver.

Exemple

Voici un exemple de requête HTTP-Get avec un en-tête traceparent dans la requête d'origine. Notez les en-têtes de contexte de trace supplémentaires ajoutés par le 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="
}

Notez que l'ensemble complet d'en-têtes de contexte de trace est présent dans l'ensemble d'en-têtes de requête renvoyé.

Pour obtenir davantage d'exemples de propagation des en-têtes, consultez la page Propagation du contexte de trace.

Créer une trace à partir d'un client avec un ID personnalisé

Pour créer une trace à partir d'un client avec un ID personnalisé, utilisez la commande curl pour créer une requête avec un client externe et l'obliger à afficher une trace. Exemple :

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

Pour plus d'informations sur x-client-trace-id, reportez-vous à la documentation d'Envoy.

Accéder aux traces

Afficher des exemples de traces pour un service

Pour afficher un échantillon de traces d'un service dans votre application, procédez comme suit:

1. Accédez à la page Cloud Service Mesh de la console Google Cloud.

   Accéder à la page Cloud Service Mesh

2. Sous Services, sélectionnez le nom du service que vous souhaitez inspecter.

   La capture d'écran suivante montre un exemple de service frontend.

   

3. Sous Traces de requête, cliquez sur une trace pour en savoir plus.

   La capture d'écran suivante montre un exemple du sous-panneau de la requête de suivi.

   

Afficher toutes les traces

Pour afficher toutes les traces d'un service, procédez comme suit:

1. Accédez à la page Cloud Service Mesh de la console Google Cloud.

   Accéder à la page Cloud Service Mesh

2. Sous Services, sélectionnez le nom du service que vous souhaitez inspecter.

3. Accédez à la page Métriques.

4. Spécifiez une période dans le menu déroulant Période ou définissez une période personnalisée avec la chronologie.

5. Cliquez sur Afficher les traces.

Les traces d'un service dans Cloud Service Mesh contiennent les informations suivantes:

• Latences des requêtes dans différents services du maillage.
• Propriétés des requêtes HTTP, y compris l'ID, l'URL, la taille, la latence et le protocole.
• Nom du service, espace de noms et ID de maillage associés aux libellés istio.canonical_service, istio.namespace et istio.mesh_id, respectivement.

Étape suivante

• Afficher les traces dans la console Google Cloud