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

Select Status

RSS

netdata (15) Versions 0.2.0

Compile, install and configure netdata

Policyfile
Berkshelf
Knife
cookbook 'netdata', '= 0.2.0', :supermarket
cookbook 'netdata', '= 0.2.0'
knife supermarket install netdata
knife supermarket download netdata
README
Dependencies
Changelog
Quality 57%

NetData Cookbook

Build Status
NetData Cookbook
Chef Version

This cookbook provides a way to download, install and configure NetData
from FireHol, a real-time performance monitoring.

Live demo: http://netdata.firehol.org

Github: https://github.com/firehol/netdata

Requirements

Platforms

  • Amazon Linux 2013.09+
  • Centos 6.7+
  • Debian 7.11+
  • Fedora 25+
  • Ubuntu 14.04+

Chef

  • Chef 12.5+

Cookbooks

  • yum-epel
  • apt

Usage

This cookbook implements resources to install NetData and manage its
configuration files.

Recipies

default

Installs NetData using the netdata_install resource with default parameters.

install_netdata

Deprecated, please use default recipe or netdata_install resource.

Resources

netdata_install

Installs NetData from source on supported platforms.

netdata_install 'default' do
  git_repository 'https://github.com/firehol/netdata.git'
  git_revision 'master'
  git_source_directory '/tmp/netdata'
  autoupdate true
end
  • git_repository - Location of git repository to pull the NetData source.
  • git_revision - Tag/Branch/Commit to checkout.
  • git_source_directory - Location to sync the repository to on the server.
  • install_path - Change the location where NetData is installed.
  • autoupdate - Allow NetData to autoupdate itself via a cron entry.

It's highly recommended to use a different path than /tmp/netdata for git_source_directory and in future versions the default path will change. This is encouraged because when autoupdate is set to true NetData will create a symbolic link from the source directory to cron.d and you don't want NetData to create a symbolic link to anything in /tmp

netdata_config

Manages the main netdata.conf file. Call this as many times as needed.
Each name should be unique. (i.e. web, global)

netdata_config 'web' do
  owner 'netdata'
  group 'netdata'
  base_directory '/etc'
  configurations(
    'bind to' => 'localhost'
  )
end

Resulting file content (/etc/netdata/netdata.conf):

[web]
  bind to = localhost
  • owner - User to own the file
  • group - Group to own the file
  • base_directory - Parent folder that holds the NetData configuration files.
  • configurations - Hash of key, value pairs for customizing NetData.

This resource will restart the NetData service automatically.

netdata_python_plugin

Manages python plugin configuration files.

netdata_python_plugin 'mysql' do
  owner 'netdata'
  group 'netdata'
  base_directory '/etc'
  global_configuration(
    'retries' => 5
  )
  jobs(
    'tcp' => {
      'name' => 'local',
      'host' => 'localhost',
      'port' => 3306   
    }
  )
end

Resulting file content (/etc/netdata/python.d/mysql.conf):

# GLOBAL
retries: 5

# JOBS
tcp:
  name: local
  host: localhost
  port: 3306
  • owner - User to own the file
  • group - Group to own the file
  • base_directory - Parent folder that holds the NetData configuration files.
  • global_configuration - Hash of global variables for the plugin.
  • jobs - Hash of jobs that tell NetData to pull statistics from.

This resource will restart the NetData service automatically.

netdata_bind_rndc_conf

Deprecated, please use netdata_python_plugin

netdata_nginx_conf

Deprecated, please use netdata_python_plugin

Contributing

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

License and Authors

Authors:
* Sergio Pena https://github.com/sergiopena
* João Madureira https://github.com/jmadureira
* Nick Willever https://github.com/nictrix

Dependent cookbooks

yum-epel ~> 2.0
apt ~> 6.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

netdata CHANGELOG

This file is used to list changes made in each version of the netdata cookbook.

0.1.0

  • Sergio Pena - Initial release of netdata

0.1.1

  • Sergio Pena - Add tests and kitchen specs

0.1.2

  • Sergio Pena - Add Ubuntu deps and tests.

0.1.4

  • João Madureira - Do not run install if there are no changes in git repo

0.2.0

  • Nick Willever - Change install to a resource - Create new generic resource for all python.d plugins - Deprecated netdata_bind_rndc_conf resource - Deprecated netdata_nginx_conf resource - Deprecate use of attributes - Deprecate use of default and install_netdata recipes - Convert to inspec for test-kitchen verifier framework

Collaborator Number Metric
            

0.2.0 failed this metric

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

Contributing File Metric
            

0.2.0 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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.2.0 passed this metric

License Metric
            

0.2.0 passed this metric

No Binaries Metric
            

0.2.0 passed this metric

Testing File Metric
            

0.2.0 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 https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.2.0 passed this metric