前言
API之主要目的是提供应用程序与开发人员以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。提供API所定义的功能的软件称作此API的实现。API是一种接口,故而是一种抽象。
应用程序接口(Application Programming Interface,简称:API),又称为应用编程接口,就是软件系统不同组成部分衔接的约定。
API的大致工作流如下:
-
(1)API 采用JSON-RPC实现。这意味着调用任何函数,都需要发送POST请求,输入输出数据都是以JSON格式
-
(2)准备JSON对象,它描述了你想要做什么(创建主机,获取图像,更新监控项等)
-
(3)获取JSON格式响应
1.编写脚本,查看zabbix监控系统的接口
(1)编写脚本
[root@server1 ~]# 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.6.1/zabbix/api_jsonrpc.php
(2)给脚本加可执行权限
[root@server1 ~]# chmod +x zabbix-api
[root@server1 ~]# ll zabbix-api
-rwxr-xr-x 1 root root 263 Jun 15 16:40 zabbix-api
(3)执行脚本
[root@server1 ~]# ./zabbix-api
{"jsonrpc":"2.0","result":"dd2d65b7c821dce2ffb8afddc7748fbc","id":1}[root@server1 ~]# ##这种格式的不方便查看
(4)添加json模块,以json的方式输出
(5)再次执行脚本后,result后的字符改变(这是身份令牌),后边会用到,随便选一个即可(第一次执行后生成的令牌也行)
2.获取zabbix主机和被监控的主机信息
[root@server1 ~]# vim zabbix-api
curl -s -XPOST -H "Content-Type: application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.get",
"params": {
"output": [
"hostid",
"host"
],
"selectInterfaces": [
"interfaceid",
"ip"
]
},
"id": 1,
"auth": "ed47e36be32f48daed48b675bca83220"
}' http://172.25.6.1/zabbix/api_jsonrpc.php | python -m json.tool
执行脚本。结果如下
[root@server1 ~]# ./zabbix-api
{
"id": 1,
"jsonrpc": "2.0",
"result": [
{
"host": "Zabbix server",
"hostid": "10084",
"interfaces": [
{
"interfaceid": "1",
"ip": "127.0.0.1"
}
]
},
{
"host": "server2",
"hostid": "10264", ##后面我们将在脚本中用hostid对监控主机进行删除等操作
"interfaces": [
{
"interfaceid": "3",
"ip": "172.25.6.2"
}
]
},
{
"host": "server3",
"hostid": "10265",
"interfaces": [
{
"interfaceid": "4",
"ip": "172.25.6.3"
}
]
}
]
}
3.删除zabbix监控中的主机
删除之前在监控系统中关闭自动注册和自动发现动作
此时监控群组中共三个主机
编写删除命令的脚本
[root@server1 ~]# vim zabbix-api
curl -s -XPOST -H "Content-Type: application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.delete", ##删除
"params": [
"10264" ##server2的hostid
],
"id": 1,
"auth": "ed47e36be32f48daed48b675bca83220"
}' http://172.25.6.1/zabbix/api_jsonrpc.php | python -m json.tool
执行结果如下
浏览器监控系统中查看到server2被删除
4.添加主机
(1)在浏览器的监控系统中获知groupid和templateid(因为要往脚本中写入),方法如下
-
groupid
【配置】—>【主机模板】–>点击【Linux servers】–>可以在地址栏中URL末尾看到groupid
-
templateid
【配置】 —> 【模板】----> 找到【Template OS Linux】 -->可以在地址栏中URL末尾看到templateid
(2)写脚本
[root@server1 ~]# vim zabbix-api
curl -s -XPOST -H "Content-Type: application/json-rpc" -d '
{
"jsonrpc": "2.0",
"method": "host.create",
"params": {
"host": "server2",
"interfaces": [
{
"type": 1,
"main": 1,
"useip": 1,
"ip": "172.25.6.2",
"dns": "",
"port": "10050"
}
],
"groups": [
{
"groupid": "2"
}
],
"templates": [
{
"templateid": "10001"
}
]
},
"id": 1,
"auth": "ed47e36be32f48daed48b675bca83220"
}' http://172.25.6.1/zabbix/api_jsonrpc.php | python -m json.tool
执行脚本
可以在浏览器中查看到server2添加进去了,刷新过一会可以看到server2的ZBX变成绿色