Použití distribuovaného trasování s Azure Spring Cloud (zastaralé)

V tomto článku se dozvíte, jak aplikaci .NET Core Steeltoe povolit používání distribuovaného trasování.

Požadavky

Pokud chcete postupovat podle těchto postupů, potřebujete aplikaci Steeltoe, která je už připravená k nasazení Azure Spring Cloud.

Závislosti

Pro Steeltoe 2.4.4 přidejte následující NuGet balíčky:

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

Pro Steeltoe 3.0.0 přidejte následující NuGet balíčku:

• Steeltoe.Management.TracingCore

Aktualizace souboru Startup.cs

1. Pro Steeltoe 2.4.4 zavolejte a AddDistributedTracing AddZipkinExporter v ConfigureServices metodě .

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

   Pro Steeltoe 3.0.0 AddDistributedTracing volejte ConfigureServices metodu .

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

2. Pro Steeltoe 2.4.4 UseTracingExporter volejte Configure metodu .

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

   Pro Steeltoe 3.0.0 nejsou v metodě vyžadovány žádné Configure změny.

Aktualizace konfigurace

Do zdroje konfigurace přidejte následující nastavení, která se budou používat při spuštění aplikace v Azure Spring Cloud:

1. Nastavte management.tracing.alwaysSample na true.

2. Pokud chcete zobrazit rozsahy trasování odesílané mezi serverem Eureka, konfiguračním serverem a uživatelskými aplikacemi, nastavte na management.tracing.egressIgnorePattern /api/v2/spans|/v2/apps/./permissions|/eureka/. | /oauth/.*".

Například soubor appsettings.json by zahrnoval následující vlastnosti:

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

Další informace o distribuovaném trasování v aplikacích .NET Core Steeltoe najdete v tématu Distribuované trasování v dokumentaci Steeltoe.

V tomto článku získáte informace o těchto tématech:

Požadavky

Pokud chcete postupovat podle těchto postupů, potřebujete Azure Spring Cloud, která je již zřízená a spuštěná. Pokud chcete zřídit a spustit Spring Boot službu, Azure Spring Cloud aplikaci pro nasazení první Azure Spring Cloud nasazení v Azure Spring Cloud startu.

Přidání závislostí

1. Do souboru application.properties přidejte následující řádek:

   spring.zipkin.sender.type = web
   

   Po této změně může odesílatel Zipkin odeslat na web.

2. Tento krok přeskočte, pokud jste postupovali podle našeho průvodce přípravou aplikace v Azure Spring Cloud. Jinak přejděte do místního vývojového prostředí a upravte soubor pom.xml tak, aby zahrnoval následující Spring Cloud závislosti Sleuth:

   • Spring boot verze < 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>
     

   • Verze Spring Boot >= 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. Znovu sestavíte a nasadíte Azure Spring Cloud, aby tyto změny odrážela.

Úprava vzorkovací frekvence

Úpravou vzorkovací frekvence můžete změnit rychlost, s jakou se vaše telemetrie shromažďuje. Pokud například chcete vzorkovat polovinu tak často, otevřete soubor application.properties a změňte následující řádek:

spring.sleuth.sampler.probability=0.5

Pokud jste již aplikaci sestaví a nasadili, můžete vzorkovací frekvenci upravit. Proveďte to přidáním předchozího řádku jako proměnné prostředí v Azure CLI nebo Azure Portal.