Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chengshiwen/influxdb-cluster
InfluxDB Cluster - Open Source Alternative to InfluxDB Enterprise
https://github.com/chengshiwen/influxdb-cluster
clustering high-availability influxdb influxdb-cluster influxdb-enterprise
Last synced: 29 days ago
JSON representation
InfluxDB Cluster - Open Source Alternative to InfluxDB Enterprise
- Host: GitHub
- URL: https://github.com/chengshiwen/influxdb-cluster
- Owner: chengshiwen
- License: mit
- Created: 2022-02-18T06:18:38.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-29T06:57:32.000Z (about 2 months ago)
- Last Synced: 2024-10-04T18:04:48.286Z (about 1 month ago)
- Topics: clustering, high-availability, influxdb, influxdb-cluster, influxdb-enterprise
- Language: Go
- Homepage: https://github.com/chengshiwen/influxdb-cluster/wiki
- Size: 2.56 MB
- Stars: 857
- Watchers: 37
- Forks: 145
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# InfluxDB Cluster
[](https://github.com/chengshiwen/influxdb-cluster/wiki)
[](https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng)
[](https://github.com/chengshiwen/influxdb-cluster/blob/master/LICENSE)
[](https://github.com/chengshiwen/influxdb-cluster/releases)
[](https://hub.docker.com/r/chengshiwen/influxdb)
InfluxDB Cluster - An Open-Source Distributed Time Series Database, Open Source Alternative to InfluxDB Enterprise
## An Open-Source, Distributed, Time Series Database
InfluxDB Cluster is an open source **time series database** with
**no external dependencies**. It's useful for recording metrics,
events, and performing analytics.
InfluxDB Cluster is inspired by [InfluxDB Enterprise](https://docs.influxdata.com/enterprise_influxdb/v1/), [InfluxDB v1.8.10](https://github.com/influxdata/influxdb/tree/v1.8.10) and [InfluxDB v0.11.1](https://github.com/influxdata/influxdb/tree/v0.11.1), aiming to replace InfluxDB Enterprise.
InfluxDB Cluster is easy to maintain, and can be updated in real time with upstream [InfluxDB 1.x](https://github.com/influxdata/influxdb/tree/master-1.x).
## Features
* Built-in [HTTP API](https://docs.influxdata.com/enterprise_influxdb/v1/guides/write_data/) so you don't have to write any server side code to get up and running.
* Data can be tagged, allowing very flexible querying.
* SQL-like query language.
* Clustering is supported out of the box, so that you can scale horizontally to handle your data. **Clustering is currently in production state.**
* Simple to install and manage, and fast to get data in and out.
* It aims to answer queries in real-time. That means every data point is
indexed as it comes in and is immediately available in queries that
should return in < 100ms.
## Clustering
> **Note**: The clustering of InfluxDB Cluster is exactly the same as that of InfluxDB Enterprise.
Please see: [Clustering in InfluxDB Enterprise](https://docs.influxdata.com/enterprise_influxdb/v1/concepts/clustering/)
Architectural overview:
Network overview:
## Installation
We recommend installing InfluxDB Cluster using one of the [pre-built releases](https://github.com/chengshiwen/influxdb-cluster/releases).
Complete the following steps to install an InfluxDB Cluster in your own environment:
1. [Install InfluxDB Cluster meta nodes](https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#meta-node-setup)
2. [Install InfluxDB Cluster data nodes](https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#data-node-setup)
> **Note**: The installation of InfluxDB Cluster is exactly the same as that of InfluxDB Enterprise.
## Docker Quickstart
Download [docker-compose.yml](./docker/quick/docker-compose.yml), then start 3 meta nodes and 2 data nodes by `docker compose`:
```
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
```
Stop and remove them when they are no longer in use:
```
docker compose down -v
```
## Getting Started
### Create your first database
```
curl -XPOST "http://influxdb-data-01:8086/query" --data-urlencode "q=CREATE DATABASE mydb WITH REPLICATION 2"
```
### Insert some data
```
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'
```
> **Note**: `consistency=[any,one,quorum,all]` sets the write consistency for the point. `consistency` is `one` if you do not specify consistency. See the [Insert some data / Write consistency](https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#insert-some-data) for detailed descriptions of each consistency option.
### Query for the data
```
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"
```
### Analyze the data
```
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'"
```
## Documentation
* View the wiki: [English Document](https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng) / [中文文档](https://github.com/chengshiwen/influxdb-cluster/wiki/Home).
* Read more about the [design goals and motivations of the project](https://docs.influxdata.com/enterprise_influxdb/v1/).
* Follow the [getting started guide](https://docs.influxdata.com/enterprise_influxdb/v1/introduction/getting-started/) to learn the basics in just a few minutes.
* Learn more about [clustering](https://docs.influxdata.com/enterprise_influxdb/v1/concepts/clustering/) and [glossary](https://docs.influxdata.com/enterprise_influxdb/v1/concepts/glossary/).
## Contributing
If you're feeling adventurous and want to contribute to InfluxDB Cluster, see our [CONTRIBUTING.md](./CONTRIBUTING.md) for info on how to make feature requests, build from source, and run tests.
## Licensing
See [LICENSE](./LICENSE) and [DEPENDENCIES.md](./DEPENDENCIES.md).
## Looking for Support?
- Email: [email protected]
- [GitHub Issues](https://github.com/chengshiwen/influxdb-cluster/issues)
- [Community & Communication](https://github.com/chengshiwen/influxdb-cluster/wiki/Home-Eng#community--communication) / [社区 & 交流](https://github.com/chengshiwen/influxdb-cluster/wiki#社区--交流)