TracingBuilderConfigurationExtensions.AddConfiguration 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
讀取所提供的IConfiguration區段的追蹤設定,並設定啟用的實ActivitySourceActivity例與實例。
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
- configuration
- IConfiguration
要載入的 IConfiguration 區段。
傳回
原版 ITracingBuilder 是用來串連的。
備註
追蹤有兩個關鍵層級: Name 和 OperationName。
- 區段名稱:
EnabledTracing(全域與本地)、EnabledGlobalTracing、EnabledLocalTracing、以及聽者專屬的形式{ListenerName}:...。 - 在每個區塊中,支援的項目有
Default、{SourceName}、{SourceName}:Default{SourceName}:{OperationName}和 。Default任一層級均為上述層級的同義詞(當巢狀於來源層級時為來源層級規則,頂端為全域規則)。 - 聽者專用規則與根層規則一併評估。 當兩者匹配時,會選擇最具體的規則;聽者專屬規則比根層預設更為具體。
- 值僅為布林值:
true啟用與false禁用。
範例鍵數:EnabledTracing:Default=true、、EnabledGlobalTracing:MyCompany.Service=falseEnabledTracing:MyCompany.Service:Checkout=true、 MyListener:EnabledLocalTracing:MyCompany.Service=true和 。