12 トラッパーアイテム

概要

トラッパーアイテムは、データを問い合わせる代わりに、受信したデータを受け付けます。
これは、Zabbix に送信したいあらゆるデータに役立ちます。

設定

トラッパーアイテムを設定するには、以下の手順を実行します。

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

必須の入力フィールドには、赤いアスタリスクが付いています。

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

データの送信

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

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

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 → 最新データ に移動して結果を確認できます。