DDWiki/实践/后端/项目/12.阿里云InfluxDB使用.md

连接数据库

普通连接数据库：

./influx -ssl -username influxuser -password user@influxDB -host ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com -port 3242

以json展示：

./influx -ssl -username influxuser -password user@influxDB -host ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com -port 3242 -format=json

json以美观的方式展示

./influx -ssl -username influxuser -password user@influxDB -host ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com -port 3242 -format=json -pretty 

使用数据库

use dingding_influx
show measurements

新建measurement

创建名称是cpu的measurement:
INSERT cpu,host=serverA,region=us_west value=0.64
select host, region, value from cpu

创建名称是temperature的measurement:
INSERT temperature,machine=unit42,type=assembly external=25,internal=37
select * from temperature

删除measurement

删除measurement需要管理员权限

drop measurement cpu

通过Postman请求数据

请求

POST https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/query?u=influxuser&p=user@influxDB
Headers: Content-Type application/x-www-form-urlencoded
Body:
    db=dingding_influx
    q=select host, region, value from cpu

请求成功返回

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "cpu",
                    "columns": [
                        "time",
                        "host",
                        "region",
                        "value"
                    ],
                    "values": [
                        [
                            "2019-07-26T08:58:21.438818256Z",
                            "serverA",
                            "us_west",
                            0.64
                        ]
                    ]
                }
            ]
        }
    ]
}

如果请求没有的measurement返回

{
    "results": [
        {
            "statement_id": 0
        }
    ]
}

如果用户名错误、密码错误、用户名和密码同时错误返回

{
    "error": "authorization failed"
}

如果数据库错误

{
    "error": "error authorizing query: influxuser not authorized to execute statement 'SELECT host, region, value FROM cpu', requires READ on dingding_influ"
}

如果请求meaasurement中没有的字段，比如select hos, region, value from cpu返回

{
    "results": [
        {
            "statement_id": 0,
            "series": [
                {
                    "name": "cpu",
                    "columns": [
                        "time",
                        "hos",
                        "region",
                        "value"
                    ],
                    "values": [
                        [
                            "2019-07-26T08:58:21.438818256Z",
                            null,
                            "us_west",
                            0.64
                        ]
                    ]
                }
            ]
        }
    ]
}

如果q值为空返回

{
    "error": "missing required parameter \"q\""
}

时间戳格式

默认数据的时间格式是UTC，编码是RFC3339, 例如2015-08-04T19:05:14.318570484Z, 如果想反悔Unix格式，使用epoch字段。

epoch=h,m,s,ms,u,ns

分块Chunking

默认分块的数量是10000个数据据点，如果想改变分块大小，通过chunked和chunk_size设置。

chunked=true
chunk_size=20000

Postman写入数据

内部是以二进制方式写入数据。阿里云时序数据库API默认的写入时间是在5秒之内，如果一次性写入过多的数据，写入时间超过5秒，就不保证所有数据都被写入。所以当数据点比较多，比如有5000个数据点，需要把数据拆分。

单点写入数据点

POST https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/write?db=dingding_influx&u=influxuser&p=user@influxDB
Body: cpu_load_short,host=server01,region=us-west value=0.64 1434055562000000000

返回类型是204(No Content)。

多点写入数据点(没有成功)

POST https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/write?db=dingding_influx&u=influxuser&p=user@influxDB
Body: 
    cpu_load_short,host=server02,region=us-west value=0.55 1422568543702900257
    cpu_load_short,direction=in,host=server01,region=us-west value=2.0 1422568543702900257'

故障排除

使用浏览器打开。

总览页：
https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/debug/pprof?u=influxuser&p=user@influxDB

https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/debug/pprof/goroutine?u=influxuser&p=user@influxDB
https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/debug/pprof/heap?u=influxuser&p=user@influxDB
https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/debug/pprof/mutex?u=influxuser&p=user@influxDB
https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/debug/pprof/threadcreate?u=influxuser&p=user@influxDB

跟踪请求

默认跟踪10秒内的请求：
https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/debug/requests?u=influxuser&p=user@influxDB

跟踪1分钟内的请求：
https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/debug/requests?seconds=60&u=influxuser&p=user@influxDB

运行时的统计信息

使用/ping检查TSDB For InfluxDB®实例的状态和TSDB For InfluxDB®的版本。使用Postman请求。

GET https://ts-uf60ncdtuve8d41w3.influxdata.rds.aliyuncs.com:3242/ping?u=influxuser&p=user@influxDB
返回204 在Headers里面有版本信息