meteorhacks/kmdb

Name: kmdb

Owner: meteorhacks

Description: metric database powered by kdb

Created: 2015-05-27 05:51:45.0

Updated: 2016-06-25 08:50:40.0

Pushed: 2015-07-10 04:10:20.0

Homepage:

Size: 195

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

KMDB

A database only good for storing metric data. KMDB is powered by kdb, a lightweight database engine which is optimized for high write throughput.

Configuration

Create a configuration JSON file with following fields. All fields are mandatory. When starting the server, use kmdb -config /path/to/config.json to use your settings.

"remote_debug": true,
"listen_address": ":3000",

"databases": {
    "test": {
        "database_path": "/tmp/test-db",
        "index_depth": 4,
        "payload_size": 16,
        "payload_resolution": 60000000000,
        "bucket_duration": 3600000000000,
        "segment_size": 100000
    }
}

Docker

KMDB uses memory mapping to increase write performance therefore for KMDB to work the IPC_LOCK linux capability must be enabled when running inside docker. This can be done easily by adding --cap-add=IPC_LOCK when starting the container.

er run -d \
 3000:3000 \
 /data:/data \
 /etc/kmdb.json:/etc/kmdb.json \
cap-add=IPC_LOCK \
teorhacks/kmdb

---

Note: KMDB is under active development therefor not suitable for production use.