zabbix下的API
1、zabibix的API简介
Zabbix API开始扮演着越来越重要的角色,尤其是在集成第三方软件和自动化日常任务时。很难想象管理数千台服务器而没有自动化是多么的困难。Zabbix API为批量操作、第三方软件集成以及其他作用提供可编程接口。
Zabbix API允许你以编程方式检索和修改Zabbix的配置,并提供对历史数据的访问。它广泛用于:创建新的应用程序以使用Zabbix; 将Zabbix与第三方软件集成;自动执行常规任务。
Zabbix API是基于Web的API,作为Web前端的一部分提供。该API包含一组独立的方法;客户端和API之间的请求和响应使用JSON格式进行编码。大多数API至少包含四种方法: get, create, update 和 delete ,分别是检索,创建,更新和删除数据。当完成了前端的安装配置后,你就可以使用远程HTTP请求来调用API。
Zabbix API提供两项主要功能:
- 远程管理Zabbix配置
- 远程检索配置和历史数据
2、zabbix的API基本信息查看
2.1 验证API请求
在访问Zabbix中的任何数据之前,需要登录并获取身份验证令牌。这可以使用该 user.login 方法完成。
首先在server1中,编写zabbix-api的文件:
####身份验证文件:
1 curl -s -XPOST -H "Content-Type: application/json-rpc" -d'
2 {
3 "jsonrpc": "2.0", ##API实现的json的版本
4 "method": "user.login", ##被调用的API方法
5 "params": { ##将被传递给API方法的参数
6 "user": "Admin", ##用户
7 "password": "zabbix" ##密码
8 },
9 "id": 1, ##请求的任意标识符
10 "auth": null ##用户认证令牌,因为没有设置为null
11 }' http://192.168.1.110/zabbix/api_jsonrpc.php | python -m json.tool
~
result:就为令牌。
2.2 通过令牌检索主机
###检索主机脚本
1 curl -s -XPOST -H "Content-Type: application/json-rpc" -d'
2 {
3 "jsonrpc": "2.0",
4 "method": "host.get",
5 "params": {
6 "output": [
7 "hostid",
8 "host"
9 ],
10 "selectInterfaces": [
11 "interfaceid",
12 "ip"
13 ]
14 },
15 "id": 2,
16 "auth":"77962d5eaaf442111fe69cc3b9bc488e"
17 }' http://192.168.1.110/zabbix/api_jsonrpc.php | python -m json.tool
3.3 删除主机
编写删除脚本:
###删除脚本
1 curl -s -XPOST -H "Content-Type: application/json-rpc" -d'
2 {
3 "jsonrpc": "2.0",
4 "method": "host.del",
5 "params": [
6 "10307"
7 ],
8 "id": 2,
9 "auth":"77962d5eaaf442111fe69cc3b9bc488e"
10 }' http://192.168.1.110/zabbix/api_jsonrpc.php | python -m json.tool
运行结果可在图形界面查看
3、通过API创建主机监控
编写创建脚本:
####脚本内容:
1 curl -s -XPOST -H "Content-Type: application/json-rpc" -d'
2 {
3 "jsonrpc": "2.0",
4 "method": "host.create",
5 "params": {
6 "host": "server3",
7 "interfaces": [
8 {
9 "type": 1,
10 "main": 1,
11 "useip": 1,
12 "ip": "192.168.1.130",
13 "dns": "",
14 "port": "10050"
15 }
16 ],
17 "groups": [
18 {
19 "groupid": "2"
20 }
21 ],
22 "templates": [
23 {
24 "templateid": "10001"
25 }
26 ]
27 },
28 "id": 2,
29 "auth":"77962d5eaaf442111fe69cc3b9bc488e"
30 }' http://192.168.1.110/zabbix/api_jsonrpc.php | python -m json.tool
【说明】这里要考虑之前实验环境是否会影响服务的添加。
4、配置监控项
4.1 获得状态信息
在server2中添加监控模板:
在server3中配置Nginx:
####Nginx安装
[aaa@qq.com nginx-1.18.0]# yum install -y gcc zlib-devel pcre-devel
[aaa@qq.com nginx-1.18.0]# tar zxf nginx-1.18.0.tar.gz
[aaa@qq.com nginx-1.18.0]# vim nginx-1.18.0/auto/cc/gcc
##配置编译环境
...
# debug
#CFLAGS="$CFLAGS -g" 关闭debug
....
[aaa@qq.com nginx-1.18.0]# ./configure --prefix=/usr/local/nginx --with-http_stub_status_module
[aaa@qq.com nginx-1.18.0]# make && make install
####Nginx配置
[aaa@qq.com nginx-1.18.0]# vim /usr/local/nginx/conf/nginx.conf
##配置的内容
...
location /status {
stub_status on; ##开启服务器查询状态参数
access_log off; ##关闭日志
allow 127.0.0.1; ##设置权限
deny all;
...
[aaa@qq.com nginx-1.18.0]# /usr/local/nginx/sbin/nginx -t
[aaa@qq.com nginx-1.18.0]# /usr/local/nginx/sbin/nginx
在server3中配置agent策略:
####编写用户自定义目录
UserParameter=nginx.active,curl -s http://127.0.0.1/status | grep Active |awk '{print $3}'
在server1中进行测试:
测试的安装包为:zabbix-get-4.4.1-1.el7.x86_64.rpm,若未安装,需要进行安装才能测试。
配置图形界面:
没有时,新添加的东西需要创建一个新的监控项:
配置新的监控项:
然后创建图像:
配置相关参数:
预览查看,值没有错,但是中文没有显示,
添加中文字符集:
##添加字符集到指定目录,并修改默认配置文件
[aaa@qq.com fonts]# vim /usr/share/zabbix/include/defines.inc.php
###修改::%s/graphfont/simkai/g
修改完成,刷新页面即可查看:
5、自定义信息监控
在server3中自定义监控内容:
####在自定义脚本中编写/etc/zabbix/zabbix_agentd.d/userparameter_nginx.conf:
UserParameter=nginx.active,curl -s http://127.0.0.1/status | grep Active | awk '{print $3}'
UserParameter=nginx.accept,curl -s http://127.0.0.1/status | awk NR==3 | awk '{print $1}'
在server1中测试:
配置图形监控:
添加图形监控:
图形预览:
增加访问量,重新查看图形:
查看图形: