El valor predeterminado de ActivityIdFormat es W3C

El formato de identificador predeterminado para la actividad (Activity.DefaultIdFormat) ahora ActivityIdFormat.W3Ces .

Descripción del cambio

El formato de identificador de actividad W3C se introdujo en .NET Core 3.0 como alternativa al formato de identificador jerárquico. Sin embargo, para conservar la compatibilidad, el formato W3C no se estableció como predeterminado hasta .NET 5. El valor predeterminado se cambió en .NET 5 porque el formato W3C se ha ratificado y ha ganado tracción en varias implementaciones de lenguaje.

Si la aplicación tiene como destino una plataforma distinta de .NET 5 o posterior, experimentará el comportamiento anterior, donde Hierarchical es el formato predeterminado. Este valor predeterminado se aplica a las plataformas net45+, netstandard1.1+, y netcoreapp (1.x, 2.x y 3.x). En .NET 5 y versiones posteriores, Activity.DefaultIdFormat se establece en ActivityIdFormat.W3C.

Versión introducida

5.0

Acción recomendada

Si la aplicación es independiente del identificador que se usa para el seguimiento distribuido, no se necesita ninguna acción. Bibliotecas como ASP.NET Core y HttpClient pueden consumir o propagar ambas versiones de ActivityIdFormat.

Si necesita interoperabilidad con los sistemas existentes o los sistemas actuales dependen del formato del identificador, puede mantener el comportamiento previo estableciendo DefaultIdFormat a ActivityIdFormat.Hierarchical. Como alternativa, puede establecer un modificador AppContext de una de estas tres maneras:

• En el archivo del proyecto.

  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Diagnostics.DefaultActivityIdFormatIsHierarchial" Value="true" />
  </ItemGroup>
  

• En el archivo runtimeconfig.json.

  {
      "runtimeOptions": {
          "configProperties": {
              "System.Diagnostics.DefaultActivityIdFormatIsHierarchial": true
          }
      }
  }
  

• Mediante una variable de entorno.

  Establezca DOTNET_SYSTEM_DIAGNOSTICS_DEFAULTACTIVITYIDFORMATISHIERARCHIAL en true o 1.

Las APIs afectadas

• System.Diagnostics.Activity.DefaultIdFormat