Lenguaje

TracingBuilderConfigurationExtensions.AddConfiguration Método

Definición

Lee la configuración de seguimiento de la sección proporcionada IConfiguration y configura qué ActivitySource instancias y Activity están habilitadas.

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::Extensions::Diagnostics::Tracing::ITracingBuilder ^ AddConfiguration(Microsoft::Extensions::Diagnostics::Tracing::ITracingBuilder ^ builder, Microsoft::Extensions::Configuration::IConfiguration ^ configuration);
public static Microsoft.Extensions.Diagnostics.Tracing.ITracingBuilder AddConfiguration(this Microsoft.Extensions.Diagnostics.Tracing.ITracingBuilder builder, Microsoft.Extensions.Configuration.IConfiguration configuration);
static member AddConfiguration : Microsoft.Extensions.Diagnostics.Tracing.ITracingBuilder * Microsoft.Extensions.Configuration.IConfiguration -> Microsoft.Extensions.Diagnostics.Tracing.ITracingBuilder
<Extension()>
Public Function AddConfiguration (builder As ITracingBuilder, configuration As IConfiguration) As ITracingBuilder

Parámetros

configuration
IConfiguration

Sección IConfiguration que se va a cargar.

Devoluciones

Original ITracingBuilder para encadenar.

Comentarios

El seguimiento tiene dos niveles clave: Name y OperationName.

  • Nombres de sección: EnabledTracing (tanto globales como locales), EnabledGlobalTracingy EnabledLocalTracing, además de los formularios {ListenerName}:...específicos del agente de escucha.
  • Dentro de cada sección, las entradas admitidas son Default, {SourceName}, {SourceName}:Defaulty {SourceName}:{OperationName}. Default en cualquier nivel es un sinónimo del nivel anterior (una regla de nivel de origen cuando está anidada bajo un origen, una regla global en la parte superior).
  • Las reglas específicas del agente de escucha se evalúan junto con las reglas de nivel raíz. Cuando ambas coinciden, se elige la regla más específica; Las reglas específicas del agente de escucha son más específicas que los valores predeterminados de nivel raíz.
  • Los valores son solo booleanos: true habilita y false deshabilita.

Claves de ejemplo: EnabledTracing:Default=true, EnabledGlobalTracing:MyCompany.Service=false, EnabledTracing:MyCompany.Service:Checkout=truey MyListener:EnabledLocalTracing:MyCompany.Service=true.

Se aplica a