数据接入

集成功能负责集成数据和工具，接入的数据类型包括指标、事件、拓扑和CMDB。

数据集成：支持集成不同来源的数据，如主流的开源监控工具，Zabbix、Prometheus、Niagos、ELK；第三方监控平台，如Dynatrace、BMC等。
工具集成：支持集成ITSM工具，如ServiceNow、JIRA。

接入事件

在左侧导航栏中选择管理>集成>数据接入，默认进入事件接入页面。
左侧信息区域，展示的是当前系统支持的数据源类型。从中选择一个，在右侧点击新建数据源，创建具体的数据源。

也可以直接点击右侧的新建数据源按钮，页面会提示选择一个“数据源类型”，然后点击下一步，进入到数据源创建页面。
填写配置信息。
- 数据源接收最大时间：如果超过这个设置的时间还没接收到数据，北冥系统会认为该接口不可用，将自动给用户发一条告警通知。
- 警报自动关闭时间：超过这个设置的时间，对于还处于触发状态下的告警事件，系统会自动创建一个“解决状态的告警事件”。
- 事件预处理规则：从数据源接收到的元数据，需要经过数据加工和处理，系统才能识别并对其数据管理。如果还没有创建过规则，可点击后面的新建规则按钮进行创建。
- 配置说明：每种数据源，都有各自的配置方式说明。
- 查看API接入规范：点击后会弹出部署配置的PDF文件，详细描述如何进行配置才能完成数据的接入。
单击保存并生成token按钮。单击后系统会自动生成一个token，这是第三方上传数据的唯一标识凭证。oken是无法重新设置的，一旦生成，终身有效。

当用户在左侧选择接入类型为“Changes REST API”时，接入的数据类型为“变更事件”，这类事件通常是从用户ITSM系统中变更工单对接而来。在新建数据源页面只需要配置数据源名称和数据预处理规则即可。

为了更准确地聚合告警事件数据，可以引入CMDB资源关联关系或APM应用调用链关系，跨层级聚合不同类型的IT资源，如用户体验、网络设备、业务系统、应用、中间件、数据库、主机等。

要创建新的拓扑，请按照以下步骤进行操作：

在左侧导航栏中依次选择管理>集成>数据接入，进入数据接入页面。
单击拓扑页签，在左侧区域选择基调听云或第三方，然后在右侧区域点击新建拓扑按钮。

也可以直接点击右侧的新建拓扑按钮，页面会提示选择基调听云或第三方，然后点击下一步，进入到新建拓扑页面。
配置信息（基调听云）。
- 拓扑名称：输入新拓扑的名称，支持中英文以及特殊字符。
- AccountId：目前仅支持基调听云SaaS Server 2.0拓扑数据的导入。要获取AccountId，需要进入基调听云SaaS Server控制台，然后点击右上角的用户图标，在菜单中选择修改授权码，当前用户ID即为AccountId。
- token：要获取token，需要进入基调听云SaaS Server控制台，然后点击右上角的用户图标，在菜单中选择修改授权码，当前授权码即为token。
配置信息（第三方）。
- 拓扑名称：输入新拓扑的名称，支持中英文以及特殊字符。
- 引入方式：
  - 定时拉取：通过HTTP访问方式，从URL地址定时拉取拓扑关系，需要设置定时拉取时间间隔。每次拉取的拓扑数据都会覆盖前一次的拓扑数据。
  - 手动上传：通过浏览本地的文本文件，把拓扑关系一次性导入到系统中。数据格式支持TXT、CSV 和 JSON文本文件格式。
点击保存按钮，完成配置。

说明：Tingyun类型数据源会默认新建两个实例，这两个实例不允许变更。

系统支持第三方的指标源数据接入，目前支持Prometheus、Zabbix、OpenMetricsAPI。

要接入第三方系统的指标，请按照以下步骤进行操作：

在左侧导航栏中依次选择管理>集成>数据接入，进入数据接入页面。
单击指标页签，在左侧区域选择基调听云或第三方，然后在右侧区域单击新增数据源按钮。

也可以直接单击右侧的新增数据源按钮，页面会提示选择第三方系统，然后单击下一步，进入到新建指标页面。
配置数据源。
- Prometheus：输入名称、选择探针，并根据配置说明进行操作即可。
- Zabbix：输入名称、选择探针、Zabbix的URL、认证方式以及Zabbix API。
- OpenMetricsAPI：支持以OpenMetrics协议的方式接入第三方的指标数据。输入名称、选择探针，同时按照配置说明中的描述进行配置即可。
单击保存，完成配置。

业务模块支持通过OpenAPI方式接入外部数据，以丰富业务感知分析的数据，引入的外部数据可和操作数据结合满足更丰富的业务场景分析。

接入业务数据，请按照以下步骤进行操作：

在左侧导航栏中依次选择管理>集成>数据接入，进入数据接入页面。
单击业务页签，在左侧区域选择OpenAPI（默认为选中状态)，然后在右侧区域单击新增数据源按钮。

也可以直接单击右侧的新增数据源按钮，页面会提示选择OpenAPI类型，然后单击下一步，进入到新建OpenAPI页面。
配置数据源。
- 基本配置：输入API名称，便于识别接入的业务数据。支持中英文以及特殊字符。
- 选择表结构创建方式。接入的业务数据以表的形式进行存储。
  - 自动创建：以上传的JSON对象的key为字段名，自动解析value的数据类型为字段类型。
  - 手动创建：该方式需设置API字典参数，来决定要接入的字段。标识参数是指可唯一标识一行数据的参数，可设置多个。输入参数名时需要和API中data的key保持一致。
单击保存，系统会自动生成属于该接口的Token、公钥和版本号。

配置说明部分会展示API、必选的平台参数和数据格式供用户参考。关于详细的API接入规范，可单击右上角的查看API接入规范，下载文档进行了解。单击右上角的API DEMO，可下载API请求示例程序，使用该程序调用API。