12 トラッパーアイテム

概要

Trapper item は、問合せの代わりに受信データを受け取ります。

Zabbixに "プッシュ" したいデータに対して有効です。

Trapper item を使用するには、以下が必要です。

• Zabbixに Trapper item が設定されていること
• Zabbixにデータを送信すること

アイテム設定

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

• 設定 → ホスト にアクセスします。
• ホストの行の アイテム をクリックします。
• アイテムの作成 をクリックします。
• item のパラメータをフォームに入力します。

すべての必須入力項目には赤いアスタリスクが付けられています。

トラッパーアイテム で特定の情報を必要とするフィールドは、次のとおりです。

データの送信

Zabbixサーバーまたはプロキシへのデータ送信は、Zabbix senderユーティリティまたはZabbix sender プロトコルを使用して行うことができます。 Zabbixサーバーへのデータ送信は、history.push APIメソッドを使用して行うこともできます。

データの送信

最も単純なケースでは、zabbix_senderユーティリティを使用して
'テスト値'を送信することができま す。

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

値を送信するには、これらのキーを使用します。

-z - ZabbixサーバのIPアドレスを指定します

-p - Zabbixサーバのポート番号を指定します(デフォルトは10051)

-s - ホストを指定します (ここでは 'visible' な名前ではなく、必ず 'technical' host name を使ってください)

-k - 定義した item のキーを指定します

-o - 実際に送信する値を指定します

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を参照してください。

表示

Monitoring → Latest data での結果です。

なお、単一の数値が送られた場合、データグラフにはその数値の時点の左と右に横線が表示されます。