新钛云服已累计为您分享794篇技术干货
ZABBIX是一款广受欢迎的高效监控工具,它提供了一系列丰富的API接口,使得日常监控任务变得更加便捷。无论是查看信息、添加主机、应用监控模板,还是执行删除操作,ZABBIX API都能助您一臂之力,尤其在进行大规模监控部署时,其快速、准确的特点尤为突出。
01
准备工作: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的值
02
常用API功能及使用方法
01
创建主机群组并获取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页面会方便一些,只需要鼠标放在对应位置即可,各有优势。
02
创建监控模板
创建模板是配置监控项和触发器的前提。以下是一个创建模板的脚本示例:
[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界面中看到新创建的模板。
03
创建监控主机并加入指定组
创建主机并将其加入到指定的监控群组中,是实现监控的最终步骤。以下是一个创建主机的脚本示例:
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,您将成功创建一个新的监控主机,并将其绑定到指定的群组和模板。
03
总 结
通过ZABBIX API,我们可以高效地完成主机创建等日常监控任务。在面对大量服务器需要监控时,与传统的Web界面操作相比,API提供了一种更加快速和自动化的解决方案。
此外,ZABBIX API还支持删除操作、添加标签、设置主机宏、创建监控大屏等众多功能,极大地提升了我们使用ZABBIX的效率和深度。
对于更详细的操作和功能,您可以参考ZABBIX官方API文档:
ZABBIX API Documentation
如有相关问题,请在文章后面给小编留言,小编安排作者第一时间和您联系,为您答疑解惑。
更多操作功能参考ZABBIX 官方API链接地址:
https://www.zabbix.com/documentation/current/zh/manual/api
推荐阅读
推荐视频