nsTelemetryについてまとめたページです。
nsTelemetryとは
nsTelemetryは、.NET Framework / .NET Coreで作成されたデスクトップアプリで、テレメトリー情報の送信の実装を容易にするためのライブラリーです。
テレメトリー情報には以下のものがあります。
- ユーザー操作などのCustomEvent
- ページビューなどのViewEvent
- 例外発生状況などのExceptionEvent
などです。
公開サイト
ライブラリー
ライブラリーはnugetで公開しています。
NishySoftware.Telemetry
– nsTelemetryのコア ライブラリーNishySoftware.Telemetry.ApplicationInsights
– nsTelemetryのApplication Insights向けライブラリー
Azure Application Insights向けにはNishySoftware.Telemetry.ApplicationInsights
を利用します。NishySoftware.Telemetry.ApplicationInsights
は、NishySoftware.Telemetry
を参照しています。
Azure Application InsightsのITelemetryインターフェースのインスタンスを作成せず(インスタンスを他のモジュールから取得するモジュール)、ITelemetryインターフェースを使ってテレメトリーを送信するだけのモジュールは、NishySoftware.Telemetry
を利用します。
NishySoftware.Telemetry
を直接利用するかどうかは任意ですが、複数のモジュールで構成されているアプリケーションでは最低限一つのモジュール(ITelemetryのインスタンスを生成するモジュール)は、NishySoftware.Telemetry.ApplicationInsights
を使用する必要があります。
レポジトリ (ソースコード)
ソースコードなどは、github.comでnsTelemetry
として公開しています。なおgithub.comの情報はすべて英語となっています。
利用方法
使い方は、README.mdファイルに記載してあります。
- README.md の英語版 (github.com)
- README.md の日本語版 (このサイト)
- Ver. 2.1.0 (2021年09月19日 公開)
- Ver. 2.1.1 (2021年10月16日 公開)
- Ver. 2.2.0 (2022年06月19日 公開)
- Ver. 2.2.1 (2023年04月25日 公開)
nsTelemetryに関連した投稿
- PCアプリの利用状況・例外発生状況を遠隔計測する #1 Application Insights (2021年9月27日)
- PCアプリの利用状況・例外発生状況を遠隔計測する #2 ライブラリーの公開 (2021年10月4日)
- PCアプリの利用状況・例外発生状況を遠隔計測する #3 ライブラリー 2.1.1の公開 (2021年10月18日)
- PCアプリの利用状況・例外発生状況を遠隔計測する #4 ライブラリー 2.2.0の公開 (2022年06月20日)
- PCアプリの利用状況・例外発生状況を遠隔計測する #5 ライブラリー 2.2.1の公開 (2023年05月1日)
Azure Application Insightsの関連情報
NishySoftware.Telemetry.ApplicationInsights
は、Azure Application Insightsをテレメトリーの送信先として実装したライブラリーです。そのため、Azure Application Insightsの情報は参考になります。
Azure Application Insightsのページ
Microsoft.ApplicationInsightsのライブラリー
Microsoft.ApplicationInsightsライブラリー群の中でデスクトップアプリに関連するは以下のものになります。
- Microsoft.ApplicationInsights
- Microsoft.ApplicationInsights.WindowsServer
- Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel
Microsoft.ApplicationInsightsのレポジトリ
Microsoft.ApplicationInsightsライブラリーのレポジトリはgithub.comとなります。