06-influxdb2其他知识

## 一、influxdb task

influxdb支持创建任务，可选周期执行或以cron表达式定义的时间执行。执行任务的内容为自定义的一段flux脚本。
 **通过UI创建一个简单任务**
 选择Task选项卡 > create task > 定义task执行规则，编写task脚本。

![img](https://tqls-mrdoc.oss-cn-beijing.aliyuncs.com/mr-doc/20880653-8035130791416d27.webp)

## 二、influxdb alerts

alerts中有三个核心概念 Checks，Notification Endpoint 和 Notification Rules。
 Checks 负责检测报警并将检测结果分级。
 Notification Endpoint 负责定义通知切点，即报警通知会发送到哪里
 Notification Rules 负责绑定 Checks 和 Notification Endpoint

### Checks

Checks 分为两种，一种是threshold Checks 一种是deadman Checks，Checks会周期执行一段指定查询脚本，并查看结果是否匹配其Checks规则，一旦匹配就会生成一条Checks记录。
 **threshold checks**
 threshold alert 为某个点指定阈值和比较规则（大于小于等），判断查询结果是否符合阈值表达式

![img](https://tqls-mrdoc.oss-cn-beijing.aliyuncs.com/mr-doc/20880653-1f5cd2eb6bff1084.webp)

threshold-check.png

**deadman alert**
 deadman alert 在测试时并没有符合预期，按照官方的介绍应该时当某一个点在规定时间内没有上报数据就会报警。测试时未得到预期结果

### Notification Endpoint

**定义 Notification Endpoint**

![img](https://tqls-mrdoc.oss-cn-beijing.aliyuncs.com/mr-doc/20880653-be301c322d9a3032.webp)

notification-endpint.png

### Notification Ruls

**定义 Notification Ruls**

![img](https://tqls-mrdoc.oss-cn-beijing.aliyuncs.com/mr-doc/20880653-4fd2d622f7a0d188.webp)

Notification Rul.png

定义绑定 Checks 和 Notification Endpoint 后当Check产生相应等级的报警后等待Notification Rules检测周期到即可将预先定义好的报警信息推送到通知节点

## 三、Postman Influx http api 调用

### 鉴权设置

进入Postman Collections 或单个请求的 Authorization 功能选项。

1. Type 选择API Key
2. Key 填入 Authorization
3. Value 填入 Token YOUR_TOKEN
4. Add to 选择Header

例：

![img](https://tqls-mrdoc.oss-cn-beijing.aliyuncs.com/mr-doc/20880653-e45687f7fd95f44a.webp)

postman.png

随后在访问influxdb的各项http API

### Query API

鉴权后调用 `/api/query` 可使用查询语句进行查询。

**如何使用**

- 将`org`或`orgID`通过url传参的形式添加到参数中
- 添加或修改Accept请求头为 `appliction/csv`(Postman中不需要添加)
- 添加或修改Content-Type请求头为 `application/vnd.flux`
- 将查询语句放在请求体中

### Write API

- 将`org`,`bucket` 通过url传参形式添加到参数中
- 添加或修改Accept请求头为 `appliction/json`(实测该接口不反回数据，可选填)
- 添加或修改Content-Type请求头为 `text/plain`
- 将Line Protocol的数据添加到请求体中

## 四、数据备份与恢复

### 备份

influxdb 使用 influx 命令进行数据和元数据的备份。1.x 和 2.x备份数据不兼容。以下为2.x的备份方法

```shell
influx backup <back-path> -t <root-token>

# 例：
influx backup ./back -t 58s6gl9hD8lk-AS_i6mUaYMMCGe6N1vIfVpJUo2xJ2HkWMlWx2yp7r7IKZsyF6h8vQdTPfIpGyHtbALayLgUQw==
```

token 可以在管理界面Tokens处找到

### 恢复

influx 使用influx命令进行数据恢复

```shell
influx restore <back-path>
#例：
influx restore ./back
```

恢复指定 bucket

```shell
influx restore <back-path> --bucket exmple-bucket
```

如果恢复的 bucket 名称已经在现有数据库中存在 则使用--new-bucket 为恢复的数据库指定一个新名称并将数据恢复到新名称的bucket中

### 关于无法启动UI管理界面的问题

#### 问题描述

这个不一定每个人都能遇到。笔者的电脑现在无法启动UI界面，但在虚拟机中是可以启动的。推测是我在第一次启动时在配置文件中手动指定了静态资源位置，而此时该位置是一个无效路径。

#### 解决办法

UI界面在初始化过程中报错可自己下载UI项目手动构建后，由influx配置文件指定静态资源路径解决。

```shell
git clone https://github.com/influxdata/ui.git

yarn build
```

需要注意的是无论是build还是 start指令都要在linux或mac os 上进行，因为构建和启动指令包含对 `export` 指令的调用 windows使用`set`无法兼容。期间可能会有网络问题，可以根据报错手动下在所需文件放在根目录下即可。

构建完成后在influxd启动目录创建 config.yml 文件并键入以下内容

```yaml
assets-path: 构建结果路径
```

influxdb默认会读取启动目录下的config.yml文件，启动后前端访问的就是自构建的UI了