Bridgeページでは、Bridgeの設定を管理、監視、トラブルシューティングするためのさまざまな追加操作を実行できます。
Bridgeページにアクセスするには
Qntrlで、左ペイン下部にある[設定]の歯車アイコン をクリックします。
[詳細設定]→[Bridge]に移動し、[Bridge]をクリックします。
Bridge一覧ページで、表示するBridgeの名前をクリックします。
選択したBridgeの詳細が表示されます。主なセクションは次の3つです。
プロパティ
指標
メッセージ
このページでは、Bridgeの表示されているプロパティを確認し、変更できます。
Bridgeのプロパティを表示または変更するには
[プロパティ]タブをクリックします。
表示されているプロパティに必要な変更を行います。
[保存]をクリックして更新を適用します。
Bridgeのプロパティには次が含まれます。
モジュールを関連付けるには
[モジュール]を選択し、右側の[モジュールを関連付ける]をクリックします。
表示されたサービス一覧から、サービスを選択してそのモジュールを表示します。
Bridgeに関連付けるモジュールを選択します。
[保存]をクリックします。
Bridgeのバージョン更新を表示、管理できます。
[更新履歴]をクリックします。
新しいバージョンが利用可能な場合、[更新]ボタンが有効になります。
[更新]をクリックすると、手順を記載したポップアップが開きます。
古いBridgeバージョン(v2.18より前)では、ポップアップの手順に従って.sh更新ファイルを手動で実行する必要があります。
新しいバージョンでは、操作画面から直接完了できます。
迅速な診断のため、Bridgeの操作画面からログファイルを直接取得してダウンロードできます。
ログを取得するには
[最近のログを取得]をクリックします。
ログ設定ウィンドウで、取得するログの種類を選択します。
[Bridgeログ]–Bridge関連のログのみを取得します。
[サービスログ]–個別のサービスに固有のログを取得します。必要なサービスを選択するためのドロップダウンが表示されます。個別のサービスに固有のログを取得します。ドロップダウンをクリックして、必要なサービスを選択します。
[統合ログ]–Bridgeログと選択したサービスログの両方をまとめて取得します。ドロップダウンをクリックして、必要なサービスを選択します。
[実行]をクリックして、選択したログを取得します。
取得したログは一覧に表示されます。任意のファイル名にカーソルを合わせ、[ダウンロード]アイコンをクリックすると、ローカルに保存できます。
一度に保持されるログファイルは最大10件です。新しいファイルが取得されると、最も古いファイルが自動的に削除されます。
重点的なトラブルシューティングのために、サービス別ログを取得できるようになりました。
Bridge Agentの要求スレッドと応答スレッドの処理上限を定義します。ユーザーは、要求、応答、同期要求、非同期要求、およびSFTP要求などの各種スレッドについて、ブリッジが並列実行できるスレッド数と最大スレッド数、およびキューサイズを設定できます。これらの設定は、パフォーマンスとリソース使用率のバランスを取るのに役立ちます。
|
設定 |
説明 |
|
スレッド数 |
並列実行できるスレッドの最小数です。 |
|
最大スレッド数 |
同時に実行できるスレッドの最大数です。 |
|
キューサイズ |
キューに入れられるタスクの最大数です。この上限を超えたタスクは無視されます。 |
「メトリクス」セクションでは、Bridgeのリアルタイムおよび過去のパフォーマンス情報を確認できます。
ブリッジと、それに依存するタスクのパフォーマンスは、ブリッジをホストしているマシンのパフォーマンスに大きく左右されます。システムのパフォーマンスを定期的に監視し、問題が発生した場合は早めに対策を講じることが重要です。次のグラフは、Bridge Agentをホストしているマシンのリアルタイムのシステムパフォーマンスの監視に役立ちます。
利用可能なメトリクスは次のとおりです。
ライブCPU使用率レポートは、次の2つの形式で表示されます。
棒グラフ-CPU使用率の割合を時系列で表示します。
円グラフ-RAM、ディスク、スワップメモリー、JVMの使用状況の内訳を示します。
このレポートでは、選択した期間におけるブリッジの稼働状態の詳細を確認できます。次の条件でレポートをカスタマイズするためのフィルターオプションが用意されています。
期間(24時間から1年まで)
割合に基づく分析
メトリクスは30秒ごとに自動更新されます。最新のグラフを表示するには、ページを手動で更新できます。
Bridgeで処理されたメッセージを表示するには、[メッセージ]タブをクリックします。 Qntrlと接続済みサービス間のデータ交換を追跡するのに役立ちます。
ブリッジのリストページから、ブリッジを開く、再起動する、削除するなどのクイック操作を直接実行できます。
次の順に、[設定]→[詳細]→[ブリッジ]に移動し、[ブリッジ]を選択します。
管理するブリッジの名前にカーソルを合わせます。
[その他の操作](⋮)メニューをクリックして、利用可能なオプションを表示します。
[エージェントを開く]:QntrlからBridge Agentのログインページを直接起動します。Bridge Agentのログインページは、既定のブラウザーで開きます。
[再起動]:ブリッジエージェントをワンクリックで再起動します。トラブルシューティングや設定の更新を適用する際に便利です。
[削除]:不要になったブリッジをブリッジ一覧から削除します。
[ブラックリストに登録]:ブリッジが侵害された場合、利用できない場合、またはセキュリティ上の理由でブロックする必要がある場合に、ブリッジを制限します。
ブリッジがブラックリストに登録されると、次のようになります。
ブリッジとQntrlの接続が終了します。
ブリッジからの新しい接続がブロックされます。
ブリッジのステータスがブラックリスト登録済みに更新されます。
ブリッジ経由のメッセージ送信とコマンド実行が無効になります。
[ブラックリスト登録の解除]:このオプションは、ブラックリストに登録されたブリッジに表示されます。ブリッジをブラックリストから削除し、Qntrlへの再接続を許可します。
解除後、再接続するにはBridge Agentを手動で再起動する必要があります。
ブリッジの作成者とスーパー管理者のみ、[ブラックリストに登録]および[ブラックリスト登録の解除]操作を実行できます。
ブラックリストへの登録と解除は、Bridge Agentバージョン3.0以降でのみサポートされています。
稼働中のブリッジは削除できません。 ブリッジが停止していることを確認してください。
Bridge Agentをアンインストールします。
削除後、オンプレミスのマシンからBridgeのインストールフォルダーを手動で削除します。
次のいずれかのコマンドを使用してサービスを停止できます。
sc stop qntrl_bridge
net stop qntrl_bridge
<bridge_home>/bin/bridge.bat stop
または、Windowsサービスマネージャーからサービスを停止することもできます。
Linuxの場合
Linuxでブリッジを停止するには、次のいずれかのコマンドを使用します。
sudo service qntrl_bridge stop
sudo systemctl stop qntrl_bridge
sudo sh <bridge_home>/bin/bridge.sh stop
Bridge Agentの登録を解除するには、ターミナルで次のいずれかのコマンドを実行します。
sc delete qntrl_bridge
<bridge_home>/bin/bridge.bat uninstall
または、Windowsサービスマネージャーからサービスを手動で削除することもできます。
Linuxの場合
Linuxでエージェントの登録を解除するには、次のコマンドを使用します。
<bridge_home>/bin/bridge.sh uninstall
systemctlまたは serviceコマンドを使用するとサービスは削除されますが、システムファイルの一部は残ります。
Windowsの場合:C:\Program Files\Bridge
Linuxの場合:/Bridge
削除処理を完了するには、ご利用のシステムで該当するディレクトリーに移動し、フォルダーを手動で削除します。