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.

1197

Dalmatiner Architecture

📘

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.