zabbix_manager 5.1.2.pre.alpha2 → 5.1.4

data/lib/zabbix_manager/classes/drules.rb

@@ -2,23 +2,17 @@
 
 class ZabbixManager
   class Drules < Basic
-    # The method name used for interacting with Drules via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Drules 交互的方法名称
     def method_name
       "drule"
     end
 
-    # The id field name used for identifying specific Drule objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 Drule 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # The default options used when creating Drule objects via Zabbix API
-    #
-    # @return [Hash]
+    # 创建 Drule 对象时使用的默认选项
     def default_options
       {
         name:    nil,
@@ -28,14 +22,9 @@ class ZabbixManager
       }
     end
 
-    # Get or Create Drule object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name to properly identify Drule via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] Zabbix object id
+    # 通过 Zabbix API 获取或创建 Drule 对象
     def get_or_create(data)
-      log "[DEBUG] Call get_or_create with parameters: #{data.inspect}"
+      log "[DEBUG] 调用 get_or_create，参数为：#{data.inspect}"
 
       unless (id = get_id(name: data[:name]))
         id = create(data)
@@ -43,12 +32,7 @@ class ZabbixManager
       id
     end
 
-    # Create or update Drule object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name to properly identify Drules via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass] Zabbix object id
+    # 通过 Zabbix API 创建或更新 Drule 对象
     def create_or_update(data)
       druleid = get_id(name: data[:name])
       druleid ? update(data.merge(druleid: druleid)) : create(data)

data/lib/zabbix_manager/classes/errors.rb

@@ -1,29 +1,39 @@
 # frozen_string_literal: true
 
 class ZabbixManager
+  # BaseError 是 ZabbixManager 模块中处理异常的基类
   class BaseError < RuntimeError
-    attr_accessor :response, :error, :error_message
+    # 用于存储响应对象
+    attr_accessor :response
+    # 用于存储 Zabbix API 错误信息
+    attr_accessor :error
+    # 用于存储格式化后的错误消息
+    attr_accessor :error_message
 
+    # 初始化异常对象
     def initialize(message, response = nil)
       super(message)
       @response = response
-
       set_error! if @response
     end
 
     private
-      def set_error!
-        @error = @response["error"]
-        @error_message = "#{@error["message"]}: #{@error["data"]}"
-      rescue StandardError
-        @error = nil
-        @error_message = nil
-      end
+
+    # 从响应中提取 Zabbix API 错误信息
+    def set_error!
+      @error = @response["error"]
+      @error_message = "#{@error["message"]}: #{@error["data"]}"
+    rescue StandardError
+      @error = nil
+      @error_message = nil
+    end
   end
 
+  # ZbxError 是 ZabbixManager 模块中处理 Zabbix API 异常的类
   class ZbxError < BaseError
   end
 
+  # HttpError 是 ZabbixManager 模块中处理 HTTP 异常的类
   class HttpError < BaseError
   end
 end

data/lib/zabbix_manager/classes/events.rb

@@ -2,16 +2,12 @@
 
 class ZabbixManager
   class Events < Basic
-    # The method name used for interacting with Events via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Events 交互的方法名称
     def method_name
       "event"
     end
 
-    # The id field name used for identifying specific Event objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 Event 对象的 id 字段名称
     def identify
       "name"
     end

data/lib/zabbix_manager/classes/graphs.rb

@@ -2,32 +2,22 @@
 
 class ZabbixManager
   class Graphs < Basic
-    # The method name used for interacting with Graphs via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Graphs 交互的方法名称
     def method_name
       "graph"
     end
 
-    # The id field name used for identifying specific Graph objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 Graph 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # Get full/extended Graph data from Zabbix API
-    #
-    # @param data [Hash] Should include object's id field name (identify) and id value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 从 Zabbix API 获取完整/扩展的 Graph 数据
     def get_full_data(data)
-      log "[DEBUG] Call get_full_data with parameters: #{data.inspect}"
+      log "[DEBUG] 使用参数调用 get_full_data: #{data.inspect}"
 
-      @client.api_request(
-        method: "#{method_name}.get",
-        params: {
+      get_raw(
+        {
           search: {
             identify.to_sym => data[identify.to_sym]
           },
@@ -36,16 +26,10 @@ class ZabbixManager
       )
     end
 
-    # Get Graph ids for Host from Zabbix API
-    #
-    # @param data [Hash] Should include host value to query for matching graphs
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Array] Returns array of Graph ids
+    # 从 Zabbix API 获取主机的 Graph ids
     def get_ids_by_host(data)
-      result = @client.api_request(
-        method: "graph.get",
-        params: {
+      result = get_raw(
+        {
           filter: {
             host: data[:host]
           },
@@ -54,38 +38,28 @@ class ZabbixManager
       )
 
       result.filter_map do |graph|
-        num  = graph["graphid"]
-        name = graph["name"]
+        num    = graph["graphid"]
+        name   = graph["name"]
         filter = data[:filter]
 
         num if filter.nil? || /#{filter}/ =~ name
       end
     end
 
-    # Get Graph Item object using Zabbix API
-    #
-    # @param data [Hash] Needs to include graphids to properly identify Graph Items via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
+    # 通过 Zabbix API 获取 Graph Item 对象
     def get_items(data)
       @client.api_request(
         method: "graphitem.get",
         params: {
           graphids: [data],
-          output: "extend"
+          output:   "extend"
         }
       )
     end
 
-    # Get or Create Graph object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and templateid to properly identify Graphs via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] Zabbix object id
+    # 通过 Zabbix API 获取或创建 Graph 对象
     def get_or_create(data)
-      log "[DEBUG] Call get_or_create with parameters: #{data.inspect}"
+      log "[DEBUG] 使用参数调用 get_or_create: #{data.inspect}"
 
       unless (id = get_id(name: data[:name], templateid: data[:templateid]))
         id = create(data)
@@ -94,12 +68,7 @@ class ZabbixManager
       id
     end
 
-    # Create or update Graph object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and templateid to properly identify Graphs via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass] Zabbix object id
+    # 通过 Zabbix API 创建或更新 Graph 对象
     def create_or_update(data)
       graphid = get_id(name: data[:name], templateid: data[:templateid])
       graphid ? _update(data.merge(graphid: graphid)) : create(data)

data/lib/zabbix_manager/classes/hostgroups.rb

@@ -2,23 +2,17 @@
 
 class ZabbixManager
   class HostGroups < Basic
-    # The method name used for interacting with HostGroups via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 HostGroups 交互的方法名称
     def method_name
       "hostgroup"
     end
 
-    # The id field name used for identifying specific HostGroup objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 HostGroup 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # The key field name used for HostGroup objects via Zabbix API
-    #
-    # @return [String]
+    # HostGroup 对象通过 Zabbix API 使用的 key 字段名称
     def key
       "groupid"
     end

data/lib/zabbix_manager/classes/hostinterfaces.rb

@@ -2,25 +2,28 @@
 
 class ZabbixManager
   class HostInterfaces < Basic
-    # The method name used for interacting with HostInterfaces via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 HostInterfaces 交互的方法名称
     def method_name
       "hostinterface"
     end
 
-    # The id field name used for identifying specific HostInterface objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 HostInterface 对象的 id 字段名称
     def identify
       "hostids"
     end
 
-    # The key field name used for HostInterface objects via Zabbix API
-    #
-    # @return [String]
+    # HostInterface 对象通过 Zabbix API 使用的 key 字段名称
     def key
       "interfaceid"
     end
+
+    # 通过 Zabbix API 基于提供的 hostid 获取 Zabbix interface 的 id
+    # @note 基于 hostid 查询关联的 Interfaceid
+    def get_interfaceid(hostid)
+      result = get_raw({ output: key, identify.to_sym => hostid })
+
+      # 如果查询结果不为空，且第一个元素不为空，则继续获取 {interfaceid} 并转换为整数
+      result&.[](0)&.[](key)&.to_i
+    end
   end
 end

data/lib/zabbix_manager/classes/hosts.rb

@@ -2,44 +2,17 @@
 
 class ZabbixManager
   class Hosts < Basic
-    # The method name used for interacting with Hosts via Zabbix API
-    #
-    # @return [String]
+    # 与 Zabbix API 交互的主机方法名称
     def method_name
       "host"
     end
 
-    # The id field name used for identifying specific Host objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定主机对象的 id 字段名称
     def identify
       "host"
     end
 
-    # Dump Host object data by key from Zabbix API
-    #
-    # @param data [Hash] Should include desired object's key and value
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Hash]
-    def dump_by_id(data)
-      log "[DEBUG] Call dump_by_id with parameters: #{data.inspect}"
-
-      @client.api_request(
-        method: "host.get",
-        params: {
-          filter:      {
-            key.to_sym => data[key.to_sym]
-          },
-          output:      "extend",
-          selectHosts: "shorten"
-        }
-      )
-    end
-
-    # The default options used when creating Host objects via Zabbix API
-    # @note Create Host 缺省的配置参数
-    # @return [Hash]
+    # 在通过 Zabbix API 创建主机对象时使用的默认选项
     def default_options
       {
         host:           nil,
@@ -63,12 +36,60 @@ class ZabbixManager
       }
     end
 
-    # Unlink/Remove Templates from Hosts using Zabbix API
-    #
-    # @param data [Hash] Should include hosts_id array and templates_id array
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Boolean]
+    # 通过 Zabbix API 从指定的 key 值获取主机对象数据
+    def dump_by_id(data)
+      log "[DEBUG] 调用 dump_by_id 方法，参数: #{data.inspect}"
+
+      get_raw({
+                filter:      {
+                  key.to_sym => data[key.to_sym]
+                },
+                output:      "extend",
+                selectHosts: "shorten"
+              }
+      )
+    end
+
+    # 通过 Zabbix API 根据名称获取 Zabbix 对象的 ID
+    def get_ids_by_name(data)
+      log "[DEBUG] 调用 #{method_name}.get_ids_by_name 方法，参数: #{data.inspect}"
+
+      result = get_raw({
+                         filter: { name: [data].flatten },
+                         output: [key]
+                       }
+      )
+      result.empty? ? nil : result.map { |i| { key.to_sym => i[key] } }
+    end
+
+    # 使用 Zabbix API 创建或更新 Zabbix 对象
+    def create_or_update(data)
+      log "[DEBUG] 调用 #{method_name}.create_or_update 方法，参数: #{data.inspect}"
+
+      hostid = get_id(identify.to_sym => data[identify.to_sym])
+      return create(data) unless hostid
+
+      interface_id = get_interfaceid(hostid)
+      raise ZbxError, "#{data.inspect} get_interfaceid 查无记录" unless interface_id
+
+      dump_data  = data.dup
+      interfaces = dump_data.delete(:interfaces)&.merge(interfaceid: interface_id)
+      params     = dump_data.merge(interfaces: interfaces).merge(key.to_sym => hostid.to_s)
+      update(params)
+    end
+
+    # 从 API 中基于提供的 hostid 获取 Zabbix interface 的 id
+    def get_interfaceid(hostid)
+      log "[DEBUG] 调用 #{method_name}.get_interfaceid 方法，参数: #{hostid.inspect}"
+
+      result = @client.api_request(
+        method: "hostinterface.get",
+        params: { output: "interfaceid", hostids: hostid }
+      )
+      result&.[](0)&.[]("interfaceid")&.to_i
+    end
+
+    # 在 Hosts 中使用 Zabbix API 取消关联/移除模板
     def unlink_templates(data)
       result = @client.api_request(
         method: "host.massRemove",
@@ -79,24 +100,5 @@ class ZabbixManager
       )
       result.empty? ? false : true
     end
-
-    # Get Zabbix object ID by name using Zabbix API
-    # @note 基于监控对象索引键(#{identify})查询 #{key}
-    # @param data [String, Array] Needs to include host to properly identify Zabbix Objects via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Array, NilClass] Zabbix object id
-    def get_ids_by_name(data)
-      log "[DEBUG] Call #{method_name}.get_ids_by_name with parameters: #{data.inspect}"
-
-      result = get_raw(
-        {
-          filter: { name: [data].flatten },
-          output: ["#{key}"]
-        }
-      )
-      result.empty? ? nil : result.map { |i| { "#{key}": i[key] } }
-    end
-
   end
 end

data/lib/zabbix_manager/classes/httptests.rb

@@ -2,37 +2,26 @@
 
 class ZabbixManager
   class HttpTests < Basic
-    # The method name used for interacting with HttpTests via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 HttpTests 交互的方法名称
     def method_name
       "httptest"
     end
 
-    # The id field name used for identifying specific HttpTest objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 HttpTest 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # The default options used when creating HttpTest objects via Zabbix API
-    #
-    # @return [Hash]
+    # 通过 Zabbix API 创建 HttpTest 对象时使用的默认选项
     def default_options
       {
         hostid: nil,
-        name: nil,
-        steps: []
+        name:   nil,
+        steps:  []
       }
     end
 
-    # Get or Create HttpTest object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and hostid to properly identify HttpTests via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer] Zabbix object id
+    # 通过 Zabbix API 获取或创建 HttpTest 对象
     def get_or_create(data)
       log "[DEBUG] Call get_or_create with parameters: #{data.inspect}"
 
@@ -42,12 +31,7 @@ class ZabbixManager
       id
     end
 
-    # Create or update HttpTest object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and hostid to properly identify HttpTests via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass] Zabbix object id
+    # 通过 Zabbix API 创建或更新 HttpTest 对象
     def create_or_update(data)
       httptestid = get_id(name: data[:name], hostid: data[:hostid])
       httptestid ? update(data.merge(httptestid: httptestid)) : create(data)

data/lib/zabbix_manager/classes/items.rb

@@ -2,23 +2,17 @@
 
 class ZabbixManager
   class Items < Basic
-    # The method name used for interacting with Items via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与 Items 交互的方法名称
     def method_name
       "item"
     end
 
-    # The id field name used for identifying specific Item objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 标识特定 Item 对象的 id 字段名称
     def identify
       "name"
     end
 
-    # The default options used when creating Item objects via Zabbix API
-    #
-    # @return [Hash]
+    # 通过 Zabbix API 创建 Item 对象时使用的默认选项
     def default_options
       {
         name:                  nil,
@@ -56,12 +50,7 @@ class ZabbixManager
       }
     end
 
-    # Get or Create Item object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and hostid to properly identify Items via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass, NilClass] Zabbix object id
+    # 通过 Zabbix API 获取或创建 Item 对象
     def get_or_create(data)
       log "[DEBUG] Call #{method_name}.get_or_create with parameters: #{data.inspect}"
 
@@ -72,36 +61,22 @@ class ZabbixManager
       end
     end
 
-    # Create or update Item object using Zabbix API
-    #
-    # @param data [Hash] Needs to include name and hostid to properly identify Items via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass, NilClass] Zabbix object id
+    # 通过 Zabbix API 创建或更新 Item 对象
     def create_or_update(data)
       itemid = get_id(name: data[:name], hostid: data[:hostid])
       itemid ? update(data.merge(itemid: itemid)) : create(data)
     end
 
-    # Create Dns Monitor object using Zabbix API
-    # @note 根据设备名称和接口名字查询监控项：入参 GigabitEthernet1/0/12，出参 15809
-    # @example Interface Et0/0(TO_CLOUD): Bits sent, snmpoid 1.3.6.1.2.1.31.1.1.1.10.1
-    # @example Interface Et0/0(TO_CLOUD): Operational status, snmpoid 1.3.6.1.2.1.2.2.1.8.1
-    # @example Interface Et0/0(TO_CLOUD): Speed, snmpoid 1.3.6.1.2.1.31.1.1.1.15.1
-    # @example Interface Et0/0(TO_CLOUD): Bits received, snmpoid 1.3.6.1.2.1.31.1.1.1.6.1
-    # @param hostid [String, Integer] Needs to include name and hostid to properly identify Items via Zabbix API
-    # @param name [String] Needs to include name and hostid to properly identify Items via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass, NilClass] Zabbix object id
+    # 通过 Zabbix API 获取特定主机和接口下的监控项
     def get_interface_items(hostid, name)
-      log "[DEBUG] Call #{method_name}.get_interface_items with parameters: #{data.inspect}"
+      # 记录调试信息，标识方法调用以及传递的参数
+      log "[DEBUG] 调用 #{method_name}.get_interface_items，参数：hostid #{hostid.inspect}，name #{name.inspect}"
 
-      # 自动剔除收尾空白字串
-      _name = name&.gsub(%r{[^/0-9]}, "").strip
+      # 自动剔除收尾空白字符，规范化接口名
+      _name = name&.gsub(%r{[^/0-9]}, "")&.strip
       iface = "#{_name}("
 
-      # 模糊查询接口下所有监控项，同时过滤出特定的 snmp_oid
+      # 使用 Zabbix API 进行模糊查询，获取特定主机和接口下的监控项
       result = get_raw(
         {
           output:  "extend",
@@ -115,39 +90,8 @@ class ZabbixManager
       }.sort_by {
         |item| item["key_"]
       }
-      result.empty? ? nil : result
-    end
-
-    # The default options used when creating DNS Monitor objects via Zabbix API
-    # @note 缺省的 dns 参数
-    # @return [Hash]
-    def default_dns_params
-      {
-        type: 0, # 代表 zabbix_agent
-        value_type: 1, # 代表字符串
-        delay:    "1m",
-        history:  "90d",
-        lifetime: "30d",
-        timeout:  "15s"
-      }
-    end
-
-    # Create Dns Monitor object using Zabbix API
-    #
-    # @param hostid [Hash] Needs to include dns_name and hostid to properly identify Items via Zabbix API
-    # @param dns_name [Hash] Needs to include dns_name and hostid to properly identify Items via Zabbix API
-    # @raise [ZbxError] Error returned when there is a problem with the Zabbix API call.
-    # @raise [HttpError] Error raised when HTTP status from Zabbix Server response is not a 200 OK.
-    # @return [Integer, TrueClass, FalseClass, NilClass] Zabbix object id
-    def create_dns_item(hostid, dns_name)
-      name = "【DNS域名解析监控】#{dns_name}"
-      key  = "net.dns.record[,#{dns_name},A,2,2]"
 
-      params = default_dns_params.merge(hostid: hostid, name: name, key: key)
-      result = @client.api_request(
-        method: "item.create",
-        params: params
-      )
+      # 如果结果为空，则返回 nil；否则，返回排序后的结果
       result.empty? ? nil : result
     end
   end

data/lib/zabbix_manager/classes/maintenance.rb

@@ -2,16 +2,12 @@
 
 class ZabbixManager
   class Maintenance < Basic
-    # The method name used for interacting with Maintenances via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 与维护窗口对象交互的方法名称
     def method_name
       "maintenance"
     end
 
-    # The id field name used for identifying specific Maintenance objects via Zabbix API
-    #
-    # @return [String]
+    # 用于通过 Zabbix API 识别特定维护窗口对象的 id 字段名称
     def identify
       "name"
     end