Tricentis Notification Service からデータを送信する
Tricentis Notification Service は、Tricentis Toscaと他のアプリケーションとの間のデータインターフェースです。Tricentis Toscaを qTest 、 SAP Solution Manager Tosca Dashboards と統合する場合に不可欠なコンポーネントです。
独自の自己ホストデータベースを使用する
Tricentis Notification Service は、チェックインの際に自動的にデータを統合先に送信します。すべてのデータを収集し、データベースに保存した後、送信します。データ送信後、 Tricentis Notification Service はデータベースから送信データを削除します。
デフォルトでは、Tosca Serverはこの目的のためにSQLiteデータベースを提供します。
その代わりに、自己ホストのデータベースを使用したい場合は、それも可能です。以下をご留意ください。
-
Tricentis Notification Service はMS SQL または SQLiteデータベースをサポートしています。
-
データベースのホストマシンは、MS SQL または SQLiteのシステム要件を満たしている必要があります。
-
MS SQLデータベースを使用する場合、データベースユーザーは、 db_ ownerであり、 CREATE 、 ALTER 、 SELECT 、 INSERT 、 UPDATE 、および DELETE の権限を持っている必要があります。
-
SQLiteデータベースを使用する場合、 NotificationService Windowsサービスを実行するユーザーアカウントには、ファイルパスへのアクセス権、および読み取りと書き込みの権限が必要です。SQLiteデータベースはTosca Serverと同じマシン上になければなりません。ネットワーク共有でこの要件を回避することは可能ですが、この方法は使わないことを強くおすすめします。
-
データベースのテーブルを作成する必要はありません。Tricentis Notification Service は初回起動時にテーブルを作成します。
-
データベースは、Toscaとコンシューミングアプリケーションの間のバッファです。通知サービスは送信に成功するとデータを削除するので、時間の経過とともにデータベースが大きくなることはありません。転送中のデータを十分に処理できる大きさがあればいいのです。
自己ホスト型データベースを Tricentis Notification Service に接続してください。
自己ホストデータベースを作成したら、 Tricentis Notification Service に接続する必要があります。
-
TricentisTricentis Tosca サービス構成を開き、通知サービスタブに移動します。
-
データベース接続フィールドに有効な接続を入力します。
-
Windowsサービスアプリでサービスを再起動してください。
Tricentis Notification Service をインストールし設定する
Tricentis Notification Service は Tricentis Tosca Server の機能です。このセットアップは、次の Tricentis Tosca Server のインストールと設定に含まれています。
-
TricentisTricenti Tosca サービス構成で Tricentis Notification Service とTricentis ToscaAdministration Console を構成します。
通知サービスを使用するには、 Administration Console が必要です。
-
Tricentis Notification Service を Tricentis分散実行レガシーセットアップと一緒に使用することはできません。
Tricentis Notification Service を有効にする
Tricentis Notification Service を有効にするには、以下の手順に従います。
-
プロジェクトの概要で、 Tricentis Notification Service を有効にしたいプロジェクトに移動し、
「編集」アイコンをクリックしてください。 -
これにより、プロジェクトの詳細ダイアログが開きます。通知サービスセクションで、「有効済み」チェックボックスをオンにします。
-
「 はい」をクリックして確定します。
-
「 保存」をクリックします。
プロジェクトAでは Tricentis Notification Serviceが有効になっています
プロジェクトの Tricentis 通知サービスを無効にするには、プロジェクトの編集アイコンをクリックし、通知サービスセクションの「有効済み」チェックボックスをクリアします。
追加のオプション設定を行う
ToscaClient、 Tricentis Notification Service 、および消費アプリケーション間のデータ転送の動作を微調整できます。例えば、再試行回数、バッチ サイズ、送信戦略などを変更できます。
追加構成：ToscaClientから通知サービス へ
Toscaがロードする共通リポジトリ オブジェクトの数、HTTPリクエストごとに送信するオブジェクト数、および HTTPリクエストにかかる許容時間を定義できます。そのためには、以下の手順に従ってください。
-
こちらの説明に従って、 TCShell.dll.config ファイルの書き込み可能なコピーを作成します。
-
こちらに説明されている設定を変更します。
-
ファイルを保存して閉じます。
追加の設定：通知サービスからコンシューマへ
通知サービスからコンシューマへのデータ転送のために、以下の設定を変更することができます。
-
Tricentis Notification Service の基本的な処理方法：リトライ回数、バッチサイズ、送信ストラテジー。
-
Tricentis Notification Service のKestrel制限の処理方法。このサービスは、Microsoftのドキュメントに記載されているデフォルトの制限を使用します。これがお使いの環境でうまくいかない場合は、上書きすることができます。
設定を変更するには、以下の手順に従います。
-
appsettings.json ファイルを開きます。デフォルトのインストール後、ファイルは C：\Program Files(x86)\Tricentis\Tosca Server\NotificationService にあります。
-
NotificationHub セクションで、次の設定を変更します。
|
設定 |
説明 |
|---|---|
|
MaxRetries |
デフォルトでは、 Tricentis Notification Service はデータの送信を5回試みます。例えば、タイムアウトが原因で送信に失敗した場合、通知サービスはデータベースからこのデータを削除し、キャンセルします。 異なるリトライ回数を定義するには、正の整数を入力します。 注意：この数字を大きくすると、通知サービスがデータを送信できない場合、チェックイン処理に時間がかかります。 |
|
BatchSize |
この設定は Tosca Dashboards の統合にのみ適用されます。 デフォルトでは、 Tricentis Notification Service はTosca Dashboards のデータをバッチで送信します。各バッチには最大150,000のオブジェクトが含まれます。これで通知サービスにメモリの問題が発生する場合は、バッチあたりのオブジェクト数を少なく指定できます。 |
|
SendingStrategy |
この設定は、Tricentis Toscaを複数のアプリケーションと統合する場合に適用されます。 デフォルト値は Parallel です。つまり、 Tricentis Notification Service が複数のアプリケーションに並行してデータを転送します。これはデータ送信の最速の方法です。送信は同時に開始され、別々のスレッドで実行されます。 この伝送タイプを最大限に活用するには、マシンに複数のスレッドを処理できる複数のカーネルが必要です。マシンに複数のカーネルがない場合は、別の伝送タイプを定義できます。
|
-
Kestrelの制限を変更するには、 appsettings.json ファイルのルートレベルに対応するプロパティを作成します。Kestrel プロパティ名の詳細については、Microsoft のドキュメントを確認してください。
例えば、Kestrelプロパティ MaxResponseBufferSize の上限を変更したいとします。デフォルト値は30,000,000バイトですが、50,000,000バイトに増やしたいとします。この場合、 appsettings.json ファイルのルートレベルに以下のプロパティを追加します。
{
"Kestrel": {
"Limits": {
"MaxResponseBufferSize": 50000000,
}
},-
ファイルを保存して閉じます。
-
appsettings.json ファイルを変更した際に Tricentis Notification Service が既に実行中であった場合は、サービスを再起動してください。
ログを確認する
Tricentis Notification Service は送信するすべてのメッセージを記録します。データ転送で問題が発生した場合は、ログをチェックして、 Tricentis Notification Service がいつ何を送信したか確認してください。
これを行うには、Tosca Serverがインストールされているマシンにアクセスし、 C:\ProgramData\TRICENTIS\Logs\NotificationService に進みます。
デフォルトでは、通知サービスは1日に1つのログファイルを作成し、最大7つのログファイルを保持します。この動作を変更するには、以下の手順に従います。
-
Tosca Server がインストールされているマシンで、 C:\Program Files(x86)\Tricentis\Tosca Server\NotificationService に移動します。
-
appsettings.json ファイルを開きます。
-
Serilog セクションに移動します。
-
retainedFileCountLimit に新しい値を入力します。Tricentis Notification Service が保持するログファイルの数を示すために、任意の正の整数を入力することができます。
-
ファイルを保存して閉じます。