IBM App Connect Enterprise （ACE）の監視
Instana Observability を使用すると、 IBM ACE 環境を監視し、その状態やパフォーマンスを完全に把握することができます。
まず、お使いの環境に Instana のホストエージェントをインストールしてください。 エージェントは自動的に IBM ACE センサーを展開し、設定が完了すると、センサーは監視データの収集を開始します。 その後、このデータを Instana のUIで確認できます。
サポート情報
IBM App Connect Enterprise （ACE）センサーが現在の環境と互換性があるかどうかを確認するには、以下のサポート情報セクションをご確認ください：
サポート対象のオペレーティング・システム
IBM ACE センサーは、対応するオペレーティングシステムにホストエージェントをインストールすると、自動的にインストールされます。 詳細については、ホストエージェントの対応 OSをご覧ください。
IBM ACE センサーは、以下のオペレーティングシステムに対応しています：
- Linux
- AIX
- Windows
- 従来のACE環境における IBM ACE センサーの自動検出機能は、 Linux および AIX でも利用可能です。 Windows 自動検出には対応しておらず、手動での設定が必要です。
- クラウドネイティブのACE環境では、設定は自動的に検出されます。
対応バージョンとサポート方針
- IBM ACE センサーは、サポートされているすべてのオペレーティング・システムにインストールされている IBM Integration Bus (IIB) 10.0.x、 IBM ACE 11.0.x、 IBM ACE 12.0.x、および IBM ACE 13.0.x のメトリックと構成データをサポートします。 ただし、従来のACE環境における IBM ACE センサーの自動検出機能は、 IBM ACE 11以降のみをサポートしており、IIB 10はサポートされていません。
- IBM ACE トレース機能は、さまざまなバージョンやプラットフォームに対応しています。 詳細については、 「 IBM ACE でサポートされているトレースのバージョンとプラットフォーム」 を参照してください。
以下の表は、最新のサポート対象バージョンとサポート方針を示しています：
| テクノロジー | サポート・ポリシー | 最新バージョン | サポートされる最新バージョン |
|---|---|---|---|
| IBM App Connect Enterprise (ACE) | 45 日間 | 13.0.8.0 | 13.0.7.2 |
サポートポリシーに関する詳細については、 「センサーのサポート戦略」 を参照してください。
Instana のACEトレース・ユーザー・エグジットは、以下のプラットフォームに対応しています：
- 11.0.0.8 から ACE 12.0.6.x までの BM ACE バージョン。 代替手段としての OpenTelemetry トレースの統合に関する詳細については、 「統合ランタイム向けの OpenTelemetry トレースの設定」 を参照してください。
- Linux x86_64、 Linux、 ppc64le、 Linux、 s390x、 AIX、 7.2、 AIX、 7.3、 Windows の各バージョンにおける従来の ACE、および IBM Cloud Pak for Integration （ amd64 のみ）におけるコンテナ ACE。
追加のサポート情報
IBM ACE センサーは、ローカル監視とリモート監視の両方に対応しています。
IBM ACE センサーの設定
IBM ACE センサーは、従来の環境でもクラウドネイティブ環境でも設定できます。 詳細については、 「 IBM ACE センサーの設定」 を参照してください。
IBM ACE のトレース設定
「 IBM ACE 」は、 Instana のACEトレース・ユーザー・エグジットを使用してトレースできます。 詳細については、 「 IBM ACE のトレース設定」 を参照してください。
メトリックの表示
メトリックを表示するには、以下のステップを実行します。
- Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
- 監視対象の IBM ACE インスタンスを1つクリックします。
収集されたすべてのメトリクスと監視対象のプロセスが表示された IBM ACE のダッシュボードを確認できます。
構成データ
このセンサーは、 IBM ACE インスタンスから以下の構成データを収集します：
- デフォルト・キュー・マネージャー名
- 製品名
- バージョン
- ビルド・レベル
- プラットフォーム名
- プラットフォームのアーキテクチャー
- プラットフォームのバージョン
- アプリケーション名
パフォーマンス・メトリック
このセンサーは、以下のパフォーマンス指標を収集します：
統合サーバー
次の表は、統合サーバーから収集されたメトリクスの概要を示しています：
| メトリック | 説明 |
|---|---|
| 初期ヒープ・メモリー | JVM が始動時にメモリー管理のためにオペレーティング・システムに要求するメモリーの初期量。 |
| 使用済みヒープ・メモリー | 使用されているメモリーの量。 |
| コミットされたヒープ・メモリー | オペレーティング・システムから JVM に割り振られているメモリーの量。 |
| 最大ヒープ・メモリー | メモリー管理のために使用できるメモリーの最大量。 |
| 初期非ヒープ・メモリー | JVM が始動時にメモリー管理のためにオペレーティング・システムに要求するメモリーの初期量。 |
| 使用済み非ヒープ・メモリー | 使用されているメモリーの量。 |
| コミット済み非ヒープ・メモリー | オペレーティング・システムから JVM に割り振られているメモリーの量。 |
| 最大非ヒープ・メモリー | メモリー管理のために使用できるメモリーの最大量。 |
| 累積 GC 時間 | データが収集される時間 (秒)。 |
| GC の累積数 | JVM のこのインスタンスで発生したガーベッジ・コレクションの総数。 |
メッセージ・フロー
次の表は、メッセージフローのメトリクスをまとめたものです：
| メトリック | データ・タイプ | 説明 |
|---|---|---|
| 合計経過時間 | 数値 | メッセージ・フローが入力メッセージの処理に費やした合計経過時間 (マイクロ秒単位)。 |
| 最大経過時間 | 数値 | メッセージ・フローが入力メッセージの処理に費やした最大経過時間 (マイクロ秒単位)。 |
| 最小経過時間 | 数値 | メッセージ・フローが入力メッセージの処理に費やした最小経過時間 (マイクロ秒単位)。 |
| 合計 CPU 時間 | 数値 | メッセージ・フローが入力メッセージの処理に費やした合計 CPU 時間 (マイクロ秒単位)。 |
| 最大 CPU 時間 | 数値 | メッセージ・フローが入力メッセージの処理に費やした最大 CPU 時間 (マイクロ秒単位)。 |
| 最小 CPU 時間 | 数値 | メッセージ・フローが入力メッセージの処理に費やした最小 CPU 時間 (マイクロ秒単位)。 |
| 入力メッセージ待ちの CPU 時間 | 数値 | メッセージ・フローが入力メッセージの待機に費やした合計 CPU 時間 (マイクロ秒単位)。 |
| 入力メッセージ待ちの経過時間 | 数値 | 入力メッセージの待機に費やされた合計経過時間 (マイクロ秒単位)。 |
| すべての入力メッセージの数 | 数値 | 入力メッセージの合計数。 |
| 入力メッセージの合計サイズ | 数値 | 入力メッセージの合計サイズ (バイト単位)。 |
| 入力メッセージの最大サイズ | 数値 | 入力メッセージの最大サイズ (バイト単位)。 |
| 入力メッセージの最小サイズ | 数値 | 入力メッセージの最小サイズ (バイト単位)。 |
| プール内のスレッドの数 | 数値 | プール内のスレッドの数。 |
| 最大スレッド数に達した回数 | 数値 | スレッド数が最大数に達した回数。 |
| MQGET エラーの数 | 数値 | MQInput ノードの場合は MQGET エラーの数、HTTPInput ノードの場合は Web サービス・エラーの数。 |
| エラーがあるメッセージの数 | 数値 | エラーを含むメッセージの数。 |
| メッセージ処理時のエラーの数 | 数値 | メッセージの処理時に発生したエラーの数。 |
| トランザクション・タイムアウトの数 | 数値 | メッセージの処理中に発生したトランザクション・タイムアウトの数 ( AggregateReply ノードの場合のみ)。 |
| トランザクション・コミットの数 | 数値 | メッセージの処理時に発生するトランザクション・コミットの数。 |
| トランザクション・バックアウトの数 | 数値 | メッセージの処理時に発生するトランザクション・バックアウトの数。 |
| スレッド使用率 | 数値 | 各メッセージ・フローのスレッド使用数。 |
メッセージ・フロー・ノード
次の表は、メッセージフローノードから収集されたメトリクスの概要を示しています：
| メトリック | データ・タイプ | 説明 |
|---|---|---|
| 合計経過時間 | 数値 | 入力メッセージの処理に費やされた合計経過時間 (マイクロ秒単位)。 |
| 最大経過時間 | 数値 | 入力メッセージの処理に費やされる最大経過時間 (マイクロ秒単位)。 |
| 最小経過時間 | 数値 | 入力メッセージの処理に費やされる最小経過時間 (マイクロ秒単位)。 |
| 合計 CPU 時間 | 数値 | 入力メッセージの処理に費やされた合計 CPU 時間 (マイクロ秒単位)。 |
| 最大 CPU 時間 | 数値 | 入力メッセージの処理に費やされる最大 CPU 時間 (マイクロ秒単位)。 |
| 最小 CPU 時間 | 数値 | 入力メッセージの処理に費やされる最小 CPU 時間 (マイクロ秒単位)。 |
| 呼び出しの回数 | 数値 | このフロー・ノードによって処理されたメッセージの総数。 |
| 入力タイプの端末数 | 数値 | 入力タイプの端末の数。 |
| 出力タイプの端末数 | 数値 | 出力タイプの端末の数。 |
既知の制限
REST API インターフェースで HTTPS が有効になっている場合、ファイルに および keystorePassword keystore パラメータを <agent_install_dir>/etc/instana/configuration.yaml指定する必要があります。 型 keystore については、JKSまたは P12 のみがサポートされています。
正常性シグニチャー
各センサーには、着信メトリックに対して継続的に評価され、ユーザーの影響に応じて問題またはインシデントを発生させるために使用される正常性シグネチャーのキュレートされた知識ベースがあります。
組み込みイベント は、エンティティー上の失敗したヘルス・シグニチャーに基づいて問題またはインシデントをトリガーし、 カスタム・イベント は、エンティティーの個々のメトリックのしきい値に基づいて問題またはインシデントをトリガーします。
IBM ACE センサーの組み込みイベントに関する詳細については、 「組み込みイベントのリファレンス」 を参照してください。
トラブルシューティング
Instana では、監視に関する問題が発生する可能性があります。 これらの解決方法について詳しくは、 トラブルシューティングを参照してください。