cookbook 'grafana', '= 1.5.3'
grafana
(108) Versions
1.5.3
-
-
10.8.0
-
10.7.4
-
10.7.3
-
10.7.2
-
10.7.1
-
10.7.0
-
10.6.4
-
10.6.3
-
10.6.2
-
10.6.1
-
10.6.0
-
10.5.1
-
10.5.0
-
10.4.1
-
10.4.0
-
10.3.1
-
10.3.0
-
10.2.13
-
10.2.12
-
10.2.11
-
10.2.10
-
10.2.9
-
10.2.8
-
10.2.7
-
10.2.6
-
10.2.5
-
10.2.4
-
10.2.3
-
10.2.2
-
10.2.1
-
10.2.0
-
10.1.0
-
10.0.6
-
10.0.5
-
10.0.4
-
10.0.3
-
10.0.2
-
10.0.1
-
10.0.0
-
9.7.1
-
9.7.0
-
9.6.2
-
9.6.1
-
9.6.0
-
9.5.2
-
9.5.1
-
9.5.0
-
9.4.1
-
9.4.0
-
9.3.0
-
9.2.1
-
9.2.0
-
9.1.0
-
9.0.0
-
8.8.0
-
8.7.1
-
8.7.0
-
8.6.0
-
8.5.0
-
8.4.2
-
8.4.1
-
8.4.0
-
8.3.0
-
8.2.0
-
8.1.1
-
8.1.0
-
8.0.0
-
7.1.1
-
7.1.0
-
7.0.0
-
6.0.1
-
6.0.0
-
5.1.1
-
5.1.0
-
5.0.0
-
4.4.0
-
4.3.0
-
4.2.0
-
4.1.0
-
4.0.2
-
4.0.1
-
4.0.0
-
3.0.1
-
3.0.0
-
2.2.1
-
2.2.0
-
2.1.3
-
2.1.2
-
2.1.1
-
2.1.0
-
2.0.0
-
1.5.5
-
1.5.4
-
1.5.3
-
1.5.2
-
1.5.1
-
1.5.0
-
1.4.2
-
1.4.1
-
1.4.0
-
1.3.4
-
1.3.2
-
1.3.1
-
1.3.0
-
1.2.0
-
1.1.1
-
1.1.0
-
1.0.6
Follow32
- 10.8.0
- 10.7.4
- 10.7.3
- 10.7.2
- 10.7.1
- 10.7.0
- 10.6.4
- 10.6.3
- 10.6.2
- 10.6.1
- 10.6.0
- 10.5.1
- 10.5.0
- 10.4.1
- 10.4.0
- 10.3.1
- 10.3.0
- 10.2.13
- 10.2.12
- 10.2.11
- 10.2.10
- 10.2.9
- 10.2.8
- 10.2.7
- 10.2.6
- 10.2.5
- 10.2.4
- 10.2.3
- 10.2.2
- 10.2.1
- 10.2.0
- 10.1.0
- 10.0.6
- 10.0.5
- 10.0.4
- 10.0.3
- 10.0.2
- 10.0.1
- 10.0.0
- 9.7.1
- 9.7.0
- 9.6.2
- 9.6.1
- 9.6.0
- 9.5.2
- 9.5.1
- 9.5.0
- 9.4.1
- 9.4.0
- 9.3.0
- 9.2.1
- 9.2.0
- 9.1.0
- 9.0.0
- 8.8.0
- 8.7.1
- 8.7.0
- 8.6.0
- 8.5.0
- 8.4.2
- 8.4.1
- 8.4.0
- 8.3.0
- 8.2.0
- 8.1.1
- 8.1.0
- 8.0.0
- 7.1.1
- 7.1.0
- 7.0.0
- 6.0.1
- 6.0.0
- 5.1.1
- 5.1.0
- 5.0.0
- 4.4.0
- 4.3.0
- 4.2.0
- 4.1.0
- 4.0.2
- 4.0.1
- 4.0.0
- 3.0.1
- 3.0.0
- 2.2.1
- 2.2.0
- 2.1.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.0
- 1.5.5
- 1.5.4
- 1.5.3
- 1.5.2
- 1.5.1
- 1.5.0
- 1.4.2
- 1.4.1
- 1.4.0
- 1.3.4
- 1.3.2
- 1.3.1
- 1.3.0
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.6
Installs/Configures Grafana Server
cookbook 'grafana', '= 1.5.3', :supermarket
knife supermarket install grafana
knife supermarket download grafana
grafana Cookbook
A stand-alone cookbook for Grafana
Requirements
- apt
- nginx
- git
Attributes
As with most cookbooks I write, this one is hopefully flexible enough to be wrapped by allowing you to override as much as possible
grafana::default
Attribute | Default | Description |
---|---|---|
node['grafana']['install_type'] |
'file' |
The type of install we are going to use either git or file
|
node['grafana']['git']['url'] |
'https://github.com/grafana/grafana' |
The url for the git repo to use for Grafana |
node['grafana']['git']['branch'] |
'master' |
The sha or branch name to use |
node['grafana']['file']['type'] |
'tar.gz' |
the type of archive file. zip or tar.gz . |
node['grafana']['file']['version'] |
'1.8.1' |
the version to install. |
node['grafana']['file']['url'] |
'http://grafanarel.s3.amazonaws.com/grafana-1.8.1.tar.gz' |
The file URL for the latest Grafana build |
node['grafana']['file']['checksum'] |
'08a923508d1a0ef2af4c23827e715e438240d3e348f85f9ffd968709a91370d4' |
The sha256 of the Grafana file |
node['grafana']['install_path'] |
'/srv/apps' |
The root directory where Grafana will be installed |
node['grafana']['install_dir'] |
'/srv/apps/grafana' |
The directory to checkout into. A current symlink will be created in this directory as well. |
node['grafana']['admin_password'] |
'' |
This is a password used when saving dashboard |
node['grafana']['es_server'] |
'127.0.0.1' |
The ipaddress or hostname of your elasticsearch server |
node['grafana']['es_port'] |
'9200' |
The port of your elasticsearch server's http interface |
node['grafana']['es_role'] |
'elasticsearch_server' |
eventually for wiring up discovery of your elasticsearch server, set to nil to prevent any search |
node['grafana']['es_scheme'] |
'http://' |
Scheme helper if elasticsearch is outside of this cookbook http:// or https://
|
node['grafana']['es_user'] |
'' |
Elasticsearch authentication user |
node['grafana']['es_password'] |
'' |
Elasticsearch authentication password |
node['grafana']['graphite_server'] |
'127.0.0.1' |
The ipaddress or hostname of your graphite server |
node['grafana']['graphite_port'] |
'80' |
The port of your graphite server's http interface |
node['grafana']['graphite_role'] |
'graphite_server' |
eventually for wiring up discovery of your graphite server, set to nil to prevent any search |
node['grafana']['graphite_scheme'] |
'http://' |
Scheme helper if graphite is outside of this cookbook http:// or https://
|
node['grafana']['graphite_user'] |
'' |
Graphite authentication user |
node['grafana']['graphite_password'] |
'' |
Graphite authentication password |
node['grafana']['user'] |
'' |
The user who will own the files from the git checkout. |
node['grafana']['config_template'] |
'config.js.erb' |
The template to use for Grafana's config.js
|
node['grafana']['config_cookbook'] |
'grafana' |
The cookbook that contains said config template |
node['grafana']['webserver'] |
'nginx' |
Which webserver to use: nginx or '' |
node['grafana']['webserver_hostname'] |
node.name |
The primary vhost the web server will use for Grafana |
node['grafana']['webserver_aliases'] |
[node['ipaddress']] |
Array of any secondary hostnames that are valid vhosts |
node['grafana']['webserver_listen'] |
node['ipaddress'] |
The ip address the web server will listen on |
node['grafana']['webserver_port'] |
80 |
The port the webserver will listen on |
node['grafana']['webserver_scheme'] |
'http://' |
Scheme helper if webserver is outside of this cookbook http:// or https://
|
node['grafana']['default_route'] |
'/dashboard/file/default.json' |
Default route config, set start dashboard |
node['grafana']['timezone_offset'] |
'null' |
Timezone offset config, example: "-0500" (for UTC-5 hours) |
node['grafana']['grafana_index'] |
'grafana-index' |
Elasticsearch index to use for Grafana |
node['grafana']['unsaved_changes_warning'] |
'true' |
Enable disable unsaved changes warning in UI |
node['grafana']['playlist_timespan'] |
'1m' |
Playlist timespan config |
node['grafana']['window_title_prefix'] |
'Grafana - ' |
Window title prefix config |
node['grafana']['search_max_results'] |
20 |
Search maximuyum result config |
node['grafana']['datasources'] |
see below | Grafana (> 1.7.0 ) data sources configuration |
Starting with 1.7.0
, Grafana uses datasources
array in its configuration file
to know about the multiple databases it should read data from (elasticsearch
,
graphite
, InfluxDB
, ...), we're generating this array from
node['grafana']['datasources']
, the defaults are:
{ 'graphite' => { 'type' => "'graphite'", 'url' => 'window.location.protocol+"//"+window.location.hostname+":"+window.location.port+"/_graphite"', 'default' => true }, 'elasticsearch' => { 'type' => "'elasticsearch'", 'url' => 'window.location.protocol+"//"+window.location.hostname+":"+window.location.port', 'index' => "'#{node['grafana']['grafana_index']}'", 'grafanaDB' => true } }
kibana::nginx
Attribute | Default | Description |
---|---|---|
node['grafana']['nginx']['template'] |
'grafana-nginx.conf.erb' |
The template file to use for the nginx site configuration |
node['grafana']['nginx']['template_cookbook'] |
'grafana' |
The cookbook containing said template |
Removed:
-
node['grafana']['nginx']['enable_default_site']
- usenode['nginx']['enable_default_site']
Usage
grafana::default
The default recipe will:
- install Grafana from
master
into/opt/grafana/master
and create a symlink calledcurrent
in the same directory tomaster
- install
nginx
and serve the grafana application
If you want to use the file distribution of Grafana update node['grafana']['install_type']
attribute to file
. Set node['grafana']['checksum']
to appropriate sha256 value of latest archive file.
If you don't want this cookbook to handle the webserver config simply set node['grafana']['webserver']
to ''
in a role/environment/node somewhere.
Please note that in this case you have to set node['grafana']['user']
.
Nginx recipe, by default, will configure the appropriate proxy to your ElasticSearch server such that you don't have to expose it to the world.
NOTE
There is NO security enabled by default on any of the content being served.
If you would like to modify the nginx
parameters, you should:
- create your own cookbook i.e.
my-grafana
- copy the template for the webserver you wish to use to your cookbook
- modify the template as you see fit (add auth, setup ssl)
- use the appropriate webserver template attributes to point to your cookbook and template
Testing
kitchen-test
Requires Vagrant >= 1.2 with the following plugins :
- vagrant-berkshef
- vagrant-omnibus
$ bundle install
$ kitchen test
Contributing
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write you change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
--
bundle exec strainer test
- Submit a Pull Request using Github
License and Authors
Primary author:
- Jonathan Tron jonathan@tron.name
Contributors:
- Grégoire Seux (@kamaradclimber)
- Anatoliy D. (@anatolijd)
- Greg Fitzgerald (@gregf)
- Fred Hatfull (@fhats)
- Tim Smith (@tas50)
- Jonathon W. Marshall (@jwmarshall)
- Andrew Goktepe (@andrewgoktepe)
- Miguel Landaeta (@nomadium)
Based on chef-kibana
cookbook by:
- John E. Vincent lusis.org+github.com@gmail.com
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
http://www.apache.org/licenses/LICENSE-2.0
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.
CHANGELOG for grafana
This file is used to list changes made in each version of grafana.
1.5.3:
- Add support for Centos#28
1.5.2:
- Allow configuration of
default_route
via attributes (Miguel Landaeta) #26 - Add support for grafana admin password option (Andrew Goktepe) #23
1.5.1:
- Update
Grafana
to1.8.1
1.5.0:
- Update
Grafana
to1.8.0
warning
- Check for the presence of
node['grafana']['es_role']
andnode['grafana']['graphite_role']
instead ofnode['grafana']['es_server']
andnode['grafana']['graphite_server']
to know if we should search and replacedefault['grafana']['es_server']
anddefault['grafana']['graphite_server']
(Jonathon W. Marshall) #22
1.4.2:
- Fix attributes doc in README
1.4.1:
- Do not use
template
resource'shelpers
method to bring back olderChef
compatibility.
1.4.0:
- Update
Grafana
to1.8.0-rc1
- Add
default['grafana']['window_title_prefix']
anddefault['grafana']['search_max_results']
config attributes.
warnings
-
Grafana 1.8.0-rc1
upgraded toJQuery
to2.1.1
and thus dropped support forInternet Explorer 7 and 8
1.3.4:
- Update attributes in README for better Supermarket display
- Update
foodcritic
andrubocop
(Tim Smith) #21 - Remove mention of
zipfile
in README and attributes (Thanks to Gref Fitzgerald) - Fix
default['grafana']['install_type']
documentation to have the correct possible values:git
andfile
(Fred Hatfull) #20 - Fix
default['grafana']['webserver']
documentation not to includeapache
as possible value. (osigida) #19
1.3.2:
- Update default
Grafana
to1.7.0
. (Greg Fitzgerald) #18.
1.3.1:
- Update
Grafana
to1.7.1-rc1
. It fixes a regression introduced when merging #16. Thanks to Greg Fitzgerald for reporting it.
1.3.0:
- Allow attribute configuration for datasources (Grégoire Seux) #16
1.2.0:
breaking changes
- Update
ark
dependency to>= 0.7.2
and deprecation warning by usingstrip_component
(Grégoire Seux) #15
minor changes
- Support newer
nginx
cookbook by specifyingtemplate: false
when enabling thegrafana
site (Grégoire Seux) #15
1.1.1:
- Update default attributes to install Grafana 1.6.1 (Greg Fitzgerald) #14
1.1.0:
breaking changes
-
config.js
data forgraphite
andelasticsearch
changed back to use:window.location.protocol+"//"+window.location.hostname+":"+window.location.port+"/_graphite"
window.location.protocol+"//"+window.location.hostname+":"+window.location.port
The idea is to allow external access without CORS
problems or credential leaks in config.js
.
- Value for
default['grafana']['install_path']
changed from/opt
to/srv/apps
(Greg Fitzgerald) #13 - Default installation uses zip file instead of git (Greg Fitzgerald) #13
minor changes
- Major cleanup and additional tests (Greg Fitzgerald) #13
1.0.6:
- Releasing to opscode community site Thanks to @gregf in #12
1.0.5:
breaking changes
-
config.js
was unintentionally changed to use node info to configure graphite and elasticsearch index. - Value for
default['grafana']['grafana_index']
changed fromgrafana-dash
tografana-index
(Greg Fitzgerald) #11 - Update grafana to 1.6.0 (Greg Fitzgerald) #11
1.0.4:
- Update config.js based on the one in 1.5.4
- Update to grafana 1.5.4
- Update to new download URL
1.0.3:
Add some basic specs, foodcritic, knife test and enable TravisCI
Fix error with undefined grafana_user variable Thanks to @klamontagne
Fix timezone value quoting in config.js (Anatoliy D.) #9
Update grafana to 1.5.2 (Grégoire Seux) #7
Don't set normal attribute
node['nginx']['default_site_enabled']
(Grégoire Seux) #5Remove
"use strict";
fromconfig.js
as it seems to not be present in
grafana releases, thanks to @iiro for proposing it in #1Don't search when
node['grafana']['es_server']
ornode['grafana']['graphite_server']
is set and don't use normal attributes (Grégoire Seux) #3Refactor and separate install in two recipes:
install_git
andinstall_file
(Grégoire Seux) #2
1.0.2:
- Update file release to 1.5.1
1.0.1:
- Update file release to 1.5.0
1.0.0:
- Initial release of grafana
Foodcritic Metric
1.5.3 passed this metric
1.5.3 passed this metric