Tessera is a front-end interface for the Graphite metrics system, which provides a large selection of presentations, layout, and interactivity options for building dashboards.
The biggest key differences between Tessera and other frontends are the separation of queries from presentations, and the ability to apply arbitrary transformations to the presentations & queries, allowing for a large degree of interactivity. Tessera is initially focused on information presentation - it does not NOT address the areas of metric discovery or query composition (although it may in the future).
Tessera consists of a small python webserver written with Flask with a SQL backing store. The server manages storing and searching for dashboards, managing tags for organization, serving the basic UI assets, and providing a ReST API for the front-end to use.
If you're familiar with docker and already have a Graphite instance running, you can boot up an instance of tessera with the demo dashboards preloaded and easily point it at your existing Graphite installation using the
aalpern/tessera-simple image. If you don't have a Graphite installation handy, a Docker image like
nickstenning/graphite can get that up and running quickly.
docker run -P -e GRAPHITE_URL=http://graphite.host -it aalpern/tessera-simple
Tessera can be installed easily from
easy_install. This method of installation is only recommended for
pip install tessera
After installation, create a
config.py script for your local
Initialize the database:
Then launch the service:
The service will be available on localhost:5000 by default, with the demo dashoards loaded.
The TL;DR version:
./script/setup ./script/server & cd tessera-server inv json.import '../demo/*'
Documentation is hosted on GitHub Pages at tessera-metrics.github.io/tessera/docs.
- Getting Started for getting started and running from source and importing the demo dashboards.
- Tutorial for creating the most basic possible dashboard.
- API endpoints and data format for accessing Tessera via the HTTP REST API
- Extending Tessera, for adding new dashboard items, transformations, and actions.
Some additional writeup of why Tessera exists can found on the introductory blog post that was originally posted on Urban Airship's company blog - Introducing Tessera, a Graphite Frontend.
Copyright & License
Copyright © 2014, Urban Airship and Contributors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Third-party software libraries included with this project are distributed under their respective licenses.