202202 open telemetry .net handson
?Download as PPTX, PDF?
0 likes?369 views
OpenTelemety .NET ハンズオン資料
202202 open telemetry .net handson
- 2. ?2008–21 New Relic, Inc. All rights reserved 講師紹介 2 @tanaka_733 New Relic K.K. Lead Technical Support Engineer C# Tokyo運営メンバーの一人です 好きな言語はC# コンテナとパブリッククラウドと量子コンピューターが好物 Microsoft MVP for Azure, Development Technologies Microsoft Certified Cloud Solution Architect Expert Certified Kubernetes Administrator/Application Developer (CKA/CKAD)
- 3. 事前準備の確認 まだの人は聞きながらセットアップしておいてください ? https://github.com/tanaka-takayoshi/opentelemetry-dotnet-labのクローン ? .NET 6 SDKのインストール ? handson1/handson1.sln の起動確認 ? connpassのページにあるNew Relicのログイン情報とAPIキーのメモ 提供しているNew Relicアカウントは1週間程度使えますが、 その後無効化します。 継続的に使いたい方は無償のStandard Tierの登録を検討ください。
- 5. Agenda OpenTelemetryとは ? OpenTelemetryとは ? OpenTelemetryの生まれた背景 翱辫别苍罢别濒别尘别迟谤测の构造 ? OpenTelemetryが計測するテレメトリーデータ ? OpenTelemetryの構成要素 OpenTelemetry .NETで計装するには ? 計装とは ? OpenTelemetry .NETの仕組み ? 計装の実際 ? データの送信とコレクター
- 8. OpenTelemetryの生まれた背景 ベンダーサービスが先行し、データモデルが固有化 Vendor X Agent Vendor Y Agent Vendor X backend Vendor Y backend Agentの移行は 手間がかかる 異なるベンダーには 送信できない
- 9. OpenTelemetryの生まれた背景 ライブラリや利用しているクラウドサービスを別サービスで再利用したい場合、 Agent固有の計測用のコードが移植の妨げに サービス Q サービス P ライブラ リA Vendor X Agent ライブラ リA Vendor Y Agent API
- 11. 翱辫别苍罢别濒别尘别迟谤测の构造
- 12. 計測するテレメトリーデータは3種類 ? ある状態を表す 集約された統計値 ? CPU利用率、 リクエスト経過時間、 データベースクエリ数 など ? プロセスから生じた 詳細なデバッグ情報 ? Error: XXX happened Trace: YYY invoked など メトリクス ログ ? システムへのリクエス トの一覧のライフサイ クル情報 ? 分散トレースは特に複 数のシステムをまたい だライフサイクル ? エラーやパフォーマン ス問題が起きた場所を 特定する情報を含む トレース (特に分散トレース)
- 13. トレース(Trace)はスパン(Span)の集合 Span A Span B Span C Span D Span E Span P サービスA サービスB Spanの持つ情報 ? TraceID/SpanID ? ParentID ? Name ? Start/End Time ? Attributes ? Events
- 14. トレース(Trace) Span A Span B Span C Span D Span E Span P サービスA サービスB root Span (必ず1つだけ存在) AのChild Span Caller Span (呼び出しスパン) Callee Span (呼び出されたス パン)
- 15. トレース time Span A Span B C Span D Span E Span P ボトルネック（どこで経過時間がかかっているか）を見つけるためには、 横軸を実時間にしたこのような表現が使われることが多い。 上の図では、SpanP、つぎにSpanDがボトルネックだとわかる
- 17. メトリクス ある時点でのサービスに関する測定値から取得した、 あらかじめ集計された時系列データ 例えば… ? CPUとメモリの使用率 ? リクエスト経過時間 ? リクエストサイズ 属性によりメタデータを追加し、ファセット(グルーピング)できるように ? URLごとの経過時間?どのAPIが最も遅いか ? ユーザーごとのアイテム利用数?ユーザー属性による利用傾向
- 18. ログ タイムスタンプ付きのテキストレコード トレースやメトリクスより歴史が長いため従来のログとの共存が課題: ? メトリクスやトレースと関連づけるためのコンテキストとなるメタデータが必要 ? 歴史的に多くの言語、ツールによる実装が幅広く使われている ? メッセージに加えてログレベル、ログメッセージまでも統一したデータモデルがない OpenTelemetryの戦略 ? 既存のロギングライブラリやツールを採用しつつ、 ログデータにコンテキスト情報を追加する仕組みを提供する。 ?例: ASP. NET Core向けのOTel .NET では ILoggerと連携
- 19. OpenTelemetryの構成要素 Instrumentation 19 Collector （Gateway） Grafana, New Relic などのバックエンド アプリ (C#) OTel SDK Collector (Agent) Jaegarなど その他のソース Instrumentation アプリ (Java) OTel SDK Collector (Agent) OpenTelemetry の構成要素 異なる言語でも APIで 標準化され、 言語ごとに SDKで実装 送信するデータの形式を OTLPとして定める
- 20. OpenTelemetryのコレクター Instrumentation 20 Collector （Gateway） Grafana, New Relic などのバックエンド アプリ (C#) OTel SDK Collector (Agent) OpenTelemetry の構成要素 テレメトリーデータは大まかに以下の3通りの送信方法がある。 1. SDKから直接送信 (今日のハンズオンでやります） 2. アプリと同じホストのコレクターが送信 3. アプリと同じホストのコレクターとGatewayとなるコレクター を経由して送信 ① ② ③
- 25. ハンズオンのお題 (OTel .NETの計装) 1. ASP.NET CoreとHTTPClientでの自動計装によるトレースの計装 2. 自動計装されたトレース詳細な情報を追加 3. SQL呼び出しなど一部対応が必要なトレースの自動計装 (例: contribによるEF Coreの計装） 4. ILoggerでのログ出力をOTelで収集 https://github.com/tanaka-takayoshi/opentelemetry-dotnet- lab/blob/main/handson1/Handson1.md
- 27. 宣伝 OpenTelemetry .NETについてブログでまとめています https://tech.tanaka733.net/entry/2022/01/opentelemetry-dotnet-01 今後扱う予定のテーマ ? より詳細な計装コード ? .NET Frameworkでの計装 ? GUI（クライアントアプリ）での計装 ? ライブラリ開発者向けの計装 ? コレクターの設計と展開
- 28. Thank you.