Zabbix サーバー/プロキシは、あらかじめ cURL（libcurl）サポート付きで設定されている必要があります。

[1] Zabbix は PEM 形式の証明書ファイルと秘密鍵ファイルのみをサポートします。証明書と秘密鍵のデータが PKCS #12 形式のファイル（通常は拡張子 *.p12 または *.pfx）にある場合は、次のコマンドを使用して PEM ファイルを生成できます:

openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem
openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes  -out ssl-cert.key

例

例1

Elasticsearch などのサービスからデータを取得するための、シンプルな GET リクエストを送信します。

• URL: localhost:9200/?pretty で GET アイテムを作成します
• レスポンスを確認します。

    {
      "name" : "YQ2VAY-",
      "cluster_name" : "elasticsearch",
      "cluster_uuid" : "kH4CYqh5QfqgeTsjh2F9zg",
      "version" : {
        "number" : "6.1.3",
        "build_hash" : "af51318",
        "build_date" : "2018-01-26T18:22:55.523Z",
        "build_snapshot" : false,
        "lucene_version" : "7.1.0",
        "minimum_wire_compatibility_version" : "5.6.0",
        "minimum_index_compatibility_version" : "5.0.0"
      },
      "tagline" : "You know, for search"
    }

• 次に、JSONPath の前処理ステップを使用してバージョン番号を抽出します: $.version.number

例2

Elasticsearch などのサービスからデータを取得するために、シンプルなPOSTリクエストを送信します。

• 次のURLでPOSTアイテムを作成します: http://localhost:9200/str/values/_search?scroll=10s
• プロセッサー負荷（コアごとの1分平均）を取得するには、次のPOSTボディを設定します

    {
        "query": {
            "bool": {
                "must": [{
                    "match": {
                        "itemid": 28275
                    }
                }],
                "filter": [{
                    "range": {
                        "clock": {
                            "gt": 1517565836,
                            "lte": 1517566137
                        }
                    }
                }]
            }
        }
    }

• 受信結果:

    {
        "_scroll_id": "DnF1ZXJ5VGhlbkZldGNoBQAAAAAAAAAkFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAJRZZUTJWQVktVFNacU5nRHhlcEI0QUxRAAAAAAAAACYWWVEyVkFZLVRTWnFOZ0R4ZXBCNEFMUQAAAAAAAAAnFllRMlZBWS1UU1pxTmdEeGVwQjRBTFEAAAAAAAAAKBZZUTJWQVktVFNacU5nRHhlcEI0QUxR",
        "took": 18,
        "timed_out": false,
        "_shards": {
            "total": 5,
            "successful": 5,
            "skipped": 0,
            "failed": 0
        },
        "hits": {
            "total": 1,
            "max_score": 1.0,
            "hits": [{
                "_index": "dbl",
                "_type": "values",
                "_id": "dqX9VWEBV6sEKSMyk6sw",
                "_score": 1.0,
                "_source": {
                    "itemid": 28275,
                    "value": "0.138750",
                    "clock": 1517566136,
                    "ns": 25388713,
                    "ttl": 604800
                }
            }]
        }
    }

• 次に、JSONPathの前処理ステップを使用してアイテムの値を取得します: $.hits.hits[0]._source.value

例3

apiinfo.version を使用して、 Zabbix API が稼働しているかどうかを確認します。

• アイテムの設定:

JSON データを使用する POST メソッドを使用し、リクエストヘッダーを設定して、 ヘッダーのみを返すように要求している点に注意してください。

• HTTP コードを取得するための正規表現によるアイテム値の前処理:

• 最新データ で結果を確認:

例4

Openweathermap の公開サービスに接続して天気情報を取得します。

• 単一のJSONでデータを一括収集するためのマスターアイテムを設定します。

クエリフィールドでマクロが使用されている点に注意してください。これらの入力方法については、Openweathermap API を参照してください。

HTTPエージェントへの応答として返されるJSONの例:

{
    "body": {
        "coord": {
            "lon": 40.01,
            "lat": 56.11
        },
        "weather": [{
            "id": 801,
            "main": "Clouds",
            "description": "few clouds",
            "icon": "02n"
        }],
        "base": "stations",
        "main": {
            "temp": 15.14,
            "pressure": 1012.6,
            "humidity": 66,
            "temp_min": 15.14,
            "temp_max": 15.14,
            "sea_level": 1030.91,
            "grnd_level": 1012.6
        },
        "wind": {
            "speed": 1.86,
            "deg": 246.001
        },
        "clouds": {
            "all": 20
        },
        "dt": 1526509427,
        "sys": {
            "message": 0.0035,
            "country": "RU",
            "sunrise": 1526432608,
            "sunset": 1526491828
        },
        "id": 487837,
        "name": "Stavrovo",
        "cod": 200
    }
}

次の作業は、このJSONからデータを抽出する依存アイテムを設定することです。

• 湿度用の依存アイテムの設定例:

「Temperature」などの他の気象指標も同様の方法で追加します。

• JSONPath を使用した依存アイテムの値の前処理例:

• 最新データ で天気データの結果を確認します。

例 5

Nginx のステータスページに接続し、そのメトリクスを一括で取得します。

• 公式ガイドに従って Nginx を設定します。
• 一括データ収集用のマスターアイテムを設定します。

Nginx stub status の出力例:

Active connections: 1 Active connections:
server accepts handled requests
 52 52 52 
Reading: 0 Writing: 1 Waiting: 0

次のタスクは、データを抽出する依存アイテムを設定することです。

• 1 秒あたりのリクエスト数の依存アイテムの例を設定します。

• 正規表現 server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+) を使用した依存アイテムの値の前処理例:

• 最新データ で stub モジュールの完全な結果を確認します。