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。
