Zabbix API允许以编程方式检索和修改Zabbix的配置,并提供对历史数据的访问。它广泛用于:
-
创建新的应用程序以使用Zabbix;
-
将Zabbix与第三方软件集成;
-
自动执行常规任务。
Zabbix API提供两项主要功能:
- 远程管理Zabbix配置
- 远程检索配置和历史数据
Zabbix API是基于Web的API,作为Web前端的一部分提供。它使用JSON-RPC 2.0协议,这意味着两件事:
-
该API包含一组独立的方法;
-
客户端和API之间的请求和响应使用JSON格式进行编码。
大多数API至少包含四种方法: get
, create
, update
和 delete
,分别是检索,创建,更新和删除数据,但是某些API提供一套完全不同的一组方法。
具体部署
注意:停用自动发现、自动注册
1、获得身份验证令牌(user.login
方法)
[root@zabbix-server ~]# vim zabbix-api
curl -s -XPOST -H "Content-Type:application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "user.login",
"params": {
"user": "Admin",
"password": "zabbix"
},
"id": 1,
"auth": null
}' http://172.25.81.11/zabbix/api_jsonrpc.php | python -m json.tool[root@zabbix-server ~]# chmod +x zabbix-api
执行脚本,获取令牌
2.获取监控主机的信息(host.get
方法)
现在,我们有一个有效的用户认证令牌,可以用来访问Zabbix中的数据。例如,让我们使用host.get方法检索所有配置主机的ID、主机名和接口:
[root@zabbix-server ~]# vim zabbix-api
curl -s -XPOST -H "Content-Type:application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output":[
"host",
"host"
],
"selectInterfaces": [
"interfaceid",
"ip"
]
},
"id": 1,
"auth": "0fe85342817ef1a1e118d443f3b36867"
}' http://172.25.81.11/zabbix/api_jsonrpc.php | python -m json.tool
执行脚本,获取监控主机信息:
3.删除被监控主机(host.delete
方法)
[root@zabbix-server ~]# vim zabbix-api
curl -s -XPOST -H "Content-Type:application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.delete",
"params": [
"10258"
],
"id": 1,
"auth": "0fe85342817ef1a1e118d443f3b36867"
}' http://172.25.81.11/zabbix/api_jsonrpc.php | python -m json.tool
执行脚本,删除被监控主机
被监控主机server5已被删除:
4.创建新的被监控主机(host.creat
方法)
[root@zabbix-server ~]# vim zabbix-api
curl -s -XPOST -H "Content-Type:application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "server5",
"interfaces": [
{
"type": 1,
"main": 1,
"useip": 1,
"ip": "172.25.81.5",
"dns": "",
"port": "10050"
}
],
"groups": [
{
"groupid": "2"
}
],
"templates": [
{
"templateid": "10001"
}
]
},
"id": 1,
"auth": "0fe85342817ef1a1e118d443f3b36867"
}' http://172.25.81.11/zabbix/api_jsonrpc.php | python -m json.tool
查看groupid,主机群组—>Linux servers
查看templateid,所有模板—>Template OS Linux
执行脚本,创建新的被监控主机
成功创建新的被监控主机server5: