Zabbix の監視（パブリック プレビュー）
Zabbix は、ホストや仮想マシンなどのITインフラを監視するオープンソースのソフトウェアツールです。 「 Zabbix 」で監視されているホスト、およびそれらに関連するメトリクスや問題を「 Instana 」のUIに表示するには、「 Instana 」用の「 Zabbix 」センサーを使用できます。
Instana ホストエージェントをインストールすると、 Zabbix センサーが自動的にインストールされます。 センサーの設定が完了すると、 Instana のUIで、 Zabbix によって監視されているホストのメトリクスを確認できます。 設定の詳細については、 「 Zabbix センサーの設定」 を参照してください。
補足情報
サポート対象のオペレーティング・システム
Zabbix センサーの対応OSは、各ホストエージェントの要件と一致しています。これについては、各ホストエージェントの「対応OS」セクションで確認できます。例： Unix の対応OS。
サポートされるバージョン
Instana Zabbix、 6.4 以降のバージョンにおいて、メトリクスと問題（ Instana にイベントとしてインポートされる）をサポートしています。
Zabbix センサーの設定
Zabbix インスタンスに接続するには、エンドポイントと API キーを使用して、 Instana の Zabbix センサーを設定する必要があります。 エージェント構成ファイル <agent_install_dir>/etc/instana/configuration.yaml内の以下のフィールドを構成する必要があります。
com.instana.plugin.zabbix:
enabled: true
endpoint: 'http://zabbixhostname/zabbix/api_jsonrpc.php'
token: 'redacted'
poll_rate: 30
以下の表に、サポートされる構成オプションを示します。
| 名前 | タイプ | 必須 | Default | 説明 |
|---|---|---|---|---|
enabled |
ブール値 | いいえ | いいえ | このパラメーターは、センサーが有効になっているかどうかを検証します。 |
endpoint |
ストリング | はい | NA | Zabbix サーバーのエンドポイント： API。 |
token |
ストリング | はい | NA | API トークン エンドポイントにアクセスするために使用されるものです。 |
poll_rate |
整数 | いいえ | 30時間まで | メトリック照会の間隔 (秒数)。 エンドポイントによって課されるポーリング・レート制限に対応するために、時間の調整が必要になる場合があります。 |
target_zone |
ストリング | いいえ | 該当なし | Zabbix によって監視されているホストが、 Instana のインフラストラクチャマップ上に表示されるジェネリックゾーンの名前。 ゾーンが指定されていない場合、ホストは Undefined
Zoneに表示されます。 |
read_timeout |
整数 | いいえ | 30時間まで | センサーがリクエストを終了するまでにZabbixサーバーからの応答を待つ秒数。 Zabbixサーバ接続時にエージェントログに「java.net.SocketTimeoutException頻繁に表示されるのを防ぐため、時間を長くしてください。 |
connect_timeout |
整数 | いいえ | 30時間まで | センサーが接続を終了するまでにZabbixサーバーとの接続確立を待機する秒数。 |
Zabbix エンドポイント
Instana Zabbix センサーは、 Zabbix API を使用して、 Zabbix が監視するホストに関する情報を収集します。 Zabbix と通信するには、 Zabbix API のエンドポイントが必要です。 次の例は、 Zabbix API のエンドポイントの形式を示しています： https://<zabbix-hostname>/zabbix/api_jsonrpc.php
Instana configuration.yaml ファイルには、サフィックス api_jsonrpc.php を含むエンドポイント全体を記載する必要があります。
Zabbix （ API ）の詳細については、 『 Zabbix 』のドキュメントを参照してください。
Zabbix API トークン
Zabbix API にアクセスするには、 Zabbix API のトークンが必要です。 Zabbix API トークンの作成方法の詳細については、 Zabbix のドキュメントを参照してください。
メトリックの表示
メトリックを表示するには、以下のステップを実行します。
- Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 を選択します。
- 特定のモニター対象ホストをクリックします。
収集されたすべてのメトリックを含むリモート・ホスト・ダッシュボードを表示できます。
構成データ
- OS (名前、バージョン、およびアーキテクチャー)
- CPU 数
- メモリーの合計
- ホスト名および FQDN
- ディスク容量
パフォーマンス・メトリック
- CPU 使用率 (%)
- CPU 負荷
- 使用メモリー
- 使用スワップ (Linux のみ)
- 使用済みディスク
- ネットワーク RX および TX バイト
問題の表示
Zabbix 問題は、 Instana に課題としてインポートされます。 問題を表示するには、以下の手順を実行します。
- Instana のUIにあるナビゲーションメニューから、 「イベント」 を選択します。
- 問題ではないイベントをフィルタリングするには、 「問題」 タブをクリックします。
- Zabbixからインポートされた問題をフィルタリングするには、検索ボックスに以下の照会を入力します。
entity.remote.host.source:Zabbix
Zabbixからインポートされた問題のリストを表示できます。 Zabbix の未解決の問題は、 Instana の課題として作成され、 Zabbix の問題が解決されるまで未解決のままとなります。 Zabbix の問題が解決されると、数分以内に Instana の問題も解決されます。
トラブルシューティング
エージェントの監視に関する問題
Zabbix センサーが Zabbix サーバーと通信できない場合は、エージェント・モニターの問題が発生します。 この問題は、正しくない構成パラメーターについて説明しています。 たとえば、 API トークンが正しくないか、有効期限が切れている場合、センサーは Zabbix サーバーから HTTP の401または403エラーを受信します。 以下の構成パラメーターが原因で、エージェント・モニターの問題が発生します。
endpointtoken( HTTP 401 または 403)poll_rate( HTTP 429)
エージェント OutOfMemoryError
多数のホストを監視する Zabbix サーバーに接続している場合、 Instana エージェントの JVM のヒープサイズを増やす必要があるかもしれません。 エージェントのログに OutOfMemoryError が見つかった場合は、 Instana エージェントの最大ヒープサイズを増やす必要があります。 環境 JAVA_OPTS 変数に関する詳細については、 「環境変数のリファレンス」 を参照してください。