chengshiwen/influxdb

InfluxDB Cluster

!GitHub stars

InfluxDB Cluster - 开源分布式时序数据库，InfluxDB Enterprise的开源替代方案

开源、分布式时序数据库

InfluxDB Cluster是一个开源时序数据库，无外部依赖。它适用于记录指标、事件和执行分析。

InfluxDB Cluster受InfluxDB Enterprise、https://github.com/influxdata/influxdb/tree/v1.8.10%E5%92%8Chttps://github.com/influxdata/influxdb/tree/v0.11.1%E5%90%AF%E5%8F%91%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%9B%BF%E4%BB%A3InfluxDB Enterprise。

InfluxDB Cluster易于维护，可实时更新上游https://github.com/influxdata/influxdb/tree/master-1.x%E3%80%82

核心功能与特性

• 内置HTTP API，无需编写任何服务器端代码即可快速启动和运行。
• 数据可标记，支持灵活查询。
• 类SQL查询语言。
• 内置集群支持，可水平扩展以处理数据。集群目前处于生产状态。
• 安装和管理简单，数据写入和读取速度快。
• 旨在实时响应查询，每个数据点在进入时即被索引，查询响应时间通常<100ms。

集群

注意：InfluxDB Cluster的集群与InfluxDB Enterprise的集群完全相同。

详见：InfluxDB Enterprise集群

架构概览：

!https://github.com/chengshiwen/influxdb-cluster/wiki/image/architecture.png

网络概览：

!architecture

安装

建议使用https://github.com/chengshiwen/influxdb-cluster/releases%E5%AE%89%E8%A3%85InfluxDB Cluster。

在自己的环境中安装InfluxDB Cluster，请完成以下步骤：

1. https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#meta-node-setup
2. https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#data-node-setup

注意：InfluxDB Cluster的安装与InfluxDB Enterprise完全相同。

Docker快速启动

下载https://github.com/chengshiwen/influxdb-cluster/tree/master/docker/quick/docker-compose.yml%EF%BC%8C%E7%84%B6%E5%90%8E%E9%80%9A%E8%BF%87%60docker-compose%60%E5%90%AF%E5%8A%A83%E4%B8%AA%E5%85%83%E8%8A%82%E7%82%B9%E5%92%8C2%E4%B8%AA%E6%95%B0%E6%8D%AE%E8%8A%82%E7%82%B9%EF%BC%9A

bash
docker-compose up -d
docker exec -it influxdb-meta-01 bash
influxd-ctl add-meta influxdb-meta-01:8091
influxd-ctl add-meta influxdb-meta-02:8091
influxd-ctl add-meta influxdb-meta-03:8091
influxd-ctl add-data influxdb-data-01:8088
influxd-ctl add-data influxdb-data-02:8088
influxd-ctl show

不再使用时停止并移除容器：

bash
docker-compose down -v

快速入门

创建第一个数据库

bash
curl -XPOST "http://influxdb-data-01:8086/query" --data-urlencode "q=CREATE DATABASE mydb WITH REPLICATION 2"

插入数据

bash
curl -XPOST "http://influxdb-data-01:8086/write?db=mydb" \
-d 'cpu,host=server01,region=uswest load=42 1434055562000000000'

curl -XPOST "http://influxdb-data-02:8086/write?db=mydb&consistency=all" \
-d 'cpu,host=server02,region=uswest load=78 1434055562000000000'

curl -XPOST "http://influxdb-data-02:8086/write?db=mydb&consistency=quorum" \
-d 'cpu,host=server03,region=useast load=15.4 1434055562000000000'

注意：consistency=[any,one,quorum,all]设置数据点的写入一致性。若未指定，默认值为one。每个一致性选项的详细说明参见https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#insert-some-data%E3%80%82

查询数据

bash
curl -G "http://influxdb-data-02:8086/query?pretty=true" --data-urlencode "db=mydb" \
--data-urlencode "q=SELECT * FROM cpu WHERE host='server01' AND time < now() - 1d"

分析数据

bash
curl -G "http://influxdb-data-02:8086/query?pretty=true" --data-urlencode "db=mydb" \
--data-urlencode "q=SELECT mean(load) FROM cpu WHERE region='uswest'"

文档

• 查看Wiki：https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng / https://github.com/chengshiwen/influxdb-cluster/wiki/Home%E3%80%82
• 了解项目的设计目标和动机。
• 按照快速入门指南在几分钟内了解基础知识。
• 深入学习集群和术语表。

贡献

如果您有兴趣为InfluxDB Cluster贡献代码，请查看https://github.com/chengshiwen/influxdb-cluster/blob/master/CONTRIBUTING.md%EF%BC%8C%E4%BA%86%E8%A7%A3%E5%A6%82%E4%BD%95%E6%8F%90%E5%87%BA%E5%8A%9F%E8%83%BD%E8%AF%B7%E6%B1%82%E3%80%81%E4%BB%8E%E6%BA%90%E7%A0%81%E6%9E%84%E5%BB%BA%E5%92%8C%E8%BF%90%E8%A1%8C%E6%B5%8B%E8%AF%95%E3%80%82

许可

参见https://github.com/chengshiwen/influxdb-cluster/blob/master/LICENSE%E5%92%8Chttps://github.com/chengshiwen/influxdb-cluster/blob/master/DEPENDENCIES.md%E3%80%82

寻求支持？

• ：
• https://github.com/chengshiwen/influxdb-cluster/issues
• https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#community--communication / https://github.com/chengshiwen/influxdb-cluster/wiki#%E7%A4%BE%E5%8C%BA--%E4%BA%A4%E6%B5%81