4.2.4 Npgsql.OpenTelemetryのセットアップ

Fujitsu Enterprise Postgresの.NET Data Providerには、オブザーバビリティフレームワークであるOpenTelemetryによるトレーシングをサポートするプラグインが同梱されています。これにより、Npgsqlにトレースデータを発行させることが可能になります。

OpenTelemetryプラグインはローカルのNuGetパッケージとして提供されています。ローカルにインストールするには、以下の手順で行います。

NuGetパッケージの格納場所

OpenTelemetryのNuGetパッケージは、以下に格納されています。“<x>”は製品のバージョンを示します。

Linuxの場合

<Fujitsu Enterprise Postgresクライアント機能のインストールディレクトリ>/DOTNET/Npgsql.OpenTelemetry.<x>.0.0.nupkg

Windows(R)の場合

<Fujitsu Enterprise Postgresクライアント機能のインストールディレクトリ>\DOTNET\Npgsql.OpenTelemetry.<x>.0.0.nupkg

ローカルパッケージソースの追加

NuGetローカルパッケージソースが存在しない場合は、追加します。

Linuxの場合

上記のNugetパッケージ格納場所をローカルパッケージソースとして追加します。

dotnet nuget add source <Fujitsu Enterprise Postgresクライアント機能のインストールディレクトリ>/DOTNET -n <ソース名>

Windows(R)の場合
1. Visual Studioを起動し、[ツール] - [オプション] - [NuGet パッケージマネージャー]をクリックし、[パッケージソース]を選択します。
2. 右上隅の[+]ボタンをクリックし、[名前]フィールドに“ローカルパッケージソース”を入力します。
3. [...]ボタンをクリックし、上のフォルダを検索します。このフォルダを選択し、[OK]ボタンをクリックします。

NuGetパッケージのインストール

ローカルのパッケージソースからNuGetパッケージをインストールします。

Linuxの場合
プロジェクトファイルにパッケージ参照を追加します。
```
dotnet add <プロジェクトファイルのパス> package Npgsql.OpenTelemetry
```

Windows(R)の場合
1. Visual Studioを起動し、[ツール] - [NuGet パッケージマネージャー] - [ソリューションの NuGet パッケージの管理]をクリックします。
2. 右上隅にある[パッケージソース]から“ローカルパッケージソース”を選択します。
3. ローカルパッケージソースを設定すると、このローカルロケーションにある利用可能なすべてのNuGetパッケージが表示されます。“Npgsql.OpenTelemetry”を選択し、このパッケージをインストールするプロジェクトを選択します。
4. [インストール]をクリックします。