ZABBIX API:高效監(jiān)控的利器
ZABBIX是一款廣受歡迎的高效監(jiān)控工具,它提供了一系列豐富的API接口,使得日常監(jiān)控任務(wù)變得更加便捷。無論是查看信息、添加主機(jī)、應(yīng)用監(jiān)控模板,還是執(zhí)行刪除操作,ZABBIX API都能助您一臂之力,尤其在進(jìn)行大規(guī)模監(jiān)控部署時(shí),其快速、準(zhǔn)確的特點(diǎn)尤為突出。
一、準(zhǔn)備工作:ZABBIX API調(diào)用
本文將展示如何使用Python語言,結(jié)合HTTP客戶端庫,通過發(fā)送HTTP請求來實(shí)現(xiàn)ZABBIX API的各種功能。
首先,要訪問Zabbix的數(shù)據(jù),您需要登錄并獲取一個(gè)身份認(rèn)證token。這可以通過使用user.login
方法來完成。以下是一個(gè)簡單的腳本示例:
[root@zbx-server]# vim zbxapi-create-hostgroup.py
# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x(IP)/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
"jsonrpc": "2.0",
"method": "user.login",
"params": {
"user": "Admin",
"password": "zabbix",
},
"id": 0,
}
response = requests.post(url, headers=post_headers, data=json.dumps(post_data))
print("Response content:", response.text)
執(zhí)行腳本:
python3 zbxapi-create-hostgroup.py {hostgroup-name}
返回結(jié)果如下:
Response content: {"jsonrpc":"2.0","result":"cfeef2fbe1b680b773e930047448bab2","id":1}
其中result的值就是id: 1對應(yīng)的身份認(rèn)證auth的值
二、常用API功能及使用方法
1.創(chuàng)建主機(jī)群組并獲取ID
創(chuàng)建一個(gè)新的主機(jī)群組,并獲取其ID是后續(xù)操作的關(guān)鍵步驟。以下是一個(gè)Python腳本示例,用于創(chuàng)建群組并打印返回的組ID:
# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
"jsonrpc": "2.0",
"method": "hostgroup.create",
"params": {
"name": sys.argv[1],
},
"id": "1",
"auth": "xxxxxxxxxxxxxxxxxxxxxx",
}
response = requests.post(url, headers=post_headers, data=json.dumps(post_data))
print("Response status code:", response.status_code)
print("Response content:", response.text)
執(zhí)行腳本并傳入群組名稱作為參數(shù),您將得到類似如下的響應(yīng):
{"jsonrpc":"2.0","result":"cfeef2fbe1b680b773e930047448bab2","id":1}
其中,result字段的值即為新創(chuàng)建的主機(jī)群組ID。
在zabbix web頁面可以看到也是成功創(chuàng)建的主機(jī)群組并且groupid也都為21
獲取主機(jī)群組ID這一步是比較關(guān)鍵的,因?yàn)楹罄m(xù)的創(chuàng)建模板,創(chuàng)建主機(jī)等,都需要用到groupid(主機(jī)群組ID),當(dāng)新創(chuàng)建時(shí)可以通過API創(chuàng)建獲取,個(gè)人也是比較喜歡,因?yàn)樗梢詣?chuàng)建的同時(shí)一并將ID也返回,如果是查詢之前的,則web頁面會(huì)方便一些,只需要鼠標(biāo)放在對應(yīng)位置即可,各有優(yōu)勢。
2.創(chuàng)建監(jiān)控模板
創(chuàng)建模板是配置監(jiān)控項(xiàng)和觸發(fā)器的前提。以下是一個(gè)創(chuàng)建模板的腳本示例:
[root@zbx-server]# vim zbxapi-create-template.py
# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
"jsonrpc": "2.0",
"method": "template.create",
"params": {
"host": sys.argv[1],
"groups": {
"groupid": sys.argv[2]
},
},
"id": "1",
"auth": "xxxxxxxxxxxxxxxxxxxxxx",
}
response = requests.post(url, headers=post_headers, data=json.dumps(post_data))
print("Response status code:", response.status_code)
print("Response content:", response.text)
執(zhí)行腳本:
python3 zbxapi-create-template.py {template-name} {groupid}
執(zhí)行腳本并傳入模板名稱和所屬群組ID,您將能在Zabbix的Web界面中看到新創(chuàng)建的模板。
3.創(chuàng)建監(jiān)控主機(jī)并加入指定組
創(chuàng)建主機(jī)并將其加入到指定的監(jiān)控群組中,是實(shí)現(xiàn)監(jiān)控的最終步驟。以下是一個(gè)創(chuàng)建主機(jī)的腳本示例:
vim zbx-host-create.py
# -*- coding:utf-8 -*-
import requests
import json
import sys
url = 'http://x.x.x.x/api_jsonrpc.php'
post_headers = {'Content-Type': 'application/json'}
post_data = {
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": sys.argv[1],
"interfaces": [
{
"type": 1,
"main": 1,
"useip": 1,
"ip": sys.argv[2],
"dns": "",
"port": "10050"
}
],
"groups": [
{
"groupid": sys.argv[3],
}
],
"templates": [
{
"templateid": sys.argv[4],
}
],
"inventory_mode": 0,
"inventory": {
"macaddress_a": "01234",
"macaddress_b": "56768"
}
},
"id": 1,
"auth": "xxxxxxxxxxxxxxxxxxxxxx",
}
response = requests.post(url, headers=post_headers, data=json.dumps(post_data))
print("Response status code:", response.status_code)
print("Response content:", response.text)
執(zhí)行腳本:python3 zbx-host-create.py {hostname} {ip} {groupid} {templateid}
執(zhí)行腳本并傳入主機(jī)名、IP地址、群組ID和模板ID,您將成功創(chuàng)建一個(gè)新的監(jiān)控主機(jī),并將其綁定到指定的群組和模板。
三、總結(jié)
通過ZABBIX API,我們可以高效地完成主機(jī)創(chuàng)建等日常監(jiān)控任務(wù)。在面對大量服務(wù)器需要監(jiān)控時(shí),與傳統(tǒng)的Web界面操作相比,API提供了一種更加快速和自動(dòng)化的解決方案。
此外,ZABBIX API還支持刪除操作、添加標(biāo)簽、設(shè)置主機(jī)宏、創(chuàng)建監(jiān)控大屏等眾多功能,極大地提升了我們使用ZABBIX的效率和深度。
對于更詳細(xì)的操作和功能,您可以參考ZABBIX官方API文檔:
ZABBIX API Documentation
如有相關(guān)問題,請?jiān)谖恼潞竺娼o小編留言,小編安排作者第一時(shí)間和您聯(lián)系,為您答疑解惑。
更多操作功能參考ZABBIX 官方API鏈接地址:
https://www.zabbix.com/documentation/current/zh/manual/api。