Šis vienuma tips ļauj veikt datu aptauju, izmantojot HTTP/HTTPS protokolu. Ir iespējama arī datu nosūtīšana, izmantojot Zabbix sender utilītu vai Zabbix sender protokolu (datu nosūtīšanai uz Zabbix serveris vai starpniekserveris), vai izmantojot history.push API metodi (datu nosūtīšanai uz Zabbix serveris).

HTTP vienuma pārbaudes izpilda Zabbix serveris. Tomēr, ja hosts tiek uzraudzīti ar Zabbix starpniekserveri, HTTP vienuma pārbaudes izpilda starpniekserveris.

HTTP vienuma pārbaudēm nav nepieciešams, lai uz uzraudzītā hosta darbotos kāds aģents.

HTTP aģents atbalsta gan HTTP, gan HTTPS. Zabbix pēc izvēles sekos pāradresācijām (skatiet tālāk opciju Sekot pāradresācijām). Maksimālais pāradresāciju skaits ir fiksēts uz 10 (izmantojot cURL opciju CURLOPT_MAXREDIRS).

Zabbix serveris/starpniekserveris sākotnēji ir jākonfigurē ar cURL (libcurl) atbalstu.

HTTP pārbaudes tiek izpildītas asinhroni - nav nepieciešams saņemt viena pieprasījuma atbildi, pirms tiek sāktas citas pārbaudes. Arī DNS atrisināšana ir asinhrona.

Asinhrono pārbaužu maksimālais paralēlais skaits ir 1000 (definēts ar MaxConcurrentChecksPerPoller).

Asinhrono HTTP aģenta aptaujātāju skaits ir definēts ar parametru StartHTTPAgentPollers.

Pastāvīgo savienojumu cURL funkcionalitāte HTTP aģenta pārbaudēm ir pievienota kopš Zabbix 7.0.

Konfigurēšana

Lai konfigurētu HTTP vienumu:

Atveriet Data collection > Hosts.
Hosts rindā noklikšķiniet uz Items.
Noklikšķiniet uz Create item.
Veidlapā ievadiet vienuma parametrus.

Visi obligātie ievades lauki ir atzīmēti ar sarkanu zvaigznīti.

Lauki, kuriem HTTP vienumiem nepieciešama specifiska informācija, ir šādi:

Parametrs	Apraksts
Type	Šeit atlasiet HTTP agent.
Key	Ievadiet unikālu vienuma atslēgu.
URL	URL, ar kuru izveidot savienojumu un izgūt datus. Piemēram: `https://www.example.com` `http://www.example.com/download` Domēna nosaukumus var norādīt Unicode rakstzīmēs. Izpildot HTTP pārbaudi, tie tiek automātiski pārveidoti par ASCII punycode formātu. Pogu Parse var izmantot, lai no URL atdalītu neobligātos vaicājuma laukus (piemēram, `?key=value&limit=10`), pārvietojot atribūtus un vērtības uz Query fields, lai veiktu automātisku URL kodēšanu. Drošības apsvērumu dēļ URL neiekļaujiet faktiskos lietotājvārdus vai paroles. Tā vietā izmantojiet lietotāja makro, lai nepieļautu akreditācijas datu atklāšanu. Ierobežots līdz 2048 rakstzīmēm. Atbalstītie makro: `{HOST.IP}`, `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.HOST}`, `{HOST.NAME}`, `{HOST.PORT}`, `{ITEM.ID}`, `{ITEM.KEY}`, `{ITEM.KEY.ORIG}`, lietotāja makro, zema līmeņa atklāšanas makro. Tiek iestatīta cURL opcija `CURLOPT_URL`.
Query fields	URL mainīgie (skatiet iepriekš). Norādīti kā atribūtu un vērtību pāri. Vērtības tiek automātiski kodētas URL formātā. Makro vērtības tiek atrisinātas un pēc tam automātiski kodētas URL formātā. Atbalstītie makro: `{HOST.IP}`, `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.HOST}`, `{HOST.NAME}`, `{ITEM.ID}`, `{ITEM.KEY}`, `{ITEM.KEY.ORIG}`, lietotāja makro, zema līmeņa atklāšanas makro. Tiek iestatīta cURL opcija `CURLOPT_URL`.
Request type	Atlasiet pieprasījuma metodes tipu: GET, POST, PUT vai HEAD.
Request body type	Atlasiet pieprasījuma pamatteksta tipu: Raw data - pielāgots HTTP pieprasījuma pamatteksts; makro tiek aizstāti, bet kodēšana netiek veikta JSON data - HTTP pieprasījuma pamatteksts JSON formātā. Makro var izmantot kā virkni, skaitli, true un false; makro, kas izmantoti kā virknes, jāiekļauj dubultpēdiņās. Makro vērtības tiek atrisinātas un pēc tam automātiski aizbēgtas. Ja galvenēs nav norādīts "Content-Type", pēc noklusējuma tiks izmantots "Content-Type: application/json" XML data - HTTP pieprasījuma pamatteksts XML formātā. Makro var izmantot kā teksta mezglu, atribūtu vai CDATA sadaļu. Makro vērtības teksta mezglā un atribūtā tiek atrisinātas un pēc tam automātiski aizbēgtas. Ja galvenēs nav norādīts "Content-Type", pēc noklusējuma tiks izmantots "Content-Type: application/xml" Ņemiet vērā, ka, atlasot XML data, ir nepieciešama libxml2.
Request body	Ievadiet pieprasījuma pamattekstu. Atbalstītie makro: `{HOST.IP}`, `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.HOST}`, `{HOST.NAME}`, `{ITEM.ID}`, `{ITEM.KEY}`, `{ITEM.KEY.ORIG}`, lietotāja makro, zema līmeņa atklāšanas makro.
Headers	Pielāgotas HTTP galvenes, kas tiks nosūtītas, izpildot pieprasījumu. Norādītas kā atribūtu un vērtību pāri. Atbalstītie makro: `{HOST.IP}`, `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.HOST}`, `{HOST.NAME}`, `{ITEM.ID}`, `{ITEM.KEY}`, `{ITEM.KEY.ORIG}`, lietotāja makro, zema līmeņa atklāšanas makro. Tiek iestatīta cURL opcija `CURLOPT_HTTPHEADER`.
Required status codes	Sagaidāmo HTTP statusa kodu saraksts. Ja Zabbix saņem kodu, kas nav iekļauts sarakstā, vienums kļūs neatbalstīts. Ja lauks ir tukšs, pārbaude netiek veikta. Piemēram: 200,201,210-299 Sarakstā atbalstītie makro: lietotāja makro, zema līmeņa atklāšanas makro. Tiek izmantota cURL opcija `CURLINFO_RESPONSE_CODE`.
Follow redirects	Atzīmējiet izvēles rūtiņu, lai sekotu HTTP novirzēm. Tiek iestatīta cURL opcija `CURLOPT_FOLLOWLOCATION`.
Retrieve mode	Atlasiet izgūstamo atbildes daļu: Body - tikai pamatteksts Headers - tikai galvenes Body and headers - pamatteksts un galvenes.
Convert to JSON	Ja Retrieve mode nav iestatīts uz Body, galvenes tiek saglabātas kā atribūtu un vērtību pāri zem atslēgas "header". Ja tiek atrasts 'Content-Type: application/json', pamatteksts tiek saglabāts kā objekts; pretējā gadījumā tas tiek saglabāts kā virkne, piemēram:
HTTP proxy	Varat norādīt izmantojamo HTTP starpniekserveri, izmantojot formātu `[protocol://][username[:password]@]proxy.example.com[:port]`. Neobligāto prefiksu `protocol://` var izmantot, lai norādītu alternatīvus starpniekservera protokolus (piemēram, `https`, `socks4`, `socks5`; skatiet dokumentāciju; protokola prefiksa atbalsts tika pievienots cURL 7.21.7). Ja protokols nav norādīts, starpniekserveris tiks uzskatīts par HTTP starpniekserveri. Ja norādīts nepareizs protokols, savienojums neizdosies un vienums kļūs neatbalstīts. Pēc noklusējuma tiks izmantots ports `1080`. Ja starpniekserveris ir norādīts, tas aizstās ar starpniekserveri saistītos vides mainīgos, piemēram, `http_proxy`, `HTTPS_PROXY`. Ja starpniekserveris nav norādīts, ar starpniekserveri saistītie vides mainīgie netiks pārrakstīti. Ievadītā vērtība tiek nodota "kā ir", neveicot tās pārbaudi. Ņemiet vērā, ka HTTP starpniekserverim tiek atbalstīta tikai vienkāršā autentifikācija. Atbalstītie makro: `{HOST.IP}`, `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.HOST}`, `{HOST.NAME}`, `{ITEM.ID}`, `{ITEM.KEY}`, `{ITEM.KEY.ORIG}`, lietotāja makro, zema līmeņa atklāšanas makro. Tiek iestatīta cURL opcija `CURLOPT_PROXY`.
HTTP authentication	Atlasiet autentifikācijas opciju: None - autentifikācija netiek izmantota; Basic - tiek izmantota pamata autentifikācija; NTLM - tiek izmantota NTLM (Windows NT LAN Manager) autentifikācija; Kerberos - tiek izmantota Kerberos autentifikācija (skatiet arī: Kerberos konfigurēšana ar Zabbix); Digest - tiek izmantota Digest autentifikācija. Tiek iestatīta cURL opcija `CURLOPT_HTTPAUTH`.
User name	Ievadiet lietotājvārdu (līdz 255 rakstzīmēm). Šis lauks ir pieejams, ja HTTP authentication ir iestatīts uz Basic, NTLM, Kerberos vai Digest. Tiek atbalstīti lietotāja makro un zema līmeņa atklāšanas makro.
Password	Ievadiet lietotāja paroli (līdz 255 rakstzīmēm). Šis lauks ir pieejams, ja HTTP authentication ir iestatīts uz Basic, NTLM, Kerberos vai Digest. Tiek atbalstīti lietotāja makro un zema līmeņa atklāšanas makro.
SSL verify peer	Atzīmējiet izvēles rūtiņu, lai pārbaudītu tīmekļa servera SSL sertifikātu. Servera sertifikāts tiek pārbaudīts pret uzticamo sertificēšanas iestāžu (CA) sertifikātiem, kas atrodas sistēmas CA atrašanās vietā. CA failu atrašanās vietu var mainīt, izmantojot Zabbix servera vai starpniekservera konfigurācijas parametru `SSLCALocation`. Tiek iestatīta cURL opcija `CURLOPT_SSL_VERIFYPEER`.
SSL verify host	Atzīmējiet izvēles rūtiņu, lai pārbaudītu, vai tīmekļa servera sertifikāta lauks Common Name vai Subject Alternate Name atbilst. Tiek iestatīta cURL opcija `CURLOPT_SSL_VERIFYHOST`.
SSL certificate file	Klienta autentifikācijai izmantotā SSL sertifikāta faila nosaukums. Sertifikāta failam jābūt PEM¹ formātā. Ja sertifikāta fails satur arī privāto atslēgu, atstājiet lauku SSL key file tukšu. Ja atslēga ir šifrēta, laukā SSL key password norādiet paroli. Direktoriju, kurā atrodas šis fails, norāda Zabbix servera vai starpniekservera konfigurācijas parametrs `SSLCertLocation`. Atbalstītie makro: `{HOST.IP}`, `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.HOST}`, `{HOST.NAME}`, `{ITEM.ID}`, `{ITEM.KEY}`, `{ITEM.KEY.ORIG}`, lietotāja makro, zema līmeņa atklāšanas makro. Tiek iestatīta cURL opcija `CURLOPT_SSLCERT`.
SSL key file	Klienta autentifikācijai izmantotā SSL privātās atslēgas faila nosaukums. Privātās atslēgas failam jābūt PEM¹ formātā. Direktoriju, kurā atrodas šis fails, norāda Zabbix servera vai starpniekservera konfigurācijas parametrs `SSLKeyLocation`. Atbalstītie makro: `{HOST.IP}`, `{HOST.CONN}`, `{HOST.DNS}`, `{HOST.HOST}`, `{HOST.NAME}`, `{ITEM.ID}`, `{ITEM.KEY}`, `{ITEM.KEY.ORIG}`, lietotāja makro, zema līmeņa atklāšanas makro. Tiek iestatīta cURL opcija `CURLOPT_SSLKEY`.
SSL key password	SSL privātās atslēgas faila parole. Atbalstītie makro: lietotāja makro, zema līmeņa atklāšanas makro. Tiek iestatīta cURL opcija `CURLOPT_KEYPASSWD`.
Timeout	Zabbix URL apstrādei nepatērēs vairāk par iestatīto laiku (1-600 sekundes). Faktiski šis parametrs nosaka maksimālo laiku savienojuma izveidei ar URL un maksimālo laiku HTTP pieprasījuma izpildei. Tāpēc Zabbix vienai pārbaudei nepatērēs vairāk par 2 x Timeout sekundēm. Tiek iestatīta cURL opcija `CURLOPT_TIMEOUT`. Papildinformāciju par parametru Timeout skatiet vispārīgajos vienuma atribūtos.
Enable trapping	Ja šī izvēles rūtiņa ir atzīmēta, vienums darbosies arī kā trapper vienums un pieņems datus, kas nosūtīti Zabbix serverim vai starpniekserverim, izmantojot utilītu Zabbix sender vai Zabbix sender protokolu, kā arī pieņems datus, kas nosūtīti Zabbix serverim, izmantojot API metodi `history.push`. Papildinformāciju par datu nosūtīšanu skatiet: Trapper vienumi.
Allowed hosts	Redzams tikai tad, ja ir atzīmēta izvēles rūtiņa Enable trapping. Ar komatiem atdalīts IP adrešu saraksts, pēc izvēles CIDR apzīmējumā, vai DNS nosaukumi. Ja norādīts, ienākošie savienojumi tiks pieņemti tikai no šeit uzskaitītajiem hosts. Ja IPv6 atbalsts ir iespējots, `127.0.0.1`, `::127.0.0.1`, `::ffff:127.0.0.1` tiek uzskatītas par līdzvērtīgām, un `::/0` ļaus izmantot jebkuru IPv4 vai IPv6 adresi. `0.0.0.0/0` var izmantot, lai atļautu jebkuru IPv4 adresi. Ņemiet vērā, ka "IPv4-compatible IPv6 addresses" (`0000::/96` prefikss) tiek atbalstītas, taču RFC4291 tās ir novecojušas. Piemērs: `127.0.0.1`, `192.168.1.0/24`, `192.168.3.1-255`, `192.168.1-10.1-255`, `::1,2001:db8::/32`, `mysqlserver1`, `zabbix.example.com`, `{HOST.HOST}` Šajā laukā ir atļautas atstarpes un lietotāja makro. Šajā laukā ir atļauti hosts makro: `{HOST.HOST}`, `{HOST.NAME}`, `{HOST.IP}`, `{HOST.DNS}`, `{HOST.CONN}`.

Ja lauks HTTP proxy ir atstāts tukšs, cits veids, kā izmantot HTTP starpniekserveri, ir iestatīt ar starpniekserveri saistītos vides mainīgos.

HTTP gadījumā iestatiet http_proxy vides mainīgo Zabbix servera lietotājam. Piemēram:
http_proxy=http://proxy_ip:proxy_port.

HTTPS gadījumā iestatiet HTTPS_PROXY vides mainīgo. Piemēram:
HTTPS_PROXY=http://proxy_ip:proxy_port. Papildinformāciju var iegūt, izpildot čaulas komandu: # man curl.

[1] Zabbix atbalsta tikai sertifikātu un privāto atslēgu failus PEM formātā. Ja sertifikāta un privātās atslēgas dati atrodas PKCS #12 formāta failā (parasti ar paplašinājumu *.p12 vai *.pfx), PEM failu no tā varat ģenerēt, izmantojot šādas komandas:

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

Piemēri

Piemērs 1

Nosūtiet vienkāršus GET pieprasījumus, lai izgūtu datus no tādiem pakalpojumiem kā Elasticsearch:

Izveidojiet GET vienumu ar URL: localhost:9200/?pretty
Pievērsiet uzmanību atbildei:

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

Tagad izvelciet versijas numuru, izmantojot JSONPath priekšapstrādes soli: $.version.number

Piemērs 2

Nosūtiet vienkāršus POST pieprasījumus, lai izgūtu datus no tādiem pakalpojumiem kā Elasticsearch:

Izveidojiet POST vienumu ar URL: http://localhost:9200/str/values/_search?scroll=10s
Konfigurējiet šādu POST body, lai iegūtu procesora noslodzi (1 minūtes vidējais rādītājs uz kodolu)

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

Saņemts:

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

Tagad izmantojiet JSONPath priekšapstrādes soli, lai iegūtu vienuma vērtību: $.hits.hits[0]._source.value

Piemērs 3

Pārbauda, vai Zabbix API ir aktīvs, izmantojot apiinfo.version.

Vienuma konfigurācija:

Ņemiet vērā POST metodes izmantošanu ar JSON datiem, iestatot pieprasījuma galvenes un pieprasot atgriezt tikai galvenes:

Vienuma vērtības pirmapstrāde ar regulāro izteiksmi, lai iegūtu HTTP kodu:

Rezultāta pārbaude sadaļā Latest data:

Piemērs 4

Laikapstākļu informācijas iegūšana, pieslēdzoties Openweathermap publiskajam servisam.

Konfigurējiet galveno vienumu masveida datu apkopošanai vienā JSON:

Ņemiet vērā makro izmantošanu vaicājuma laukos. Skatiet Openweathermap API, lai uzzinātu, kā tos aizpildīt.

Parauga JSON, kas atgriezts HTTP aģenta atbildē:

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

Nākamais uzdevums ir konfigurēt atkarīgos vienumus, kas izgūst datus no JSON.

Konfigurējiet parauga atkarīgo vienumu mitrumam:

Citi laikapstākļu rādītāji, piemēram, "Temperature", tiek pievienoti tādā pašā veidā.

Parauga atkarīgā vienuma vērtības pirmapstrāde ar JSONPath:

Pārbaudiet laikapstākļu datu rezultātu sadaļā Latest data:

Piemērs 5

Savienošana ar Nginx statusa lapu un tās metrikas iegūšana masveidā.

Konfigurējiet Nginx, ievērojot oficiālo rokasgrāmatu.
Konfigurējiet galveno vienumu masveida datu vākšanai:

Nginx stub statusa izvades paraugs:

Aktīvie savienojumi: 1 Aktīvie savienojumi:
server accepts handled requests
 52 52 52 
Lasīšana: 0 Rakstīšana: 1 Gaida: 0

Nākamais uzdevums ir konfigurēt atkarīgos vienumus, kas izgūst datus.

Konfigurējiet atkarīgā vienuma paraugu pieprasījumiem sekundē:

Atkarīgā vienuma vērtības priekšapstrādes paraugs ar regulāro izteiksmi server accepts handled requests\s+([0-9]+) ([0-9]+) ([0-9]+):

Pārbaudiet pilno rezultātu no stub moduļa sadaļā Jaunākie dati:

Kas tālāk?

1 Prometheus pārbaude

Docs

9 HTTP aģents

Pārskats