Warning: This document is for the development version of Gnocchi. The main version is stable/4.2.

Gnocchi – Metric as a Service

Gnocchi logo

Gnocchi is a multi-tenant timeseries, metrics and resources database. It provides an HTTP REST interface to create and manipulate the data. It is designed to store metrics at a very large scale while providing access to metrics and resources information to operators and users.

Gnocchi is part of the OpenStack project. While Gnocchi has support for OpenStack, it is fully able to work stand-alone.

You can read the full documentation online at http://gnocchi.xyz.

Why Gnocchi?

Gnocchi has been created to fulfill the need of a time series database usable in the context of cloud computing: providing the ability to store large quantities of metrics and being easily scalable.

The Gnocchi project was started in 2014 as a spin-off of the OpenStack Ceilometer project to address the performance issues that Ceilometer encountered while using standard databases as a storage backends for metrics. More information are available on Julien’s blog post on Gnocchi.

Use cases

Gnocchi is meant to be used to store time series and their associated resource metadata. It’s therefore useful for example as:

  • Storage brick for a billing system
  • Alarm-triggering or monitoring system
  • Statistical usage of data

Key Features

  • HTTP REST interface
  • Horizontal scalability
  • Metric aggregation
  • Measures batching support
  • Archiving policy
  • Metric value search
  • Structured resources
  • Resource history
  • Queryable resource indexer
  • Multi-tenant
  • Grafana support
  • Statsd protocol support