Zabbix server/proxy deve essere inizialmente configurato con il supporto cURL (libcurl).

[1] Zabbix supporta file di certificato e chiave privata solo in formato PEM. Nel caso in cui tu abbia i dati del certificato e della chiave privata in un file in formato PKCS #12 (di solito con estensione *.p12 o *.pfx) puoi generare da esso il file PEM usando i seguenti comandi:

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

Esempi

Esempio 1

Invia semplici richieste GET per recuperare dati da servizi come Elasticsearch:

• Crea un item GET con URL: localhost:9200/?pretty
• Osserva la risposta:

    {
      "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" : "Sai, per la ricerca"
    }

• Ora estrai il numero di versione usando un passaggio di preprocessing JSONPath: $.version.number

Esempio 2

Invia semplici richieste POST per recuperare dati da servizi come Elasticsearch:

• Crea un item POST con URL: http://localhost:9200/str/values/_search?scroll=10s
• Configura il seguente corpo POST per ottenere il carico del processore (media di 1 minuto per core)

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

• Ricevuto:

    {
        "_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
                }
            }]
        }
    }

• Ora usa un passaggio di preprocessing JSONPath per ottenere il valore dell'item: $.hits.hits[0]._source.value

Esempio 3

Verifica se Zabbix API è attiva, usando apiinfo.version.

• Configurazione dell'item:

Si noti l'uso del metodo POST con dati JSON, l'impostazione delle intestazioni della richiesta e la richiesta di restituire solo le intestazioni:

• Pre-elaborazione del valore dell'item con espressione regolare per ottenere il codice HTTP:

• Verifica del risultato in Latest data:

Esempio 4

Recupero delle informazioni meteo collegandosi al servizio pubblico Openweathermap.

• Configurare un item master per la raccolta di dati in blocco in un singolo JSON:

Si noti l'uso delle macro nei campi di query. Fare riferimento alle Openweathermap API per sapere come compilarli.

Esempio di JSON restituito in risposta all'HTTP agent:

{
    "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
    }
}

Il passo successivo consiste nel configurare gli item dipendenti che estraggono i dati dal JSON.

• Configurare un item dipendente di esempio per l'umidità:

Altre metriche meteo, come 'Temperature', vengono aggiunte nello stesso modo.

• Esempio di preprocessing del valore di un item dipendente con JSONPath:

• Verificare il risultato dei dati meteo in Latest data:

Esempio 5

Connessione alla pagina di stato di Nginx e acquisizione delle sue metriche in blocco.

• Configurare Nginx seguendo la guida ufficiale.
• Configurare un item master per la raccolta dei dati in blocco:

Esempio di output stub status di Nginx:

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

Il passaggio successivo consiste nel configurare gli item dipendenti che estraggono i dati.

• Configurare un item dipendente di esempio per le richieste al secondo:

• Pre-elaborazione del valore di un item dipendente di esempio con espressione regolare server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+):

• Verificare il risultato completo del modulo stub in Latest data: