{"id":19168368,"url":"https://github.com/bloomberg/collectd-cookbook","last_synced_at":"2025-05-07T14:41:31.801Z","repository":{"id":66125146,"uuid":"48197108","full_name":"bloomberg/collectd-cookbook","owner":"bloomberg","description":null,"archived":false,"fork":false,"pushed_at":"2019-05-29T16:56:09.000Z","size":74,"stargazers_count":6,"open_issues_count":7,"forks_count":18,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-04-19T23:31:57.471Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bloomberg.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-12-17T20:38:55.000Z","updated_at":"2022-05-02T00:55:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"f2c114f2-ba19-4bdb-a74d-85ae3efaca57","html_url":"https://github.com/bloomberg/collectd-cookbook","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fcollectd-cookbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fcollectd-cookbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fcollectd-cookbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bloomberg%2Fcollectd-cookbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bloomberg","download_url":"https://codeload.github.com/bloomberg/collectd-cookbook/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252897369,"owners_count":21821430,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T09:42:25.160Z","updated_at":"2025-05-07T14:41:31.774Z","avatar_url":"https://github.com/bloomberg.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# collectd-cookbook\n[![Build Status](https://img.shields.io/travis/bloomberg/collectd-cookbook.svg)](https://travis-ci.org/bloomberg/collectd-cookbook)\n[![Code Quality](https://img.shields.io/codeclimate/github/bloomberg/collectd-cookbook.svg)](https://codeclimate.com/github/bloomberg/collectd-cookbook)\n[![Cookbook Version](https://img.shields.io/cookbook/v/collectd.svg)](https://supermarket.chef.io/cookbooks/collectd)\n[![License](https://img.shields.io/badge/license-Apache_2-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)\n\n[Application cookbook][0] which installs and configures the\n[collectd monitoring daemon][1].\n\nThis cookbook provides a dead-simple installation and configuration of\nthe collectd monitoring daemon. It provides two resources: the first\nis for managing the collectd system service, and the second is for\nconfiguring the daemon's plugins. Additionally, the\n[collectd_plugins cookbook][4] may be used to configure many of the\ncommon plugins that ship with the daemon.\n\nIt is very important to note that distributions may ship different\nmajor versions of the package, but the following platforms are tested\nusing the integration tests via [Test Kitchen][2].\n- Ubuntu ~\u003e 10.04, 12.04, 14.04\n- CentOS ~\u003e 5.8, 6.4, 7.1\n- RHEL ~\u003e 5.8, 6.4, 7.1\n\n## Basic Usage\nThe [default recipe](recipes/default.rb) in this cookbook simply\nconfigures the monitoring daemon to run as a system service. The\nconfiguration for this service can be tuned using the\n[node attributes](attributes/default.rb). Additionally, a resource is\nprovided to configure plugins for the daemon. After a plugin has been\nconfigured the daemon should be restarted.\n\n### Enabling Syslog\nOne of the simplest plugins to enable is the [collectd Syslog plugin][3]\nwhich receives log messages from the daemon and dispatches them to the\nto syslog. This allows the daemon's logs to easily integrate with\nexisting UNIX utilities.\n```ruby\ncollectd_plugin 'syslog' do\n  options do\n    log_level 'info'\n    notify_level 'OKAY'\n  end\nend\n```\n\n## Advanced Usage\nIn order to enable the full functionality of some of the more\nintrusive collectd plugins the daemon will need to run as the root\nuser. Since this is obviously a security risk it is not the default.\nTo achieve this behavior you're required to write a\n[wrapper cookbook][5] which overrides the service user with the proper\nroot user.\n```ruby\nnode.default['collectd']['service_user'] = node['root_user']\nnode.default['collectd']['service_group'] = node['root_group']\ninclude_recipe 'collectd::default'\n```\n\n[0]: http://blog.vialstudios.com/the-environment-cookbook-pattern#theapplicationcookbook\n[1]: https://collectd.org\n[2]: https://github.com/test-kitchen/test-kitchen\n[3]: https://collectd.org/wiki/index.php/Plugin:SysLog\n[4]: https://github.com/bloomberg/collectd_plugins-cookbook\n[5]: http://blog.vialstudios.com/the-environment-cookbook-pattern/#thewrappercookbook\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbloomberg%2Fcollectd-cookbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbloomberg%2Fcollectd-cookbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbloomberg%2Fcollectd-cookbook/lists"}