This is a deck of .NET Fringe Japan 2018 New Year's Party short talk. It describes some tips of implementations of Microsoft.Extensions.Logging structured logging and Application Insights .NET.

1. .NET Core diag tips
V1.1 2018/1/27 .NET Fringe Japan 2018
藤原 雄介 @yfakariya

2. このセッションについて
▪ .NET Fringeなのですがあまりディープな話はしません
▪ しかもAPIの名前空間がすべてMicrosoft.*
▪ ロガーをカスタマイズしてみよう、AppInsightsをカスタマイズしてみようという気にはなるかも
2

3. ログ
▪ Microsoft.Extensions.Logging
▪ ファサードとしてインターフェイスを定義しつつ、既定の実装も用意
▪ 構造化ロギングをサポート
▪ アダプター
▪ NLog、Serilog、TraceSource
▪ MS製ロガー
▪ Debug、Console、EventSource、EventLog、AppServiceDiagnostics、AppInsights
3

4. 構造化ロギング
▪ M.E.Loggingの以下の拡張メソッドは構造化ロギングをサポート
▪ LogCritical
▪ LogError
▪ LogWarning
▪ LogInformation
▪ LogDebug
▪ LogTrace
▪ 値をどう見せるのかはLoggerの実装依存
▪ 構造化して出さずにフォールバックするのも自由
4

5. 構造化ロギング
▪ formatで指定した名前で、argsで指定した値が入る
▪ 名前と値の紐づけは順序ベース
5
logger.LogDebug("Hello, {user}, I’m {service}", userName, serviceName)
string format object[] args
LogXxx拡張メソッド
Log<T>メソッド
"Hello, {user}, I’m {service}"
"Hello, {0}, I’m {1}"
["userName", "serviceName"]
logger.Log(state, formatter = (s, e)=>s.ToString())
FormattedLogValues
LogValueFormatter
[userName, serviceName]
originalMessage
originalFormat
valueNames
args

6. 構造化ロギング
▪ Loggerの実装は、渡されたstateとformatterを以下のように使う
▪ 文字列実装
▪ stateをformatterに渡す
▪ これは最終的に（先ほどの図の変数名を使うと）String.Format(orginalFormat, args)になる
▪ Debug、Console、AppServiceDiagnosticsなど
▪ 構造化実装
▪ stateをIReadOnly<KeyValuePair<string, object>>にキャストし、JSON等に直す
▪ Serilog（のJsonFormatter系）、AppInsightsなど
6

7. App Insights
▪ 詳細や実用的な話は@takekazuomiさんがすでに述べているので割愛
▪ アプリケーションのメトリクスを採取するライブラリと、収集・分析用のSaaS
▪ SaaS側の話や.NETじゃないライブラリの話は別途
▪ カスタムのイベント（運用的な事象、発生のみを識別）、メトリクス（集計可能な数値）、トレース
（文字列）を出力可能（TelemetryClientクラスを使用）
▪ Log4netやNLogなどに出力をリダイレクト可能
▪ 今日は組み込みのメトリクスについて
7

8. App Insights 組み込みのメトリクス
▪ マジカルな方法で勝手に色々なメトリクスを取ってくれる
▪ 実態は
▪ HTTPのリクエストを横取りして記憶する HttpModule（ASP.NET）ないしStartupFilter（ASP.NET
Core）
▪ 標準的なAPI（HttpClientやSqlClient）の呼び出しを横取り
▪ 実装はここ
▪ https://github.com/Microsoft/ApplicationInsights-dotnet-server/tree/master/Src/DependencyCollector/
▪ 何が出ているのかの詳細も（corefxなどのソースコードを使って）追える
8

9. HTTPリクエスト関連
▪ ざっくりとした動作
▪ HttpContextから情報を取得
▪ 中間データ（たとえば要求ID）はHttpContextに保存
▪ ASP.NET/ASP.NET Coreからの診断イベントをDiagnosticsListenerで取得
▪ つまりはAPサーバーのインストゥルメントを横取り、集計してTelemetryClientで送っているだけ
▪ 詳細
▪ ASP.NET
▪ https://github.com/Microsoft/ApplicationInsights-dotnet-server/tree/master/Src/Web
▪ のWeb.Net45/ImplementationとWeb.Shared.Net/Implementation
▪ ASP.NET Core
▪ https://github.com/Microsoft/ApplicationInsights-
aspnetcore/tree/master/src/Microsoft.ApplicationInsights.AspNetCore/Extensibility/Implementation
9

10. 依存先関連
▪ ざっくりとした動作
▪ .NET FrameworkでProfiler APIが有効な場合はCLRのProfiler APIでHttpWebRequest、SqlConnection、
SqlCommandのPrologueとEpilogueイベントをフック
▪ Profiler APIが無効な.NET Framework 4.5以降の場合はETW（EventListener）でSystem.Net.Httpと
System.Data.SqlClientのイベントをフック
▪ CoreFxのDiagnosticsListenerで（CoreFx由来の）System.Net.HttpとSystem.Data.SqlClientのイベントをフッ
ク
▪ .NETの場合はランタイムに割り込み、そうでない場合はライブラリのインストゥルメントを横取りして
TelemetryClientで送っているだけ
▪ 詳細
▪ https://github.com/Microsoft/ApplicationInsights-dotnet-
server/blob/master/Src/DependencyCollector/Shared/Implementation/ProfilerRuntimeInstrumentation.c
s
▪ https://github.com/Microsoft/ApplicationInsights-dotnet-
server/blob/master/Src/DependencyCollector/Shared/DependencyTrackingTelemetryModule.cs
10

11. Let’s hack
▪ Diagnostics Sourceを使えば、AppInsights相当の機能を作ることができる
▪ Diagnostics Sourceを仕込めば、MySQL、PostgreSQL、Cassandra、Redis、GRPC
なども連携できる
11