ZABBIX API：高效監控的利器
ZABBIX是一款廣受歡迎的高效監控工具，它提供了一系列豐富的API接口，使得日常監控任務變得更加便捷。無論是查看信息、添加主機、應用監控模板，還是執行刪除操作，ZABBIX API都能助您一臂之力，尤其在進行大規模監控部署時，其快速、準確的特點尤為突出。
一、準備工作：ZABBIX API調用
本文將展示如何使用Python語言，結合HTTP客戶端庫，通過發送HTTP請求來實現ZABBIX API的各種功能。
首先，要訪問Zabbix的數據，您需要登錄并獲取一個身份認證token。這可以通過使用user.login方法來完成。以下是一個簡單的腳本示例：
[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)
執行腳本：
python3 zbxapi-create-hostgroup.py {hostgroup-name}
返回結果如下：
Response content: {"jsonrpc":"2.0","result":"cfeef2fbe1b680b773e930047448bab2","id":1}其中result的值就是id: 1對應的身份認證auth的值
二、常用API功能及使用方法
1.創建主機群組并獲取ID
創建一個新的主機群組，并獲取其ID是后續操作的關鍵步驟。以下是一個Python腳本示例，用于創建群組并打印返回的組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)執行腳本并傳入群組名稱作為參數，您將得到類似如下的響應：
{"jsonrpc":"2.0","result":"cfeef2fbe1b680b773e930047448bab2","id":1}其中，result字段的值即為新創建的主機群組ID。
在zabbix web頁面可以看到也是成功創建的主機群組并且groupid也都為21
獲取主機群組ID這一步是比較關鍵的，因為后續的創建模板，創建主機等，都需要用到groupid(主機群組ID)，當新創建時可以通過API創建獲取，個人也是比較喜歡，因為它可以創建的同時一并將ID也返回，如果是查詢之前的，則web頁面會方便一些，只需要鼠標放在對應位置即可，各有優勢。
2.創建監控模板
創建模板是配置監控項和觸發器的前提。以下是一個創建模板的腳本示例：
[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)
執行腳本：
python3 zbxapi-create-template.py {template-name} {groupid}
執行腳本并傳入模板名稱和所屬群組ID，您將能在Zabbix的Web界面中看到新創建的模板。
3.創建監控主機并加入指定組
創建主機并將其加入到指定的監控群組中，是實現監控的最終步驟。以下是一個創建主機的腳本示例：
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)
執行腳本：python3 zbx-host-create.py {hostname} {ip} {groupid} {templateid}
執行腳本并傳入主機名、IP地址、群組ID和模板ID，您將成功創建一個新的監控主機，并將其綁定到指定的群組和模板。
三、總結
通過ZABBIX API，我們可以高效地完成主機創建等日常監控任務。在面對大量服務器需要監控時，與傳統的Web界面操作相比，API提供了一種更加快速和自動化的解決方案。
此外，ZABBIX API還支持刪除操作、添加標簽、設置主機宏、創建監控大屏等眾多功能，極大地提升了我們使用ZABBIX的效率和深度。
對于更詳細的操作和功能，您可以參考ZABBIX官方API文檔：
ZABBIX API Documentation
如有相關問題，請在文章后面給小編留言，小編安排作者第一時間和您聯系，為您答疑解惑。
更多操作功能參考ZABBIX 官方API鏈接地址：
https://www.zabbix.com/documentation/current/zh/manual/api。
