森数据DIX说明文档

# 北塔

btso数据集成

# 告警配置

类型配置选择 告警及版本，如下图所示。

选择DIP实例类型图

# 属性配置

属性配置

  • 名称：输入DIP实例名称。

# IN配置

告警V2.5 IN配置

v2.5 IN配置

  • IP：北塔服务器的主机IP
  • 端口：北塔服务器的端口
  • 告警URL：查询北塔告警的URL
  • 查询管理对象URL：查询管理对象列表的URL
  • 对象类型：需要查询的对象类型 (多个对象类型使用|分隔)
  • 字符集：获取告警数据时的字符集，默认utf-8
  • 轮询周期：告警数据采集周期 默认60秒
  • 告警源：EMV中定义的告警源，项目通常要对接来自不同系统的告警，依照该字段来区分不同系统的告警

告警V4.1 IN配置

v4.1 IN配置

  • IP：北塔服务器的主机IP
  • 端口：北塔服务器的端口
  • 告警URL：查询北塔告警的URL
  • 查询管理对象URL：查询管理对象列表的URL
  • 对象类型：需要查询的对象类型 (多个对象类型使用|分隔)
  • 字符集：获取告警数据时的字符集，默认utf-8
  • 轮询周期：告警数据采集周期 默认60秒
  • 告警源：EMV中定义的告警源，项目通常要对接来自不同系统的告警，依照该字段来区分不同系统的告警

# 数据映射

数据映射

映射CI：将北塔系统的告警匹配到发生该告警的设备(tarsier系统中的设备)上。此属性只有2种值：

  • 为空，即不写任何字符。适用于${ip}或者${uuid}是CI分类中的主键。
  • CI分类名.属性名。若${ip}或者${uuid}不是CI分类中的主键，可以通过所属设备的属性查找CI，CI分类和属性名来源于资产的分类和分类中的属性。
  • 索引规则名。若${ip}或者${uuid}不是CI分类中的主键，可以通过建立的索引规则查找CI。

# 级别映射

级别映射

重要

北塔的默认告警级别，与森数据DIX告警级别不匹配，需要通过映射来进行匹配

  • 从：北塔的告警级别
  • 到：森数据DIX的告警级别（1为最高级别）

级别映射配置，若无特殊需求，无需更改

从 到
1 1
2 2
3 3
4 4

# Out配置

性能的发送方式选择：点击添加，选择对应的发送方式将数据进行发送

输出方式选择


  • MYSQL

选择此项会将数据保存至mysql库，配置项如下：

MysqlOut

配置项名称 配置项描述 示例
URL（必填项） 数据库地址 jdbc:mysql://0.0.0.0:3306/db_vmdb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2b8
用户名（必填项） 数据库用户名 username
密码（必填项） 数据库密码 password
是否保存历史数据（必填项） 默认为是，保存历史数据 是

  • ES

选择此项会将数据保存至ES库，配置项如下：

EsOut

配置项名称 配置项描述 示例
ES请求地址（必填项） 数据库地址 0.0.0.0:9200
用户名 数据库用户名 username
密码 数据库密码 password
ES性能数据保留天数（必填项） 默认为7，保存7天内的性能数据 7
数据域 ThingJS-X数据域ID （可选）

  • ACTIVEMQ

选择此项会将数据发送至ActiveMQ，配置项如下：

ActivemqOut

配置项名称 配置项描述 示例
URL（必填项） ActiveMQ地址 failover://(tcp://0.0.0.0:61616,tcp://0.0.0.0:61616)?randomize=false&timeout=5000&maxReconnectAttempts=-1
队列名（必填项） ActiveMQ队列名称 queue
用户名 ActiveMQ用户名 username
密码 ActiveMQ密码 password

  • RABBITMQ

选择此项会将数据发送至RabbitMQ，配置项如下：

RabbitmqOut

配置项名称 配置项描述 示例
URL（必填项） RabbitMQ地址 0.0.0.0
端口（必填项） RabbitMQ端口号 12000
用户名 RabbitMQ用户名 username
密码 RabbitMQ密码 password
RabbitMq工作模式（必填项） 共有：简单模式，订阅模式，路由模式和Topic四种模式；默认为简单模式 简单模式
RabbitMq交换机或队列名称以及路由键（必填项） 根据工作模式填写json数据 如下表所示
交换机或队列是否持久化（必填项） 默认为否，不支持持久化 否
无服务时是否自动删除队列或者交换机（必填项） 默认为否，不会自动删除队列或交换机 否
RabbitMq工作模式 对应json
简单模式 {"name":"交换机名称"}
订阅模式 {"name":"交换机名称"}
路由模式 {"name":"交换机名称","routingKey":"路由键"}
Topic模式 {"name":"交换机名称","routingKey":"路由键"}

注：此处的交换机名称和路由键按照实际情况填写


  • ROCKETMQ

选择此项会将数据发送至RocketMQ，配置项如下：

RocketmqOut

配置项名称 配置项描述 示例
请求地址（必填项） RocketMQ地址 0.0.0.0:9876;0.0.0.0:9876
生产者组别 RocketMQ生产者组别 producerGroup
消息发送主题 消息发送主题 topicA
消息标签 消息标签 tagA
超时时间 消息发送超时时间，单位为毫秒 30000
字符集 字符编码集，默认UTF-8 UTF-8
消息发送类型 分为：异步发送，单向发送，同步发送共三种；默认为异步发送 异步发送

  • KAFKA

选择此项会将数据发送至kafka，配置项如下：

KafkaOut

配置项名称 配置项描述 示例
请求地址（必填项） kafka地址 0.0.0.0:9092;0.0.0.0:9092
消息发送主题（必填项） 消息发送主题 topicA
sasl静态认证文件地址（非必填） sasl conf认证文件位置 /uinnova/dix/kafka_sasl_jaas.conf
用户名（非必填） Kafka动态认证用户名 username
密码（非必填） Kafka动态认证密码 password
密码加密算法（非必填） 对密码进行加密的算法，下拉框中二选一 SCRAM-SHA-256 或 SCRAM-SHA-512
延迟（非必填） 消息发送延迟，单位为秒 1

  • MQTT

选择此项会将数据发送至mqtt，配置项如下：

MqttOut

配置项名称 配置项描述 示例
URL（必填项） mqtt地址 tcp://127.0.0.0:1883
MQTT客户端ID（必填项） mqtt客户端ID clientID101
用户名 mqtt用户名 username
密码 mqtt密码 password
消息发送主题 消息发送主题 topicA
消息发送质量 分为：仅分发一次，至少分发一次，最多分发一次共三种；默认仅分发一次 仅分发一次
字符集 字符编码集，默认UTF-8 UTF-8

  • HTTPPOST

选择此项会将数据通过post请求发送至http服务，配置项如下：

HttppostOut

配置项名称 配置项描述 示例
http服务路径（必填项） http服务地址 http://0.0.0.0:0000
请求头 填写json格式的参数 {"key":"value"}
字符集 字符编码集，默认utf-8 utf-8

  • HTTPSPOST

选择此项会将数据通过post请求发送至https服务，配置项如下：

HttpspostOut

配置项名称 配置项描述 示例
http服务路径（必填项） https服务地址 https://0.0.0.0:0000
请求头 填写json格式的参数 {"key":"value"}
字符集 字符编码集，默认utf-8 utf-8

  • DIP实例的保存与启动

    • 配置信息填写完成后，点击保存，成功保存后会在森数据DIX的数据集成页面看到新建的DIP实例

保存DIP实例

  • 点击开始/启动按钮。

保存DIP实例

名词解释

已接入：当前数据接口接入到的总数据量
处理中：当前数据接口正在进行处理的数据量
发送中：当前数据接口正在向外部发送的数据量
已发送：当前数据接口发送到外部的总数据量

  • 待启动成功之后，点击日志按钮，查看数据是否能正常接入





# 性能配置

类型配置选择 性能及版本，如下图所示。

选择DIP实例类型图

# 属性配置

选择DIP实例类型图

  • 名称：输入DIP实例名称。

# IN配置

性能V2.5 IN配置

选择DIP实例类型图

  • IP：北塔服务器的主机IP
  • 端口：北塔服务器的端口
  • 查询管理对象URL：查询管理对象列表的URL
  • 性能URL：获取指标的URL
  • 查询单个管理对象信息URL：查询“子对象”的URL
  • 对象类型：需要查询的对象类型
  • 配置文件：通过Excel配置性能指标，指标按对象类型分为不同的sheet，sheet名称与对象类型保持一致，每个sheet列标题如下图所示（Excel列标题解释：className：主类名称；subClassName：子类名称；metric：指标名称；metricName：指标别名，自定义）

OID配置

  • 字符集：获取性能数据时的字符集，默认utf-8
  • 轮询周期：性能数据采集周期 默认300秒

性能V4.1 IN配置

选择DIP实例类型图

  • IP：北塔服务器的主机IP
  • 端口：北塔服务器的端口
  • 查询管理对象URL：查询管理对象列表的URL
  • 性能URL：获取指标的URL
  • 查询单个管理对象信息URL：查询“子对象”的URL
  • 对象类型：需要查询的对象类型
  • 配置文件：通过Excel配置性能指标，指标按对象类型分为不同的sheet，sheet名称与对象类型保持一致，每个sheet列标题如下图所示（Excel列标题解释：className：主类名称；subClassName：子类名称；metric：指标名称；metricName：指标别名，自定义）

OID配置

  • 字符集：获取性能数据时的字符集，默认utf-8
  • 轮询周期：性能数据采集周期 默认600秒

# 数据映射

选择DIP实例类型图

映射CI：将北塔的性能数据匹配到设备(tarsier系统中的)上。此属性只有2种值：

  • 为空，即不写任何字符，适用于${ip}或者${uuid}是CI分类中的主键。
  • CI分类名.属性名。若${ip}或者${name}不是CI分类中的主键，可以通过所属设备的属性查找CI，CI分类和属性名来源于资产的分类和分类中的属性。
  • 索引规则名。若${ip}或者${uuid}不是CI分类中的主键，可以通过建立的索引规则查找CI。

# Out配置

性能的发送方式选择：点击添加，选择对应的发送方式将数据进行发送

输出方式选择


  • MYSQL

选择此项会将数据保存至mysql库，配置项如下：

MysqlOut

配置项名称 配置项描述 示例
URL（必填项） 数据库地址 jdbc:mysql://0.0.0.0:3306/db_vmdb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2b8
用户名（必填项） 数据库用户名 username
密码（必填项） 数据库密码 password
是否保存历史数据（必填项） 默认为是，保存历史数据 是

  • ES

选择此项会将数据保存至ES库，配置项如下：

EsOut

配置项名称 配置项描述 示例
ES请求地址（必填项） 数据库地址 0.0.0.0:9200
用户名 数据库用户名 username
密码 数据库密码 password
ES性能数据保留天数（必填项） 默认为7，保存7天内的性能数据 7
数据域 ThingJS-X数据域ID （可选）

  • ACTIVEMQ

选择此项会将数据发送至ActiveMQ，配置项如下：

ActivemqOut

配置项名称 配置项描述 示例
URL（必填项） ActiveMQ地址 failover://(tcp://0.0.0.0:61616,tcp://0.0.0.0:61616)?randomize=false&timeout=5000&maxReconnectAttempts=-1
队列名（必填项） ActiveMQ队列名称 queue
用户名 ActiveMQ用户名 username
密码 ActiveMQ密码 password

  • RABBITMQ

选择此项会将数据发送至RabbitMQ，配置项如下：

RabbitmqOut

配置项名称 配置项描述 示例
URL（必填项） RabbitMQ地址 0.0.0.0
端口（必填项） RabbitMQ端口号 12000
用户名 RabbitMQ用户名 username
密码 RabbitMQ密码 password
RabbitMq工作模式（必填项） 共有：简单模式，订阅模式，路由模式和Topic四种模式；默认为简单模式 简单模式
RabbitMq交换机或队列名称以及路由键（必填项） 根据工作模式填写json数据 如下表所示
交换机或队列是否持久化（必填项） 默认为否，不支持持久化 否
无服务时是否自动删除队列或者交换机（必填项） 默认为否，不会自动删除队列或交换机 否
RabbitMq工作模式 对应json
简单模式 {"name":"交换机名称"}
订阅模式 {"name":"交换机名称"}
路由模式 {"name":"交换机名称","routingKey":"路由键"}
Topic模式 {"name":"交换机名称","routingKey":"路由键"}

注：此处的交换机名称和路由键按照实际情况填写


  • ROCKETMQ

选择此项会将数据发送至RocketMQ，配置项如下：

RocketmqOut

配置项名称 配置项描述 示例
请求地址（必填项） RocketMQ地址 0.0.0.0:9876;0.0.0.0:9876
生产者组别 RocketMQ生产者组别 producerGroup
消息发送主题 消息发送主题 topicA
消息标签 消息标签 tagA
超时时间 消息发送超时时间，单位为毫秒 30000
字符集 字符编码集，默认UTF-8 UTF-8
消息发送类型 分为：异步发送，单向发送，同步发送共三种；默认为异步发送 异步发送

  • KAFKA

选择此项会将数据发送至kafka，配置项如下：

KafkaOut

配置项名称 配置项描述 示例
请求地址（必填项） kafka地址 0.0.0.0:9092;0.0.0.0:9092
消息发送主题（必填项） 消息发送主题 topicA
sasl静态认证文件地址（非必填） sasl conf认证文件位置 /uinnova/dix/kafka_sasl_jaas.conf
用户名（非必填） Kafka动态认证用户名 username
密码（非必填） Kafka动态认证密码 password
密码加密算法（非必填） 对密码进行加密的算法，下拉框中二选一 SCRAM-SHA-256 或 SCRAM-SHA-512
延迟（非必填） 消息发送延迟，单位为秒 1

  • MQTT

选择此项会将数据发送至mqtt，配置项如下：

MqttOut

配置项名称 配置项描述 示例
URL（必填项） mqtt地址 tcp://127.0.0.0:1883
MQTT客户端ID（必填项） mqtt客户端ID clientID101
用户名 mqtt用户名 username
密码 mqtt密码 password
消息发送主题 消息发送主题 topicA
消息发送质量 分为：仅分发一次，至少分发一次，最多分发一次共三种；默认仅分发一次 仅分发一次
字符集 字符编码集，默认UTF-8 UTF-8

  • HTTPPOST

选择此项会将数据通过post请求发送至http服务，配置项如下：

HttppostOut

配置项名称 配置项描述 示例
http服务路径（必填项） http服务地址 http://0.0.0.0:0000
请求头 填写json格式的参数 {"key":"value"}
字符集 字符编码集，默认utf-8 utf-8

  • HTTPSPOST

选择此项会将数据通过post请求发送至https服务，配置项如下：

HttpspostOut

配置项名称 配置项描述 示例
http服务路径（必填项） https服务地址 https://0.0.0.0:0000
请求头 填写json格式的参数 {"key":"value"}
字符集 字符编码集，默认utf-8 utf-8

  • DIP实例的保存与启动

    • 配置信息填写完成后，点击保存，成功保存后会在森数据DIX的数据集成页面看到新建的DIP实例

保存DIP实例

  • 点击开始/启动按钮。

保存DIP实例

名词解释

已接入：当前数据接口接入到的总数据量
处理中：当前数据接口正在进行处理的数据量
发送中：当前数据接口正在向外部发送的数据量
已发送：当前数据接口发送到外部的总数据量

  • 待启动成功之后，点击日志按钮，查看数据是否能正常接入
上次更新时间: 3/20/2023, 9:06:32 AM

← eSight →