Язык

TracingBuilderConfigurationExtensions.AddConfiguration Метод

Определение

Пространство имен:
Microsoft.Extensions.Diagnostics.Tracing
Сборка:
Microsoft.Extensions.Diagnostics.dll
Пакет:
Microsoft.Extensions.Diagnostics v11.0.0-rc.2.26504.105
Исходный код:
TracingBuilderConfigurationExtensions.cs

Считывает конфигурацию трассировки из предоставленного IConfiguration раздела и настраивает, какие ActivitySource и Activity экземпляры включены.

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

Параметры

builder
ITracingBuilder

ITracingBuilder.

configuration
IConfiguration

Раздел IConfiguration для загрузки.

Возвращаемое значение

ITracingBuilder

Исходный объект ITracingBuilder для цепочки.

Комментарии

Трассировка имеет два ключевых уровня: Name и OperationName.

  • Имена разделов: EnabledTracing (как глобальные, так и локальные), EnabledGlobalTracingа EnabledLocalTracingтакже формы {ListenerName}:..., относящиеся к прослушивателю.
  • В каждом разделе поддерживаются Defaultзаписи , {SourceName}{SourceName}:Defaultи {SourceName}:{OperationName}. Default на любом уровне является синонимом приведенного выше уровня (правило исходного уровня при вложении в источник глобальное правило в верхней части).
  • Правила, относящиеся к прослушивателю, оцениваются вместе с правилами корневого уровня. При обоих совпадениях выбирается наиболее конкретное правило; Правила, относящиеся к прослушивателю, являются более конкретными, чем по умолчанию для корневого уровня.
  • Значения являются логическими только: true включает и false отключает.

Примеры ключей: EnabledTracing:Default=true, EnabledGlobalTracing:MyCompany.Service=false, EnabledTracing:MyCompany.Service:Checkout=trueи MyListener:EnabledLocalTracing:MyCompany.Service=true.

Применяется к