Version information
This version is compatible with:
- ,
Start using this module
Add this module to your Puppetfile:
mod 'jlambert121-kibana', '2.5.0'
Learn more about managing modules with a PuppetfileDocumentation
Table of Contents
- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with kibana
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
- Changelog/Contributors
Overview
Puppet module to install and configure Kibana 4.
Module Description
This module installs kibana 4 (https://www.elastic.co/products/kibana), commonly used as part of the ELK stack (Elasticsearch, Logstash, Kibana).
Setup
What kibana affects
- Kibana package
- Kibana service
Beginning with kibana
Installation of the kibana module:
puppet module install jlambert121-kibana
Usage
Installation:
class { 'kibana': }
Reference
Public methods
Class: kibana
Main class for managing kibana.
#####version
String. Version of kibana to install
Default: '4.0.1'
#####base_url
String. HTTP path to fetch kibana package from
Default: https://download.elasticsearch.org/kibana/kibana
#####tmp_dir
String. Working dir for caching package
Default: /tmp
#####install_path
String. Location to install kibana
Default: /opt
#####port
Integer. Port for kibana to listen on
Default: 5601
#####es_url
String. ElasticSearch path to connect to
Default: http://localhost:9200
#####es_preserve_host
Boolean.
Default: true
#####kibana_index
String. Index to save searches, visualizations, and dashboards
Default: .kibana
#####default_app_id
String. The default application to load.
Default: discover
#####request_timeout
Integer. Time in milliseconds to wait for responses from the back end or elasticsearch.
Default: 300000
#####shard_timeout
String. Time in milliseconds for Elasticsearch to wait for responses from shards.
Default: 0
Private classes
kibana::params
: Default parameterskibana::install
: Installs kibana packagekibana::config
: Configures Kibanakibana::service
: Manages the kibana service
Limitations
- Only tested on Centos 6
Development
Improvements and bug fixes are greatly appreciated. See the contributing guide for information on adding and validating tests for PRs.
Changelog / Contributors
Change Log
2.5.0 (2015-05-11)
Closed issues:
- Support for server.basePath #78
- HTTPS/SSL Support #72
- kibana 4.3.0 needs small systemd change to start #65
- Github module code different from Puppet Forge module code #63
- Exec 'ensure_correct_permissions' occurs before kibana user/group is created #62
- Repo description is wrong, please update. #59
- Tag for 2.2.0 missing from github repo #56
Merged pull requests:
- Added the new config since kibana 4.2.x, support for custom log file and server.basePath #79 (caskolkm)
- Fix systemd service file path for Debian Jessie #76 (mikemead)
- SSL support #75 (smetj)
- Remove duplicate params and fix spec tests #74 (mikemead)
- prevent puppet from fetching and amazon linux support #69 (jensendw)
- add plugin support #68 (bilsch)
- Fixes for kibana with systemd #67 (atopian)
- version bump: 2.3.0 #64 (jlambert121)
- sheild ssl + credentials pickup from pabrahamsson #60 (bilsch)
- Use the service provider defined in params #54 (nerzhul)
- Add dependency on User resource to fix race condition #52 (mikemead)
2.2.0 (2015-08-24)
Closed issues:
- Service is restarting upon every puppet run #49
- RHEL6 needs architecture of x86_64 #41
- /etc/init.d/kibana status does not set return code #36
- Kibana Service Not Installed #34
- Not Working Behind Proxy #33
Merged pull requests:
- version bump: 2.2.0 #51 (jlambert121)
- only reset perms on install #50 (jlambert121)
- allow verify_ssl to be configured #47 (bilsch)
- Missing logfile property #46 (bilsch)
- Adds the ability to supply a non-default user, a uid, and a non-default group. #45 (seanmckinley)
- define default-start for legacy init script #44 (toepi)
- status returns not 0 if kibana is not running #43 (toepi)
- Add x86_64 support #42 (jlambert121)
- lint warning fix: ensure should be the first attribute #40 (toepi)
- create legacy init script in dependence of operatingsystem #39 (toepi)
- add support for 32bit linux #38 (toepi)
- define relationship between init file and service with fullqualified #37 (toepi)
- Decide which init system to use based on host OS. #32 (philipwigg)
- Quote the file mode for compatibility with Puppet4. #31 (philipwigg)
- version bump: 2.1.0 #30 (jlambert121)
2.1.0 (2015-05-11)
Closed issues:
Merged pull requests:
- Added init SysV script funcationality to this module #27 (soumentrivedi)
- add lint plugins #26 (jlambert121)
2.0.1 (2015-03-19)
Closed issues:
- Can not install kibana repo #17
Merged pull requests:
- version bump: 2.0.1 #25 (jlambert121)
- support stdlib 3.2.0 #24 (jlambert121)
- version bump: 2.0.0 #23 (jlambert121)
- rewrite for kibana 4 #22 (jlambert121)
- normalize common files #21 (jlambert121)
- version bump: 1.1.0 #20 (jlambert121)
- enable travis for puppet 3.5,3.6 testing #19 (jlambert121)
- update for kibana 3.1.0 #18 (jlambert121)
- switch ripienaar/concat to puppetlabs/concat #16 (jlambert121)
- add puppet 3.4 tests, remove puppet 3.0 #15 (jlambert121)
- release version 1.0.0 #14 (jlambert121)
- update to newest kibana versions #13 (jlambert121)
- add travis 3.3 tests #12 (jlambert121)
- config.js lives in script dir #11 (nibalizer)
0.2.0 (2013-09-02)
Merged pull requests:
- version 0.2.0 #10 (jlambert121)
- Dashboard docs #9 (jlambert121)
- update travis checks #8 (jlambert121)
- install custom dashboards #7 (jlambert121)
- add additional default checks #6 (jlambert121)
- version 0.1.0 #5 (jlambert121)
0.1.0 (2013-08-30)
Merged pull requests:
- updated panel modules, add default panel #4 (jlambert121)
- pupet 3.2 tests, lint cleanup #3 (jlambert121)
- add option for vhost json logging #2 (jlambert121)
- add travis-ci integration #1 (jlambert121)
0.0.1 (2013-05-29)
* This Change Log was automatically generated by github_changelog_generator
Dependencies
- maestrodev/wget ()
- puppetlabs/stdlib (>=3.2.0 <5.0.0)
Copyright 2013 EvenUp Inc 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.