Gedistribueerde tracering gebruiken met Azure Spring Cloud (afgeschaft)

In dit artikel leert u hoe u een .NET Core Steeltoe-app in staat stelt om gedistribueerde tracering te gebruiken.

Vereisten

Als u deze procedures wilt volgen, hebt u een Steeltoe-app nodig die al is voorbereid voor implementatie naar Azure Spring Cloud.

Afhankelijkheden

Voeg voor Steeltoe 2.4.4 de volgende NuGet-pakketten toe:

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

Voeg voor Steeltoe 3.0.0 het volgende NuGet-pakket toe:

• Steeltoe.Management.TracingCore

Startup.cs bijwerken

1. Roep voor Steeltoe 2.4.4 en AddDistributedTracing aan in de methode AddZipkinExporter ConfigureServices .

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

   Roep voor Steeltoe 3.0.0 AddDistributedTracing aan in de methode ConfigureServices .

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

2. Roep voor Steeltoe 2.4.4 UseTracingExporter aan in de methode Configure .

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

   Voor Steeltoe 3.0.0 zijn geen wijzigingen vereist in de Configure methode .

Configuratie bijwerken

Voeg de volgende instellingen toe aan de configuratiebron die wordt gebruikt wanneer de app wordt uitgevoerd in Azure Spring Cloud:

1. Stel management.tracing.alwaysSample in op Waar.

2. Als u tracering wilt zien die wordt verzonden tussen de Eureka-server, de configuratieserver en gebruikers-apps: stel in op management.tracing.egressIgnorePattern /api/v2/spans|/v2/apps/./permissions|/eureka/.| /oauth/.*".

Appsettings.json bevat bijvoorbeeld de volgende eigenschappen:

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

Zie Gedistribueerde tracering in de Steeltoe-documentatie voor meer informatie over gedistribueerde tracering in .NET Core Steeltoe-apps.

In dit artikel leert u het volgende:

Vereisten

Voor het volgen van deze procedures hebt u een Azure Spring Cloud-service nodig die al is ingericht en actief is. Voltooi de quickstart Uw eerste app Spring Boot implementeren in Azure Spring Cloud voor het inrichten en uitvoeren van een Azure Spring Cloud service.

Afhankelijkheden toevoegen

1. Voeg de volgende regel toe aan het bestand application.properties:

   spring.zipkin.sender.type = web
   

   Na deze wijziging kan de Zipkin-afzender naar het web verzenden.

2. Sla deze stap over als u onze handleiding voor het voorbereiden van een toepassing inAzure Spring Cloud. Als dat niet het geval is, gaat u naar uw lokale ontwikkelomgeving en bewerkt u het bestand pom.xml om de volgende Spring Cloud Sleuth-afhankelijkheid toe te voegen:

   • Spring Boot-< versie 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->= 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. Bouw en implementeer opnieuw voor de Azure Spring Cloud-service om deze wijzigingen weer te geven.

De samplefrequentie wijzigen

U kunt de snelheid waarmee uw telemetrie wordt verzameld, wijzigen door de samplefrequentie aan te passen. Als u bijvoorbeeld een sample van de helft wilt uitvoeren, opent u het bestand application.properties en wijzigt u de volgende regel:

spring.sleuth.sampler.probability=0.5

Als u al een toepassing hebt gemaakt en geïmplementeerd, kunt u de samplefrequentie wijzigen. Dit doet u door de vorige regel als een omgevingsvariabele in de Azure CLI of de Azure-portal toe te voegen.