Uso del seguimiento distribuido con Azure Spring Cloud (en desuso)

En este artículo, aprenderá a habilitar una aplicación Steeltoe de .NET Core para usar el seguimiento distribuido.

Requisitos previos

Para seguir estos procedimientos, necesita una aplicación Steeltoe que ya esté preparada para su implementación en Azure Spring Cloud.

Dependencias

Para Steeltoe 2.4.4, agregue los siguientes paquetes NuGet:

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

Para Steeltoe 3.0.0, agregue el siguiente paquete NuGet:

• Steeltoe.Management.TracingCore

Actualización de Startup.cs

1. Para Steeltoe 2.4.4, llame a AddDistributedTracing y AddZipkinExporter en el método ConfigureServices.

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

   Para Steeltoe 3.0.0, llame a AddDistributedTracing en el método ConfigureServices.

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

2. Para Steeltoe 2.4.4, llame a UseTracingExporter en el método Configure.

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

   Para Steeltoe 3.0.0, no se necesitan cambios en el método Configure.

actualizar la configuración

Agregue la siguiente configuración al origen de configuración que se usará cuando la aplicación se ejecute en Azure Spring Cloud:

1. Establezca management.tracing.alwaysSample en true.

2. Si desea ver los intervalos de seguimiento enviados entre el servidor Eureka, el servidor de configuración y las aplicaciones de usuario: establezca management.tracing.egressIgnorePattern en "/api/v2/spans|/v2/apps/. /permissions|/eureka/. |/oauth/.*".

Por ejemplo, appsettings.json incluiría las siguientes propiedades:

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

Para obtener más información sobre el seguimiento distribuido en las aplicaciones de .NET Core Steeltoe, consulte el artículo de seguimiento distribuido en la documentación de Steeltoe.

En este artículo aprenderá a:

Requisitos previos

Para realizar estos procedimientos, necesita un servicio de Azure Spring Cloud que ya esté aprovisionado y en ejecución. Complete el inicio rápido Implementación de la primera aplicación de Spring Boot en Azure Spring Cloud para aprovisionar y ejecutar un servicio de Azure Spring Cloud.

Adición de dependencias

1. Agregue la siguiente línea al archivo application.properties:

   spring.zipkin.sender.type = web
   

   Después de este cambio, el remitente de Zipkin puede realizar envíos a la web.

2. Omita este paso si ha seguido la guía para preparar una aplicación en Azure Spring Cloud. En caso contrario, vaya al entorno de desarrollo local y edite el archivo pom.xml para incluir la siguiente dependencia de Spring Cloud Sleuth:

   • Versión de Spring Boot anterior a la 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>
     

   • Versión de Spring Boot posterior a la 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. Vuelva a compilar e implementar el servicio Azure Spring Cloud para reflejar estos cambios.

Modificación de la frecuencia de muestreo

Puede cambiar la frecuencia con la que se recopilan los datos de telemetría. Para ello, debe modificar la frecuencia de muestreo. Por ejemplo, si quiere muestrear la mitad tan a menudo, abra el archivo application.properties y cambie la línea siguiente:

spring.sleuth.sampler.probability=0.5

Si ya ha creado e implementado una aplicación, puede modificar la frecuencia de muestreo. Para ello, agregue la línea anterior como una variable de entorno en la CLI de Azure o en Azure Portal.