33256914b3
In order to support hosting chronograf under an arbitrary path[1], we
need to be able to rewrite all the URLs that are served in HTML and CSS.
Take, for example, the scenario where Chronograf is to be hosted under
`/chronograf` using Caddy and this example Caddyfile:
```
localhost:2020
gzip
proxy /chronograf localhost:8888 {
without /chronograf
}
```
Chronograf will not load properly when visiting
`http://localhost:2020/chronograf` because the requests for CSS, and
fonts will go to `http://localhost:2020/app-somegianthash.js` when they
should go to `http://localhost:2020/chronograf/app-somegianthash.js`.
This is the essence of issue #721.
To solve this, we add a URLPrefixer http.Handler, that acts as a
middleware. It inserts itself between any upstream handlers, and the
handler that was passed to it as its `Next` parameter and searches for
`src="` attributes. Upon discovering one of these attributes, it writes
the detected attribute and then the configured prefix. It then continues
writing the stream to the upstream http.ResponseWriter until
encountering another attribute until EOF.
|
||
|---|---|---|
| .github | ||
| archive | ||
| bolt | ||
| canned | ||
| cmd/chronograf | ||
| dist | ||
| docs | ||
| etc | ||
| influx | ||
| jwt | ||
| kapacitor | ||
| layouts | ||
| log | ||
| server | ||
| ui | ||
| uuid | ||
| .gitignore | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| Godeps | ||
| LICENSE | ||
| LICENSE_OF_DEPENDENCIES.md | ||
| Makefile | ||
| README.md | ||
| agpl-3.0.md | ||
| chronograf.go | ||
| circle.yml | ||
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:
- Apache
- Consul
- Docker
- Elastic
- etcd
- HAProxy
- IIS
- InfluxDB
- Kubernetes
- Memcached
- MongoDB
- MySQL
- Network
- NGINX
- NSQ
- Ping
- PostgreSQL
- Processes
- RabbitMQ
- Redis
- Riak
- System
- Varnish
- Windows Performance Counters
Note: If a
telegrafinstance isn't running thesystemandcpuplugins 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 InfluxQL statements with the query builder
- Generate and edit InfluxQL statements with the raw query editor
- Create visualizations and view query results in tabular format
- Manage visualizations with exploration sessions
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:
- HipChat
- PagerDuty
- Sensu
- Slack
- SMTP
- Telegram
- VictorOps
- View all active alerts at a glance on the alerting dashboard
GitHub OAuth Login
See Chronograf with OAuth 2.0 for more information.
Versions
Chronograf v1.1.0-beta6 is a beta release. We will be iterating quickly based on user feedback and recommend using the nightly builds for the time being.
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:
- Currently, 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 startif you have installed Chronograf using an official Debian or RPM package.systemctl start chronografif you have installed Chronograf using an official Debian or RPM package, and are running a distro withsystemd. For example, Ubuntu 15 or later.$GOPATH/bin/chronografif you have built Chronograf from source.
With Docker
To get started right away with Docker, you can pull down our latest alpha:
docker pull quay.io/influxdb/chronograf:latest
From Source
- Chronograf works with go 1.7.4, npm 3.10.7 and node v6.6.0. Additional version support of these projects will be implemented soon, but these are the only supported versions to date.
- Chronograf requires Kapacitor 1.1.x to create and store alerts.
- Install Go
- Install Node and NPM
- Setup your GOPATH
- Run
go get github.com/influxdata/chronograf - Run
cd $GOPATH/src/github.com/influxdata/chronograf - Run
make - To install run
go install github.com/influxdata/chronograf/cmd/chronograf
Documentation
INSTALLATION will get you up and running with Chronograf with as little configuration and code as possible. See the GETTING STARTED guide 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.