Go to file
Jared Scheib 7588dcbf63 Complete 9ef1e57 by removing Role concept from sources in server 2017-11-30 19:03:56 -08:00
.github Clarify changelog update requirement (#1525) 2017-05-22 12:59:43 -07:00
bolt Complete 9ef1e57 by removing Role concept from sources in server 2017-11-30 19:03:56 -08:00
canned Make all Store names plural for consistency 2017-10-24 15:54:24 -07:00
cmd/chronograf Introduce ability to edit a dashboard cell 2017-03-23 17:12:33 -07:00
dist Update to fix go linter issues 2017-03-06 10:11:52 -06:00
docs Update docs URLs to use 'latest' for better future-proofing 2017-06-15 14:50:34 -07:00
enterprise Generalize chronograf.UsersStore Get method 2017-10-18 14:17:42 -04:00
etc Merge branch 'master' into feature/rpm-shadow-utils 2017-11-08 11:55:07 -06:00
influx Merge branch 'master' into multitenancy 2017-10-24 17:58:15 -07:00
kapacitor Fix kapacitor variables to escape strings 2017-11-07 16:07:21 -06:00
layouts Make all Store names plural for consistency 2017-10-24 15:54:24 -07:00
log Add structured logging to underlying http server 2017-03-06 15:16:45 -06:00
memdb Allow InfluxDB and Kapacitor configuration via ENV vars or CLI options (#1129) 2017-03-30 09:48:04 -07:00
mocks Add default org logic to OrganizationsStore 2017-11-06 10:14:12 -05:00
noop Add default org logic to OrganizationsStore 2017-11-06 10:14:12 -05:00
oauth2 Add comment of how to generate JWT tokens 2017-11-01 16:05:56 -04:00
organizations Fix Update method in organization.UsersStore 2017-11-10 19:06:38 -05:00
roles Unscope sources by role 2017-11-29 17:32:41 -05:00
server Complete 9ef1e57 by removing Role concept from sources in server 2017-11-30 19:03:56 -08:00
ui Remove obsolete Authenticated component import/export 2017-11-30 14:45:27 -08:00
uuid Reorganize OAuth2 Logic 2017-02-14 16:18:41 -05:00
.bumpversion.cfg Update changelog and version number for 1.3.10.0 2017-10-24 09:34:31 -04:00
.gitattributes Revert "Temp commit" 2017-04-07 17:28:12 -07:00
.gitignore Add SHOW DATABASES integration test with Nightwatch.js. 2017-08-08 22:43:16 -07:00
CHANGELOG.md Update changelog 2017-11-09 18:42:40 -08:00
CONTRIBUTING.md Change some remaining npm mentions to yarn 2017-08-10 16:51:39 -07:00
Dockerfile Update Dockerfile to use VOLUMEs 2016-11-15 09:07:12 -06:00
Gopkg.lock Fix several kapacitor validation failures 2017-11-07 16:02:02 -06:00
Gopkg.toml Update dep files to stable format 2017-07-14 20:14:35 -05:00
LICENSE Update location of InfluxData in the LICENSE file 2017-03-09 10:46:43 -06:00
LICENSE_OF_DEPENDENCIES.md Add download.js license 2017-09-13 09:32:43 -07:00
Makefile Add hot module reload to dev builds (make run-hmr) 2017-11-04 14:07:39 -05:00
README.md Update changelog and version number for 1.3.10.0 2017-10-24 09:34:31 -04:00
agpl-3.0.md Add AGPL-3.0 2016-11-10 18:33:19 -06:00
chronograf.go Unscope sources by role 2017-11-29 17:32:41 -05:00
chronograf_test.go Update upper bound relative duration template expansion of :interval: 2017-10-17 14:26:26 -05:00
circle.yml Update circle builds to use go 1.9.2 and node 6.11.5 2017-10-27 10:11:09 -05:00

README.md

Chronograf

Chronograf is an open-source web application written in Go and React.js that provides the tools to visualize your monitoring data and easily create alerting and automation rules.

Features

Host List

  • List and sort hosts
  • View general CPU and load stats
  • View and access dashboard templates for configured apps

Dashboard Templates

Chronograf's pre-canned dashboards for the supported Telegraf input plugins. Currently, Chronograf offers dashboard templates for the following Telegraf input plugins:

Note: If a telegraf instance isn't running the system and cpu plugins the canned dashboards from that instance won't be generated.

Data Explorer

Chronograf's graphing tool that allows you to dig in and create personalized visualizations of your data.

  • Generate and edit InfluxQL statements with the query editor
  • Use Chronograf's query templates to easily explore your data
  • Create visualizations and view query results in tabular format

Dashboards

Create and edit customized dashboards. The dashboards support several visualization types including line graphs, stacked graphs, step plots, single statistic graphs, and line-single-statistic graphs.

Use Chronograf's template variables to easily adjust the data that appear in your graphs and gain deeper insight into your data.

Kapacitor UI

A UI for Kapacitor alert creation and alert tracking.

  • Simply generate threshold, relative, and deadman alerts
  • Preview data and alert boundaries while creating an alert
  • Configure alert destinations - Currently, Chronograf supports sending alerts to:
  • View all active alerts at a glance on the alerting dashboard
  • Enable and disable existing alert rules with the check of a box
  • Configure multiple Kapacitor instances per InfluxDB source

User and Query Management

Manage users, roles, permissions for OSS InfluxDB and InfluxData's Enterprise product. View actively running queries and stop expensive queries on the Query Management page.

TLS/HTTPS Support

See Chronograf with TLS for more information.

OAuth Login

See Chronograf with OAuth 2.0 for more information.

Advanced Routing

Change the default root path of the Chronograf server with the --basepath option.

Versions

The most recent version of Chronograf is v1.3.10.0.

Spotted a bug or have a feature request? Please open an issue!

Known Issues

The Chronograf team has identified and is working on the following issues:

  • Chronograf requires users to run Telegraf's CPU and system plugins to ensure that all Apps appear on the HOST LIST page.

Installation

Check out the INSTALLATION guide to get up and running with Chronograf with as little configuration and code as possible.

We recommend installing Chronograf using one of the pre-built packages. Then start Chronograf using:

  • service chronograf start if you have installed Chronograf using an official Debian or RPM package.
  • systemctl start chronograf if you have installed Chronograf using an official Debian or RPM package, and are running a distro with systemd. For example, Ubuntu 15 or later.
  • $GOPATH/bin/chronograf if you have built Chronograf from source.

By default, chronograf runs on port 8888.

With Docker

To get started right away with Docker, you can pull down our latest release:

docker pull chronograf:1.3.10.0

From Source

  • Chronograf works with go 1.8.x, node 6.x/7.x, and yarn 0.18+.
  • Chronograf requires Kapacitor 1.2.x+ to create and store alerts.
  1. Install Go
  2. Install Node and NPM
  3. Install yarn
  4. Setup your GOPATH
  5. Run go get github.com/influxdata/chronograf
  6. Run cd $GOPATH/src/github.com/influxdata/chronograf
  7. Run make
  8. To install run go install github.com/influxdata/chronograf/cmd/chronograf

Documentation

Getting Started will get you up and running with Chronograf with as little configuration and code as possible. See our guides to get familiar with Chronograf's main features.

Documentation for Telegraf, InfluxDB, and Kapacitor are available at https://docs.influxdata.com/.

Contributing

Please see the contributing guide for details on contributing to Chronograf.