12 トラッパーアイテム

概要

トラッパーアイテムは、データを問い合わせる代わりに受信データを受け付けます。 これは、Zabbixに送信したい任意のデータに便利です。

設定

トラッパーアイテムを設定するには:

1. データ収集 → ホスト に移動します。
2. ホストの行で アイテム をクリックします。
3. アイテムの作成 をクリックします。
4. 設定フォームにアイテムのパラメータを入力します。

必須入力フィールドは赤いアスタリスクでマークされています。

トラッパーアイテムに特有の情報が必要なフィールドは次のとおりです。

データの送信

Zabbix senderユーティリティまたはZabbix senderプロトコルを使用して、Zabbixサーバーまたはプロキシにデータを送信することができます。 history.pushAPIメソッドを使用して、Zabbixサーバーにデータを送信することも可能です。

Zabbix sender

Zabbix senderユーティリティを使用してZabbixサーバーまたはプロキシにデータを送信するには、次のコマンドを実行して「test value」を送信できます。

zabbix_sender -z <server IP address> -p 10051 -s "New host" -k trap -o "test value"

「test value」を送信するために、次のコマンドオプションが使用されます。

• -z ZabbixサーバーのIPアドレスを指定
• -p Zabbixサーバーのポート番号を指定（デフォルトは10051）
• -s ホストを指定（表示名ではなく、必ず技術名を使用してください）
• -k トラッパーアイテムで設定されたアイテムキーを指定
• -o 送信する値を指定

Zabbix senderとZabbixサーバーまたはプロキシ間の通信の詳細については、Zabbix senderプロトコルを参照してください。

history.push

history.push APIメソッドを使用してZabbixサーバーにデータを送信するには、以下のようなテスト値を含むHTTP POSTリクエストを作成できます。

curl --request POST \
         --url 'https://example.com/zabbix/api_jsonrpc.php' \
         --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \
         --header 'Content-Type: application/json-rpc' \
         --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}'

リクエストが正しい場合、APIから返されるレスポンスは以下のようになります。

{
           "jsonrpc": "2.0",
           "result": {
               "response": "success",
               "data": [
                   {
                       "itemid": "10600"
                   },
                   {
                       "itemid": "10601",
                       "error": "Item is disabled."
                   },
                   {
                       "error": "No permissions to referred object or it does not exist."
                   }
               ]
           },
           "id": 1
       }

レスポンスデータ内のエラーは、特定のアイテムへのデータ送信がZabbixサーバーによる検証に失敗したことを示します。 これは以下の理由で発生する可能性があります。

• データを送信するユーザーがアイテムのホストに対する読み取り権限を持っていない
• ホストが無効化されている、またはデータ収集なしのメンテナンス中である
• アイテムが存在しない、またはまだサーバーの設定キャッシュに含まれていない
• アイテムが無効化されている、またはタイプがZabbixトラッパーまたはHTTPエージェント（トラッピング有効）以外である
• ユーザーのIPまたはDNSがアイテムの許可ホストリストに設定されていない
• 他のアイテムがナノ秒レベルでタイムスタンプが重複する値を持っている

エラーがない場合は、送信された値が処理のために受け入れられたことを示します。これには（存在する場合）前処理、トリガー処理、データベースへの保存が含まれます。 受け入れられた値の処理も失敗する場合があることに注意してください（たとえば、前処理中など）。その場合、値は破棄されます。

Zabbix APIの操作方法の詳細については、APIを参照してください。

データの表示

データが送信されたら、監視データ → 最新データに移動して結果を確認できます。