Använda distribuerad spårning med Azure Spring Cloud (inaktuell)

I den här artikeln får du lära dig hur du aktiverar en .NET Core Steeltoe-app för att använda distribuerad spårning.

Förutsättningar

För att följa dessa procedurer behöver du en Steeltoe-app som redan är förberedd för distribution till Azure Spring Cloud.

Beroenden

För Steeltoe 2.4.4 lägger du till följande NuGet-paket:

• Steeltoe.Management.TracingCore
• Steeltoe.Management.ExporterCore

För Steeltoe 3.0.0 lägger du till följande NuGet-paket:

• Steeltoe.Management.TracingCore

Uppdatera Startup.cs

1. För Steeltoe 2.4.4 AddDistributedTracing anropar du AddZipkinExporter och i metoden ConfigureServices .

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddDistributedTracing(Configuration);
       services.AddZipkinExporter(Configuration);
   }
   

   För Steeltoe 3.0.0 AddDistributedTracing anropar du i ConfigureServices metoden .

   public void ConfigureServices(IServiceCollection services)
   {
       services.AddDistributedTracing(Configuration, builder => builder.UseZipkinWithTraceOptions(services));
   }
   

2. För Steeltoe 2.4.4 UseTracingExporter anropar du i Configure metoden .

   public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
   {
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });
        app.UseTracingExporter();
   }
   

   För Steeltoe 3.0.0 krävs inga ändringar i Configure metoden .

Uppdatera konfiguration

Lägg till följande inställningar i konfigurationskällan som ska användas när appen körs i Azure Spring Cloud:

1. Ange management.tracing.alwaysSample till Sant.

2. Om du vill se spårningsintervall som skickas mellan Eureka-servern, konfigurationsservern och användarappar: ställ in på management.tracing.egressIgnorePattern "/api/v2/spans|/v2/apps/./permissions|/eureka/.| /oauth/.*".

Appsettings.json skulle till exempel innehålla följande egenskaper:

"management": {
    "tracing": {
      "alwaysSample": true,
      "egressIgnorePattern": "/api/v2/spans|/v2/apps/.*/permissions|/eureka/.*|/oauth/.*"
    }
  }

Mer information om distribuerad spårning i .NET Core Steeltoe-appar finns i Distribuerad spårning i Dokumentationen om Steeltoe.

I den här artikeln kan du se hur du:

Förutsättningar

Om du vill följa de här procedurerna behöver Azure Spring Cloud tjänst som redan har etablerats och körs. Slutför snabbstarten Deploy your first Spring Boot app in Azure Spring Cloud to provision and run an Azure Spring Cloud service (Distribuera din Spring Boot i en Azure Spring Cloud för att etablera och köra en Azure Spring Cloud tjänst.

Lägga till beroenden

1. Lägg till följande rad i filen application.properties:

   spring.zipkin.sender.type = web
   

   Efter den här ändringen kan Zipkin-avsändaren skicka till webben.

2. Hoppa över det här steget om du har följt vår guide för att förbereda ett program i Azure Spring Cloud. Annars går du till din lokala utvecklingsmiljö och redigerar filen pom.xml så att den innehåller följande Spring Cloud Sjonth-beroende:

   • Spring boot version < 2.4.x.

     <dependencyManagement>
         <dependencies>
             <dependency>
                 <groupId>org.springframework.cloud</groupId>
                 <artifactId>spring-cloud-sleuth</artifactId>
                 <version>${spring-cloud-sleuth.version}</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
         </dependencies>
     </dependencyManagement>
     <dependencies>
         <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-starter-sleuth</artifactId>
         </dependency>
         <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-starter-zipkin</artifactId>
         </dependency>
     </dependencies>
     

   • Spring boot version >= 2.4.x.

     <dependencyManagement>
         <dependencies>
           <dependency>
                 <groupId>org.springframework.cloud</groupId>
                 <artifactId>spring-cloud-sleuth</artifactId>
                 <version>${spring-cloud-sleuth.version}</version>
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
         </dependencies>
     </dependencyManagement>
     <dependencies>
         <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-starter-sleuth</artifactId>
         </dependency>
         <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-sleuth-zipkin</artifactId>
          </dependency>
     </dependencies>
     

3. Skapa och distribuera igen för din Azure Spring Cloud för att återspegla dessa ändringar.

Ändra samplingsfrekvensen

Du kan ändra den frekvens med vilken telemetrin samlas in genom att ändra samplingsfrekvensen. Om du till exempel vill prova hälften så ofta öppnar du filen application.properties och ändrar följande rad:

spring.sleuth.sampler.probability=0.5

Om du redan har skapat och distribuerat ett program kan du ändra exempelfrekvensen. Det gör du genom att lägga till föregående rad som en miljövariabel i Azure CLI eller Azure Portal.