TDengine and Tremor Solution for System Monitoring and Alerting

Heinz Gies (Tremor)
Heinz Gies (Tremor), Shuduo Sang
Share on LinkedIn

Working with high-volume metrics is a challenging endeavor, but one that is becoming more and more essential in a world of microservices, serverless workflows, and IoT devices.

Both TDengine and Tremor touch parts of this space, and together they create a highly effective solution and share a lot of design principles.

Without diving too deep into what either of them does, TDengine is a high-performance time-series database (TSDB) using SQL as its query language. Tremor is a high-performance event processing engine using, you might have guessed it, a SQL dialect for its configuration.

There are many uses where these two technologies complement each other, including filtering, normalization, pre-aggregation, and dual writing, but the most interesting one, and the one we’re going to look at in this post, is alerting.

Before we dive into the how, let’s talk about why this is such a challenging task. Two things are needed for alerting to work: real-time processing for triggering the alert and fast persistence to get the context for the alert.

Without real-time processing of incoming events, alerting requires periodically fetching the state from the store, checking against the alerting condition, and then triggering the alert. This introduces latency and, with scale, will put a significant tax on the database.

On the other hand, without a fast storage system, alerting is limited to a “point in time” observation, either lacking the context that makes an alert actionable or requiring an unreasonable amount of memory to keep the context in scope just in case of the rare event of an alert.

You can see how TDengine and Tremor complement each other here, so let’s dive in and build something. We’ll start with the basic setup from Tremor’s metrics guide. Click here to view the code. This sets us up with a quick runnable combination of TDengine, Tremor, Grafana, and Telegraf as a data collector.

Let’s look at one of our aggregated data points:


To turn this into an alert, we first need to figure out what we want to alert on. So let’s come up with a condition: “the system’s CPU idle is less than 95% for at least a minute”.

This can be turned into a SELECT statement like this:

select event from normalize
where match event of
  case %{measurement == "cpu", field == "usage_idle", tags ~= %{cpu == "cpu-total", `window` == "1min"}, stats ~= %{mean < 95}} => true
  case _ => false
end into alert;

One problem this leaves is that the alert will be triggered over and over again as long as the condition is met — not a helpful state for the operational team having to look after the systems. To solve this, we can throw in a simple deduplication script:

  # Initiate state
  match state of
    # If state wasn't set set it
    case null =>
      let state = {"last": {}, "this": {}, "ingest_ns": ingest_ns}
    # If we're two times beyond the timestamp we can just re-initialize
    case _ when ingest_ns - state.ingest_ns > swap_after * 2  =>
      let state = {"last": {}, "this": {}, "ingest_ns": ingest_ns}
    # If we're one time over the `swap_after` we:
    #  * move this ->  last
    #  * re-initialize`this`
    #  * set `ingest_ns` for the next round
    case _ when ingest_ns - state.ingest_ns > swap_after  =>
      let state.ingest_ns = ingest_ns;
      let state.last = state.this;
      let state.this = {}
    case _ => null

  # If we have seen this alert before drop it
  match present state.this[] of
    case true => drop
    case _ => null

  # We didn't see this event before remember it
  let state.this[] = true;

  # If we saw it in last, we also drop it
  match present state.last[] of
    case true => drop
    case _ => event

Last but not least, we can format the alert into something that alerta can understand:

  "environment": "Production",
  "event": "CPU",
  "group": "Host",
  "origin": "telegraf",
  "service": ["host"],
  "severity": "major",
  "text": "#{ event.measurement } #{ event.field } exceeds maximum of 99%",
  "type": "exceptionAlert",
  "value": "idle < 99%"
} from dedup into alert;

Here is a screenshot of the system monitoring dashboard:

In the demo, it’s sent to alerta, but we could equally send it to any other HTTP endpoint for alerting to show alerts in Slack, Discord, or forward them to PagerDuty.

  • Heinz Gies (Tremor)
    Heinz Gies

    Heinz Gies is a Senior Staff Engineer at Wayfair, working as a core maintainer of the on the Tremor Project.

  • Shuduo Sang
    Shuduo Sang

    Shuduo Sang is an open-source software veteran at TDengine, working on magnifying TDengine capabilities to connect easily with more third-party software for IoT and DevOps users. He and his team develop and maintain the multiple client libraries and tools for TDengine such as taosBenchmark and taosAdapter. Before joining TDengine, he worked on open-source and Linux at Canonical and Intel.