Getting Started with DalmatinerDB
This page will help you get started with DalmatinerDB. You'll be up and running in a jiffy!
A full Dalmatiner setup consists of multiple components. Below is an architecture diagram with all the components available. Not all are required so it's worth reading what each piece does.
Testing DalmatinerDB
For testing we provide an all-in-one docker image that is build off the dev branch of dalmatinerdb and contains most components preconfigured.
Please note that since it's Linux you're probably not getting ZFS unless you have your docker host configured to use it.
Components
DalmatinerDB
The main metric store. Follow the Installation manual to install it. (required)
DalmatinerFE
The front end that contains an HTTP endpoint, the query engine as well as a simple UI. You can follow the Installation manual to install it. (required)
Dalmatiner Proxy
The Dalmatiner Proxy allows you to use different protocols to store data in DB, it is not strictly required but it helps getting started with Dalmatiner when you already have other services set up. (recommended)
Supported formats
- Graphite
- InfluxDB (http)
- Prometheus (including scraping)
- Metrics2.0
- OpenTSDB
PostgresQL
Postgres is used for metric metadata (tags / labels). You can run Dalmatiner with a variety of indexers, however, we strongly advise using Postgres. You can follow the Installation manual to install it. (recommended)
Tachyon
Not strictly a part of Dalmatiner. Tachyon is an illumos Monitoring system that was built around DalmatinerDB and uses it to store it's data. (optional)
Libraries
Various client libraries exist for DalmatinerDB. Check out Github for the latest versions
Recommended Configuration
Single Node Installations
The following configuration has been benchmarked at an average of 3 million metrics per second write performance.
- 16 CPU, 60GB memory, SSD disk
- ZFS filesystem on SSD disk for
platform_data_dir
in dalmatinerdb.conf ring_size = 16
(in dalmatinerdb.conf)cache_points = 600
(in dalmatinerdb.con)
For new installations we recommend installing the DalmatinerDB, DalmatinerFE, Dalmatiner Proxy and Grafana on the same server. These can be split out later as required to help scale.
Updated about 7 years ago