homework-jianmu/docs/zh/06-advanced/06-TDgpt/03-management.md

6.5 KiB
Raw Blame History

title sidebar_label
Anode 管理 Anode 管理

import PkgListV3 from "/components/PkgListV3";

启停服务

在 Linux 系统中,安装 Anode 以后会自动创建 taosanoded 服务。可以使用 systemd 来管理 Anode 服务,使用如下命令启动/停止/检查 Anode。

systemctl start  taosanoded
systemctl stop   taosanoded
systemctl status taosanoded

启停时间序列基础模型服务

考虑到时序基础模型服务,需要较大的资源。避免启动过程中资源不足导致的启动失败,暂不提供自动启动方式。如果您希望体验时序基础模型服务,需要手动执行如下命令

# 启动涛思时序数据基础模型
start-tdtsfm

# 启动 Time-MoE 基础模型
start-timer-moe
# 停止涛思时序数据基础模型
stop-tdtsfm

# 停止 Time-MoE 基础模型
stop-timer-moe

目录及配置说明

安装完成后Anode 主体目录结构如下:

目录/文件 说明
/usr/local/taos/taosanode/bin 可执行文件目录
/usr/local/taos/taosanode/resource 资源文件目录,链接到文件夹 /var/lib/taos/taosanode/resource/
/usr/local/taos/taosanode/lib 库文件目录
/usr/local/taos/taosanode/model/ 模型文件目录,链接到文件夹 /var/lib/taos/taosanode/model
/var/log/taos/taosanode/ 日志文件目录
/etc/taos/taosanode.ini 配置文件

配置说明

Anode 的服务需要使用 uWSGI 驱动驱动运行,因此 Anode 和 uWSGI 的配置信息共同存放在相同的配置文件 taosanode.ini 中,该配置文件默认位于 /etc/taos/ 目录下。 具体内容及配置项说明如下:

[uwsgi]

# Anode RESTful service ip:port
http = 127.0.0.1:6090

# base directory for Anode python files do NOT modified this
chdir = /usr/local/taos/taosanode/lib

# initialize Anode python file
wsgi-file = /usr/local/taos/taosanode/lib/taos/app.py

# pid file
pidfile = /usr/local/taos/taosanode/taosanode.pid

# conflict with systemctl, so do NOT uncomment this
# daemonize = /var/log/taos/taosanode/taosanode.log

# uWSGI log files
logto = /var/log/taos/taosanode/taosanode.log

# uWSGI monitor port
stats = 127.0.0.1:8387

# python virtual environment directory, used by Anode
virtualenv = /usr/local/taos/taosanode/venv/

[taosanode]
# default taosanode log file
app-log = /var/log/taos/taosanode/taosanode.app.log

# model storage directory
model-dir = /usr/local/taos/taosanode/model/

# default log level
log-level = INFO

提示 请勿设置 daemonize 参数,该参数会导致 uWSGI 与 systemctl 冲突,从而导致 Anode 无法正常启动。 上面的示例配置文件 taosanode.ini 只包含了使用 Anode 提供服务的基础配置参数,对于 uWSGI 的其他配置参数的设置及其说明请参考 uWSGI 官方文档

Anode 运行配置主要是以下:

  • app-log: Anode 服务运行产生的日志,用户可以调整其到需要的位置
  • model-dir: 采用算法针对已经存在的数据集的运行完成生成的模型存储位置
  • log-level: app-log文件的日志级别

Anode 基本操作

对于 Anode 的管理,用户需要通过 TDengine 的命令行接口 taos 进行。因此下述介绍的管理命令都需要先打开 taos, 连接到 TDengine 运行实例。

创建 Anode

CREATE ANODE {node_url}

node_url 是提供服务的 Anode 的 IP 和 PORT 组成的字符串, 例如:create anode '127.0.0.1:6090'。Anode 启动后还需要注册到 TDengine 集群中才能提供服务。不建议将 Anode 同时注册到两个集群中。

查看 Anode

列出集群中所有的数据分析节点,包括其 FQDN, PORT, STATUS等属性。

SHOW ANODES;

taos> show anodes;
     id      |              url               |    status    |       create_time       |       update_time       |
==================================================================================================================
           1 | 192.168.0.1:6090               | ready        | 2024-11-28 18:44:27.089 | 2024-11-28 18:44:27.089 |
Query OK, 1 row(s) in set (0.037205s)

查看提供的时序数据分析服务

SHOW ANODES FULL;

taos> show anodes full;                                                      
     id      |            type            |              algo              | 
============================================================================ 
           1 | anomaly-detection          | grubbs                         | 
           1 | anomaly-detection          | lof                            | 
           1 | anomaly-detection          | shesd                          | 
           1 | anomaly-detection          | ksigma                         | 
           1 | anomaly-detection          | iqr                            | 
           1 | anomaly-detection          | sample_ad_model                | 
           1 | forecast                   | arima                          | 
           1 | forecast                   | holtwinters                    | 
           1 | forecast                   | tdtsfm_1                       | 
           1 | forecast                   | timemoe-fc                     | 
Query OK, 10 row(s) in set (0.028750s)                                       

列表中的算法分为两个部分,分别是异常检测算法集合,包含六个算法模型,四个预测算法集。算法模型如下:

类型 模型名称 说明
异常检测 grubbs 基于数学统计学检测模型
异常检测 lof 基于密度的检测模型
异常检测 shesd 季节性ESD算法模型
异常检测 ksigma 数学统计学检测模型
异常检测 iqr 数学统计学检测模型
预测分析 sample_ad_model 基于自编码器的异常检测示例模型
预测分析 arima 移动平均自回归预测算法
预测分析 holtwinters 多次指数平滑预测算法
预测分析 tdtsfm_1 涛思时序数据基础模型 v1.0 版本
预测分析 timemoe-fc Time-MoE时序基础模型的预测能力

相关算法的具体介绍和使用说明见后续章节。

刷新集群中的分析算法缓存

UPDATE ANODE {anode_id}
UPDATE ALL ANODES

删除 Anode

DROP ANODE {anode_id}

删除 Anode 只是将 Anode 从 TDengine 集群中删除,管理 Anode 的启停仍然需要使用 systemctl 命令。卸载 Anode 则需要使用上面提到的 rmtaosanode 命令。