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