Go to file
Delmer Reed 100148c087 fix(server): timeout and fetch version concurrently
fixes an issue where version was not being fetched concurrently
and not timing out for each source.

Co-authored-by: Kelvin Wang <sherkrainwang@gmail.com>
2019-05-30 17:31:35 -04:00
.circleci Update golang version 2019-04-16 16:15:55 -07:00
.github Update PR template to include checkbox for Swagger docs 2018-04-18 12:15:21 -07:00
bolt fix: active kapacitor updating and ui defaults (#5079) 2019-02-12 18:50:56 -05:00
canned Add template variables db and rp to missed canned layouts 2018-11-12 15:18:13 -06:00
cmd Merge pull request #2699 from influxdata/feature/mappings 2018-02-12 15:29:01 -08:00
dist Update to fix go linter issues 2017-03-06 10:11:52 -06:00
docs Update oauth documentation link to non broken link 2018-03-08 16:45:29 -08:00
enterprise Remove concurrency from source authentication test 2018-07-02 14:30:08 -07:00
etc fix(package): create chronograf user before install 2019-05-02 10:40:06 +02:00
filestore feat: protoboard api 2018-08-14 14:29:10 -07:00
flux fix(server): timeout and fetch version concurrently 2019-05-30 17:31:35 -04:00
id Add id generator based on time 2017-12-18 17:31:45 -08:00
influx Add support for user-defined annotation tags 2018-08-06 08:47:19 -07:00
integrations Add logs hostname (#4645) 2018-10-25 16:42:29 -04:00
kapacitor Provide valid characters for idVar with Sensu 2018-11-27 15:36:47 -08:00
log Add structured logging to underlying http server 2017-03-06 15:16:45 -06:00
memdb Move MultiSourceStore to the multistore package 2017-12-18 17:31:45 -08:00
mocks feat: protoboard api 2018-08-14 14:29:10 -07:00
multistore Get protoboards from multistore if not able to find from ProtoboardsPath 2018-11-08 17:27:27 -08:00
noop Rename org config method Update to Put for semantic accuracy 2018-07-10 15:42:44 -07:00
oauth2 Use go modules, update flux 2019-04-11 16:14:36 -07:00
organizations fix: active kapacitor updating and ui defaults (#5079) 2019-02-12 18:50:56 -05:00
protoboards Fix typo on influxdb protoboard. 2018-11-12 09:34:06 -08:00
roles Add wildcard role and validate users roles in CRUD 2018-01-12 12:27:55 -05:00
server fix(server): timeout and fetch version concurrently 2019-05-30 17:31:35 -04:00
ui Allow values for min to be negative 2019-05-20 17:14:40 -07:00
v2 review(chronograf): make changes suggested in pr 2018-07-18 10:39:05 -04:00
.bumpversion.cfg Update version to 1.7.4 (#4883) 2018-12-12 16:21:04 -05:00
.eslintrc Upgrade prettier to 1.11.1 2018-03-21 13:41:48 -07:00
.gitattributes Resolve conflicts by taking both changes 2017-04-04 15:13:01 -07:00
.gitignore Merge pull request #4018 from influxdata/generic-wizard 2018-07-26 11:49:43 -07:00
CHANGELOG.md Remove unreleased from changelog 2019-04-24 10:09:21 -07:00
CONTRIBUTING.md change google groups link to community (#5126) 2019-03-20 11:00:31 -07:00
Dockerfile Update go and alpine versions (#4886) 2018-12-14 15:16:35 -08:00
Gopkg.lock Update flux to 0.12 to match influxdb 2019-01-14 11:14:44 -08:00
Gopkg.toml Update flux to 0.12 to match influxdb 2019-01-14 11:14:44 -08: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 Update chronograf version to 1.7.11 2019-05-20 14:31:04 -07:00
README.md Update chronograf version to 1.7.11 2019-05-20 14:31:04 -07:00
agpl-3.0.md Add AGPL-3.0 2016-11-10 18:33:19 -06:00
chronograf.go Add templates field to protoboards on BE 2018-11-06 15:37:13 -08:00
go.mod Use go modules, update flux 2019-04-11 16:14:36 -07:00
go.sum Use go modules, update flux 2019-04-11 16:14:36 -07:00
kapacitor.go Fixes topic saving for kafka handler 2018-05-21 17:50:22 -07:00
platform_migrate.md Add documentation on how to migrate changes to platform 2018-07-26 11:41:09 -04: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.7.11.

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:latest

From Source

  • Chronograf works with go 1.11+, node LTS, and yarn 1.7+.
  • Chronograf requires Kapacitor 1.5.x+ to create and store alerts.
  1. Install Go
  2. Install Node and NPM
  3. Install yarn
  4. Setup your GOPATH
  5. Build the Chronograf package:
    go get github.com/influxdata/chronograf
    cd $GOPATH/src/github.com/influxdata/chronograf
    make
    
  6. Install the newly built Chronograf package:
    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/.

Chronograf uses swagger to document its REST interfaces. To reach the documentation, run the server and go to the /docs for example at http://localhost:8888/docs

The swagger JSON document is in server/swagger.json

Contributing

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