Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

telegraf (15) Versions 0.4.1

Installs/Configures telegraf

Berkshelf/Librarian
Policyfile
Knife
cookbook 'telegraf', '~> 0.4.1'
cookbook 'telegraf', '~> 0.4.1', :supermarket
knife cookbook site install telegraf
knife cookbook site download telegraf
README
Dependencies
Changelog
Quality

telegraf

Cookbook to install and configure telegraf

This was influenced by SimpleFinanace/chef-influxdb

Note: Some inputs will require other packages be installed and that is out of scope for this cookbook. ie. [netstat] requires lsof

Tested Platforms

  • CentOS 6.6 and 7.1
  • Ubuntu 14.04 and 15.04
  • Amazon Linux

Requirements

  • Chef 12.5+

Usage

This cookbook can be used by including telegraf::default in your run list and settings attributes
as needed. Alternatively, you can use the custom resources directly.

Attributes

Key Type Description Default
node['telegraf']['version'] String Version of telegraf to install, nil = latest '0.10.0-1'
node['telegraf']['config_file_path'] String Location of the telgraf main config file '/etc/telegraf/telegraf.conf'
node['telegraf']['config'] Hash Config variables to be written to the telegraf config {'tags' => {},'agent' => {'interval' => '10s','round_interval' => true,'flush_interval' => '10s','flush_jitter' => '5s'}
node['telegraf']['outputs'] Array telegraf outputs ['influxdb' => {'urls' => ['http://localhost:8086'],'database' => 'telegraf','precision' => 's'}]
node['telegraf']['include_repository'] [TrueClass, FalseClass] Whether or not to pull in the InfluxDB repository to install from. true
node['telegraf']['inputs'] Hash telegraf inputs {'cpu' => {'percpu' => true,'totalcpu' => true,'drop' => ['cpu_time'],},'disk' => {},'io' => {},'mem' => {},'net' => {},'swap' => {},'system' => {}}

Custom Resources

telegraf_install

Installs telegraf and configures the service. Optionally specifies a version, otherwise the latest available is installed

telegraf_install 'default' do
  install_version '0.10.0-1'
  action :create
end

telegraf_config

Writes out the telegraf configuration file. Optionally includes outputs and inputs.

telegraf_config 'default' do
  path node['telegraf']['config_file_path']
  config node['telegraf']['config']
  outputs node['telegraf']['outputs']
  inputs node['telegraf']['inputs']
end

telegraf_outputs

Writes out telegraf outputs configuration file. You can call this several times to create multiple outputs config files.

telegraf_outputs 'default' do
  outputs node['telegraf']['outputs']
end

telegraf_inputs

Writes out telegraf inputs configuration file.

telegraf_inputs 'default' do
  inputs node['telegraf']['inputs']
end

You can call this several times to create multiple inputs config files. You'll need to specify different names for each telegraf_inputs resource, so they'll create separate config files.

For example, to add the nginx input:

node.default['telegraf']['nginx'] = {
  'nginx' => {
    'urls' => ['http://localhost/status']
  }
}

telegraf_inputs 'nginx' do
  inputs node['telegraf']['nginx']
  service_name 'default'
  reload true
  sensitive false
end

Note that there are three optional parameters for this resource that could've been left out in this case: - service_name [default: 'default'] if you need to override which service should be restarted when the config changes; - reload [default: true] whether to restart the service when the config changes; - sensitive [default: false] whether to restrict access to the config file so it's not world readable;

License and Authors

Copyright (C) 2015-2016 NorthPage

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.

Dependent cookbooks

apt >= 0.0.0
yum >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

0.1.0

  • Initial release

0.1.1

  • Add source URL to metadata

0.1.2

  • Add support for restarting the service when config changes

0.1.3

  • Add support for multiple outputs/plugins config files

0.1.4

  • Add install_version property to install resource to enforce specific telegraf version

0.1.5

  • Add sane defaults for plugins/outputs path

0.2.0

  • Change format for output/plugins to not require a top level name

0.2.1

  • Update matchers for chefspec testing

0.2.2

  • Merge #12 Allow specifying whether or not to bring in external repository (don-code)

0.2.3

  • Add LICENSE file

0.3.0

  • Add initial support for telegraf 0.10.x

0.3.1

  • Default to telegraf 0.10.1

0.3.2

  • Bugfix telegraf_inputs chefspec matcher

0.3.3

  • Default to telegraf 0.10.2

0.3.4

  • PR#16 - fix installation on Amazon Linux; add tests for ubuntu 15.04 and amazon linux
  • PR#19 - enforce permissions on config files, optionally suppress logging file updates

0.3.5

  • Pin toml-rb to v0.3.12

0.4.0

  • PR#21 - Fix incorrect config if 'toml-rb' > 0.3.12
  • PR#27 - Default to latest telegraf; only use stable apt repo
  • PR#30 - Add service restart retries
  • Pin toml-rb to '~> 0.3.0'

0.4.1

  • PR#34 - Allow specifying gem source for toml-rb

Collaborator Number Metric
            

0.4.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

0.4.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of http://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.4.1 failed this metric

FC064: Ensure issues_url is set in metadata: telegraf/metadata.rb:1
FC066: Ensure chef_version is set in metadata: telegraf/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: telegraf/metadata.rb:1
FC069: Ensure standardized license defined in metadata: telegraf/metadata.rb:1
Run with Foodcritic Version 10.3.1 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

License Metric
            

0.4.1 failed this metric

telegraf does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, Apache 2.0, MIT, mit, GPL-2.0, gplv2, GNU Public License 2.0, GPL-3.0, gplv3, GNU Public License 3.0.

No Binaries Metric
            

0.4.1 passed this metric

Publish Metric
            

0.4.1 passed this metric

Supported Platforms Metric
            

0.4.1 failed this metric

telegraf should declare what platform(s) it supports.

Testing File Metric
            

0.4.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of http://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.4.1 passed this metric