通过安装包快速体验

TDengine IDMP 提供了丰富的功能，本文档将带领您通过安装包完成 TDengine IDMP 的安装和启动。在导入示例场景数据后，即可轻松体验元素浏览、AI 面板生成和 AI 分析等功能。

安装

TDengine IDMP 支持多种安装、部署方式，在不同的操作系统和架构下，都能够体验其强大的功能带来的便利。对操作系统和架构的支持，详见部署规划。以下步骤将以 Linux 系统为例，演示如何下载、安装并启动 TDengine IDMP.

1. TDengine IDMP 依赖 TDengine TSDB-Enterprise 3.3.7.0+, 在安装 TDengine IDMP 前，请确保您已安装并启动了 TDengine TSDB-Enterprise 服务。如果尚未安装，请参考：使用安装包快速体验 TDengine TSDB。

2. 如果您期望体验时序数据预测的功能，则需要安装 TDgpt, 请参考：安装包部署 TDgpt.

3. 前往 TDengine 下载中心的 TDengine IDMP 页面。

4. 选择最新版本的 .tar.gz 类型的装包下载。

5. 解压并执行安装脚本，以完成安装：

   mkdir tdengine-idmp-enterprise
   tar xvf tdengine-idmp-enterprise-*.tar.gz \
     --strip-components=1 \
     -C tdengine-idmp-enterprise
   cd tdengine-idmp-enterprise
   ./install.sh
   

6. 配置 TDengine TSDB-Enterprise 连接。用编辑器打开 TDengine IDMP 的配置文件，默认位于 /usr/local/taos/idmp/config/application.yml，在 tda.default-connection 下，配置 TDengine TSDB-Enterprise 的连接信息，示例如下：

   tda:
     default-connection:
       enable: true
       auth-type: UserPassword # can be set to UserPassword or Token
       url: http://192.168.1.100:6041
       username: root
       password: taosdata
   

   其中：

   • auth-type: 认证方式，支持 UserPassword 和 Token 两种方式，默认为方式 UserPassword
   • url: 为 TDengine TSDB-Enterprise 中 taosAdapter 组件的 IP 地址和端口号，端口号默认为 6041
   • username 和 password: 为 TDengine TSDB-Enterprise 的用户名和密码，默认为 root 和 taosdata

7. 测试 TDengine TSDB-Enterprise 连接。在终端中，可以使用 curl 命令测试 TDengine TSDB-Enterprise 连接的连通性，示例如下：

   curl --request POST \
     --user root:taosdata \
     --url http://192.168.1.100:6041/rest/sql \
     --data 'show databases;'
   

   如果连接成功，您将看到 TDengine TSDB-Enterprise 的数据库列表。

8. 启动 TDengine IDMP 服务：

   svc-tdengine-idmp start
   

至此，TDengine IDMP 服务已成功启动。您可以在浏览器输入以下地址访问：http://ip:6042,
请将 ip 替换为真实的主机 IP 地址，如果在本地运行，则可以直接访问 http://localhost:6042。

关于服务启动、停止更详细的操作指南，请您参考使用安装包部署章节。为了简化安装包的部署，您还可以使用我们提供的 Ansible Playbook 来完成安装和配置，具体步骤请参考使用 Ansible Playbook 部署章节。

1. 安装过程中，如果遇到以下错误 “Failed to install TDengine IDMP dependencies from /usr/local/taos/idmp/chat/requirements.txt”, 应该如何解决？
   • IDMP 安装过程中，需要访问互联网，以安装 AI 相关的 Python 依赖，请确保您的系统已连接互联网。
   • 网络连接正常的情况下，请确保 PyPI 仓库可以正常访问。在国内的网络中，建议配置 PyPI 镜像源来加速下载，例如：清华大学的 PyPI 镜像源，具体命令如下：

     pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
     

   • 更详细的安装日志，请参考：/tmp/tdengine_chat_dep_install.log

激活

1. 首次访问时，您需要激活服务。在填写“邮箱”和“组织”后，点击“获取激活码”按钮，系统会向您填写的邮箱发送一封激活邮件，输入邮件中的激活码后，点击“激活”按钮，即可完成激活，您将获得 15 天的免费试用期。
2. 激活码验证通过后，会弹出“隐私配置”对话框，您可以根据需求选择信息采集项，采集的信息将帮助我们改进产品，您的业务及生产数据绝不会被采集，配置完成后，请点击“同意”按钮。

配置用户信息

1. 激活产品后，将进入用户信息配置页面。
2. 请根据系统提示，填写您的姓名和手机号。
3. 请设置系统的登录密码。
4. 密码验证通过后，就完成了用户信息的配置，点击“继续”，将自动跳转到加载示例场景页面。

创建实例

1. 完成用户信息配置后，请点击“继续”按钮，系统会弹出 TDengine 实例类型选择框。
2. 在实例类型选择框中，请选择“IDMP(工业数据管理平台)”，页面将自动跳转至实例配置页面。
3. 在实例配置页面，请分别配置 IDMP 实例和 TSDB 实例的名称和计费方案。
4. 请在阅读 TDengine 云服务的服务协议后，勾选同意。
5. 请点击“创建”按钮，等待创建实例完成后，系统将自动跳转至示例场景加载页面。

加载示例场景

为了帮助您快速上手，TDengine IDMP 内置了以下七大示例场景，您可以通过加载这些示例数据来体验系统的强大功能。

1. 公共事业：智能电表、智能水表
2. 卷烟制丝场景：卷烟厂制丝工艺
3. 车辆场景：物流企业车辆管理
4. 光伏场景：光伏发电站发电量监测
5. 油井场景：油田的油井产量监测
6. 污水处理场景：污水处理厂曝气工艺
7. 新能源集控场景：新能源集控中心监控

在以下示例中，我们将选用“公共事业”场景的数据进行演示：请您选中“公共事业”场景，然后点击“确认”按钮，系统会自动加载该场景的数据。加载过程可能需要几分钟的时间，请您耐心等待。

查看元素信息

加载示例场景后，您将进入 TDengine IDMP 的主 Web 界面，默认来到的是“元素浏览器”页面。您可以在这里查看和管理导入的元素信息。

1. 在侧边栏中选择“元素”，当“公共事业”场景加载完成后，即可查看其下具体的元素信息；
2. 在“公共事业”场景下，包含北京、河北、河南及其地级市或区县的电表、水表信息，您可以点击左侧的树形结构浏览不同的地理位置；
3. 选择北京-朝阳-三元桥街道-em-10这个元素，其代表的是北京市朝阳区三元桥街道编号为 10 的电表 (electricity meter)，点击顶部面包屑导航栏中的下拉列表，选择“通用”，查看其通用信息，可以看到其描述；在下拉列表中，选择“属性”，查看其属性信息，可以看到电流、电压等物理量属性。

体验 AI 生成面板

在 TDengine IDMP 中，最强大的功能之一是通过 AI 进行数据面板的自动生成。

1. 选择北京-朝阳-三元桥街道-em-10这个元素，点击顶部面包屑导航栏中的下拉列表，选择“面板”。
2. 如果“AI 推荐”已开启，即可在“面板”页面，查看到 AI 推荐的数据面板，点击“+ 更多推荐”按钮，系统会自动生成更多的面板供您选择。
3. 除此以外，您还可以在推荐面板下方的对话框中，以自然语言的方式告诉 AI 您想要的面板，例如：智能电表 em-10 过去 24 小时每分钟电压和电流的变化，以折线图的方式展示，然后点击“问我一下”按钮，AI 会自动生成您期望的面板。

体验 AI 分析

在 TDengine IDMP 中，AI 分析功能可以帮助您实时地感知数据的变化，当数据发生异常时，系统会自动产生相关的事件，并触发告警通知。

1. 选择北京-朝阳-三元桥街道-em-10这个元素，点击顶部面包屑导航栏中的下拉列表，选择“分析”。
2. 如果“AI 推荐”已开启，即可在“分析”页面，查看到 AI 推荐的问题，点击推荐问题右侧的“换一换”按钮，系统会自动更新推荐的问题。
3. 如果您对某个问题感兴趣，可以直接点击该问题的链接，进入分析创建页面，在这里，您可以对 AI 创建的分析进行进一步的配置和调整，确认后，点击“保存”按钮。
4. 除了使用 AI 推荐的分析以外，您还可以在推荐问题右侧的文本框中，以自然语言的方式告诉 AI 您想要分析的问题，
   例如：智能电表 em-10 的功率波动超过±20% 持续 30 分钟，产生“警告”级别的告警，并计算波动幅度，然后点击回车，AI 就会自动生成您期望的分析。

下一步

至此，我们已经通过导入示例数据体验了查看元素信息和 AI 自动成功面板以及分析的功能。接下来，您可以深入了解 TDengine IDMP 的更多功能和最佳实践，以便更好地利用其强大的数据管理和分析能力。