Riemann monitors distributed systems.

Riemann aggregates events from your servers and applications with a powerful stream processing language. Send an email for every exception in your app. Track the latency distribution of your web app. See the top processes on any host, by memory and CPU. Combine statistics from every Riak node in your cluster and forward to Graphite. Track user activity from second to second.

Riemann provides low-latency, transient shared state for systems with many moving parts.

Download Riemann 0.3.11

Debian Package
RPM Package (EL8)EL8 RPM Package (EL7)EL7 RPM Package (EL6)EL6
Gzipped Tarball

Powerful stream primitives

(where (or (service #"^api")
           (service #"^app"))
  (where (tagged "exception")
    (rollup 5 3600
      (email "dev@foo.com"))
    (else
      (changed-state
        (email "ops@foo.com")))))

Riemann streams are just functions which accept an event. Events are just structs with some common fields like :host and :service You can use dozens of built-in streams for filtering, altering, and combining events, or write your own.

Since Riemann's configuration is a Clojure program, its syntax is concise, regular, and extendable. Configuration-as-code minimizes boilerplate and gives you the flexibility to adapt to complex situations.

I wrote Riemann for operations staff trying to keep a large, dynamic infrastructure running with unreliable but fault-tolerant components. For engineers who need to understand the source of errors and performance bottlenecks in production. For everyone fed up with traditional approaches; who want something fast, expressive, and powerful.

All systems go

Dashboard shows an overview of CPU, memory, and application metrics.

A small, extendable Sinatra app shows your system at a glance. Instantly identify hotspots, down services, and unbalanced loads.

Phone, SMS and email alerts

(rollup 5 3600
  (email "dev@startup.com"))
An email describing a failure in a
      thumbnailer service.

Riemann can tell you as much or as little as you want. Throttle or roll up multiple events into a single messages. Get emails about exceptions in your code, provider downtime, or latency spikes. You can also integrate with PagerDuty for SMS or phone alerts.

Graph everything

(graphite {:host "graphs.pdx"})
An API latency graph

Like Statsd, Riemann can forward any event stream to Graphite. Librato Metrics integration? Built in.

Simple clients

r = Riemann::Client.new
r << {service: "www", state: "down", metric: 10000}
r['state = "down"']
# => [#<Riemann::Event @service="www" ... >]

Riemann speaks Protocol Buffers over TCP and UDP for a compact, portable, and fast wire protocol. See the Ruby client as a guide.

Query states

state = "error rate" and (not host =~ "www.%")

Search the Riemann index with a small query language. Clients can monitor each other, generate reports, or render dashboards.

Riemann queries form the basis for the realtime websockets dashboard, showing updated events as soon as they arrive.

See problems faster

Traditional monitoring systems run polling loops every five minutes, or roll up metrics on a minutely basis. In a Riemann infrastructure, clients (including stand-alone pollers) *push* their events to Riemann, which makes them visible within milliseconds. Low latencies let you see outages faster--and know the instant you've fixed the problem.

Throughput depends on what your streams *do* with events, but a stock Riemann config on commodity x86 hardware can handle *millions* of events per second at sub-ms latencies, with 99ths around 5ms. Riemann is fully parallel and leverages Clojure and JVM concurrency primitives throughout.

Brought to you by…

Riemann was made possible by the hard work of many open-source contributors. Everyone who's offered advice, asked questions, and submitted code has my deepest appreciation.

I wrote Riemann to help solve problems at work: both Showyou and Boundary deserve thanks for letting me build this crazy thing and share it with the world. Librato sponsored the Librato Metrics integration. Blue Mountain Capital donated to help make Riemann faster.

Riemann uses YourKit for performance analysis. YourKit is kindly supporting open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.