Zabbix分布式监控（2）——Zabbix的API接口

快来打我* 2023-07-17 05:54 28阅读 0赞

本实验是在[Zabbix分布式监控实战（1）——认识zabbix，搭建Zabbix监控平台][Zabbix_1_zabbix_Zabbix]实验基础上进行的，已经配置好了zabbix-server和zabbix-agent主机，并在zabbix-web界面配置了自动注册。

### 文章目录 ###

*   *  一、认识API
     *   *   *  1、什么是Zabbix API
             *  2、Zabbix API提供的主要功能
             *  3、使用 JSON操作API
             *  4、API分类
             *  5、API常用接口
     *  二、配置Zabbix的API接口
     *   *   *  实验环境
             *  实验
             *   *  1、测试并获取身份令牌（user.login接口）
                 *  2、使用身份令牌检索主机（host.get接口）
                 *  3、尝试 api 添加删除主机（host.delete接口）
                 *  4、使用 api 创建主机（host.create接口）

## 一、认识API ##

#### 1、什么是Zabbix API ####

API（Application Programming Interface，应用程序编程接口）是一些预先定义的函数，目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力，而又无需访问源码，或理解内部工作机制的细节。

Zabbix API 开始扮演着越来越重要的角色，尤其是在集成第三方软件和自动化日常任务时。很难想象管理数千台服务器而没有自动化是多么的困难。  
Zabbix API 为批量操作、第三方软件集成以及其他作用提供可编程接口。

Zabbix API 是在 1.8 版本中开始引进并且已经被广泛应用。所有的 Zabbix 移动客户端都是基于 API，甚至原生的 WEB 前端部分也是建立在它之上。  
Zabbix API 中间件使得架构更加模块化也避免直接对数据库进行操作。  
它允许你通过 JSON RPC 协议来创建、更新和获取 Zabbix 对象并且做任何你喜欢的操作。

#### 2、Zabbix API提供的主要功能 ####

1.  远程管理 Zabbix 配置
2.  远程检索配置和历史数据
3.  自动执行常规任务

#### 3、使用 JSON操作API ####

API 采用 JSON-RPC 实现。这意味着调用任何函数，都需要发送 POST 请求，输入输出数据都是以 JSON 格式。

Zabbix API由许多名义上分组的独立API方法组成。每个方法执行一个特定任务。例如，方法 host.create 隶属于 host 这个API分组 ，用于创建新主机。历史上，API分组有时被称为“类”。  
大多数API至少包含四种方法： get， create， update 和 delete ，分别是检索，创建，更新和删除数据，但是某些API提供一套完全不同的一组方法。

#### 4、API分类 ####

根据单个或分布式平台上不同软件应用程序间的数据共享性能，可以将 API 分为四种类型：

*  远程过程调用（RPC）：通过作用在共享数据缓存器上的过程（或任务）实现程序间的通信。
 *  标准查询语言（SQL）：是标准的访问数据的查询语言，通过通用数据库实现应用程序间的数据共享。
 *  文件传输：文件传输通过发送格式化文件实现应用程序间数据共享。
 *  信息交付：指松耦合或紧耦合应用程序间的小型格式化信息，通过程序间的直接通信实现数据共享。

#### 5、API常用接口 ####

## 二、配置Zabbix的API接口 ##

#### 实验环境 ####

<table> 
 <thead> 
  <tr> 
   <th>主机名</th> 
   <th>ip</th> 
   <th>服务</th> 
   <th>版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>server1</td> 
   <td>172.25.1.1</td> 
   <td>zabbix-server，zabbix-web,mariadb-server</td> 
   <td>rhel7.3</td> 
  </tr> 
  <tr> 
   <td>server2</td> 
   <td>172.25.1.2</td> 
   <td>zabbix-agent</td> 
   <td>rhel7.3</td> 
  </tr> 
  <tr> 
   <td>server3</td> 
   <td>172.25.1.3</td> 
   <td>zabbix-agent</td> 
   <td>rhel7.3</td> 
  </tr> 
 </tbody> 
</table>

#### 实验 ####

在server1上：

##### 1、测试并获取身份令牌（user.login接口） #####

步骤一：编写zabbix-api文件，获取身份令牌

vim zabbix-api
    
    curl -XPOST -H "Content-Type: application/json-rpc" -d '
    {
        
    "jsonrpc": "2.0",  #标准的JSON RPC参数以标示协议版本
    "method": "user.login", #获取接口方法名,用户登陆
    "params": {
        
    "user": "Admin",   #zabbix系统监控的用户名和密码
    "password": "zabbix"
    },
    "id": 1,
    "auth": null   #用户的身份令牌，因为还没有获取所以为null
    }' http://172.25.1.1/zabbix/api_jsonrpc.php   #api_jsonrpc.php是调用api的php脚本，可以安装可视化前端目录查看

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70]  
步骤二：运行脚本

chmod +x zabbix-api
    ./zabbix-api

![在这里插入图片描述][20200319204046824.png]  
步骤三：上述显示的结果不清晰，加入 python 的 json 模块

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.1.1/zabbix/api_jsonrpc.php | python -m json.tool  #加入 -s 参数和 json 模块

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 1]  
步骤四：运行脚本

./zabbix-api

![在这里插入图片描述][20200319204157187.png]

##### 2、使用身份令牌检索主机（host.get接口） #####

步骤一：编写zabbix-api文件检索主机，将上述查看到的result令牌添加到auth后

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": "cc06660254d4bb747fdcb0dbb4a44609"
    }' http://172.25.1.1/zabbix/api_jsonrpc.php | python -m json.tool

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 2]  
步骤二：执行脚本

./zabbix-api

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 3]

##### 3、尝试 api 添加删除主机（host.delete接口） #####

步骤一：先在web界面禁用之前配置的自动注册  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 4]  
步骤二：编辑zabbix-api文件，调用host.delete接口

vim zabbix-api 
    
    curl -s -XPOST -H "Content-Type: application/json-rpc" -d '
    {
        
    "jsonrpc": "2.0",
    "method": "host.delete",
    "params": [
    "10267"   #server2的hostid
    ],
    "id": 1,
    "auth": "cc06660254d4bb747fdcb0dbb4a44609"
    }' http://172.25.1.1/zabbix/api_jsonrpc.php | python -m json.tool

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 5]  
步骤三：运行脚本  
![在这里插入图片描述][2020031920443152.png]  
步骤四：在web界面查看，server2已经被删除  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 6]

##### 4、使用 api 创建主机（host.create接口） #####

步骤一：在web界面查看Groupid  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 7]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 8]  
步骤二：在web界面查看templatesid  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 9]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 10]![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 11]  
步骤三：编辑zabbix-api文件，调用host.create接口创建server2主机

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.1.2",
    "dns": "",
    "port": "10050"
    }
    ],
    "groups": [
    {
        
    "groupid": "2"  #上面查看到的Groupid号
    }
    ],
    "templates": [
    {
        
    "templateid": "10001"  #上面查看到的templatesid
    
    }
    ]
    },
    "id": 1,
    "auth": "cc06660254d4bb747fdcb0dbb4a44609"
    }' http://172.25.1.1/zabbix/api_jsonrpc.php | python -m json.tool

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 12]  
步骤四：运行脚本

./zabbix-api

![在这里插入图片描述][20200319210341199.png]  
步骤五：web界面查看，server2已经添加进去了  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 13]

[Zabbix_1_zabbix_Zabbix]: https://blog.csdn.net/CapejasmineY/article/details/104783241
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70]: /images/20230528/eaae354c311b4e99ad954f41116d1bfb.png
[20200319204046824.png]: /images/20230528/aded1aa08fbb40e593e03d30c4f918cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 1]: /images/20230528/1da605ab8abf41f6ac0dea358b089905.png
[20200319204157187.png]: /images/20230528/aab3b9887f1d4b6a92031237ad7f38f6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 2]: /images/20230528/9b2bed7d06ce42e49b2bd0c801311976.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 3]: /images/20230528/7f427389677f4b77aa5b726e6ed50e70.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 4]: /images/20230528/6dcfdd1980b84158818a663b65e9685a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 5]: /images/20230528/d7ddc860e16c477bb361ac31b7feb60e.png
[2020031920443152.png]: /images/20230528/73603513ff944876830b27d2866f0ba2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 6]: /images/20230528/4879a209755147ed9d0d094024cedfc3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 7]: https://img-blog.csdnimg.cn/2020031921010399.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 8]: /images/20230528/4ea40578b773426d9b1b8371d81dd0bc.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 9]: /images/20230528/26f4e993524d45909ff706075b337407.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 10]: https://img-blog.csdnimg.cn/20200319210234999.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 11]: /images/20230528/1cc9e2bf4b184fcbacd0974aee33f8fd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 12]: /images/20230528/bef30b1f9aec4d67a20059be9337b387.png
[20200319210341199.png]: /images/20230528/bff3bc537eee49a99fb3f6b05a8c3846.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NhcGVqYXNtaW5lWQ_size_16_color_FFFFFF_t_70 13]: /images/20230528/1ea5e260c572457381cb979878360136.png