{"id":15284185,"url":"https://github.com/soylent/konstantin-fluentd","last_synced_at":"2026-02-20T01:01:46.948Z","repository":{"id":55842209,"uuid":"44570127","full_name":"soylent/konstantin-fluentd","owner":"soylent","description":"Fluentd Puppet Module","archived":false,"fork":false,"pushed_at":"2024-02-28T22:20:02.000Z","size":93,"stargazers_count":9,"open_issues_count":7,"forks_count":33,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-10T03:29:41.656Z","etag":null,"topics":["fluentd","puppet"],"latest_commit_sha":null,"homepage":"https://forge.puppetlabs.com/konstantin/fluentd","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soylent.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-10-19T23:31:22.000Z","updated_at":"2020-03-08T22:50:18.000Z","dependencies_parsed_at":"2024-06-19T00:24:19.356Z","dependency_job_id":null,"html_url":"https://github.com/soylent/konstantin-fluentd","commit_stats":{"total_commits":109,"total_committers":12,"mean_commits":9.083333333333334,"dds":"0.12844036697247707","last_synced_commit":"4dfc15a70970fc9e182c876d6dc74b3764fbea4b"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/soylent/konstantin-fluentd","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soylent%2Fkonstantin-fluentd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soylent%2Fkonstantin-fluentd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soylent%2Fkonstantin-fluentd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soylent%2Fkonstantin-fluentd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soylent","download_url":"https://codeload.github.com/soylent/konstantin-fluentd/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soylent%2Fkonstantin-fluentd/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29637916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T22:32:43.237Z","status":"ssl_error","status_checked_at":"2026-02-19T22:32:38.330Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["fluentd","puppet"],"created_at":"2024-09-30T14:50:31.811Z","updated_at":"2026-02-20T01:01:46.928Z","avatar_url":"https://github.com/soylent.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fluentd\n\n[![Build Status](https://travis-ci.org/soylent/konstantin-fluentd.svg?branch=master)](https://travis-ci.org/soylent/konstantin-fluentd)\n\nInstall, configure, and manage Fluentd data collector.\n\n## Module Description\n\n* Installs `td-agent` package\n* Generates configuration file `td-agent.conf`\n* Generates custom configuration files and saves them to `config.d/`\n* Manages `td-agent` service\n* Installs Fluentd gem plugins\n\n## Usage Examples\n\n### Basic\n\nInstall and start the service.\n\n```puppet\nclass { 'fluentd': }\n```\n\n### Routing Events To Elasticsearch\n\nReceive logs from other Fluentd instances and via UNIX domain socket. Forward\nthe logs to Elasticsearch.\n\n```puppet\ninclude fluentd\n\nfluentd::plugin { 'fluent-plugin-elasticsearch': }\n\nfluentd::config { '500_elasticsearch.conf':\n  config =\u003e {\n    'source' =\u003e [\n      {\n        'type' =\u003e 'forward',\n      },\n      {\n        'type' =\u003e 'unix',\n        'path' =\u003e '/tmp/td-agent/td-agent.sock',\n      },\n    ],\n    'match'  =\u003e {\n      'tag_pattern'     =\u003e '**',\n      'type'            =\u003e 'elasticsearch',\n      'index_name'      =\u003e 'foo',\n      'type_name'       =\u003e 'bar',\n      'logstash_format' =\u003e true,\n    }\n  }\n}\n```\n\n### Forwarding Events To Fluentd Aggregator\n\nRead logs from UNIX domain socket, then forward them to Fluentd aggregators.\n\n```puppet\ninclude fluentd\n\nfluentd::config { '600_forwarding.conf':\n  config =\u003e {\n    'source' =\u003e {\n      'type' =\u003e unix,\n      'path' =\u003e '/tmp/td-agent/td-agent.sock',\n    },\n    'match'  =\u003e {\n      'tag_pattern' =\u003e '**',\n      'type'        =\u003e forward,\n      'server'      =\u003e [\n        { 'host' =\u003e 'example1.com', 'port' =\u003e 24224 },\n        { 'host' =\u003e 'example2.com', 'port' =\u003e 24224 },\n      ]\n    }\n  }\n}\n```\n\n### Hiera Support\n\nDefining Fluentd resources in Hiera.\n\n```yaml\nfluentd::plugins:\n  'fluent-plugin-http':\n    plugin_ensure: 0.1.0\n  'fluent-plugin-elasticsearch':\n    plugin_ensure: present\nfluentd::configs:\n  '100_fwd.conf':\n    config:\n      source:\n        type: forward\n  '200_stdout.conf':\n    config:\n      match:\n        tag_pattern: test\n        type: stdout\n```\n\n### Config File Naming\n\nAll configs employ a numbering system in the resource's title that is used for\nordering. When titling your config, make sure you prefix the filename with a\nnumber, for example, `999_catch_all.conf`, `500_elasticsearch.conf` (999 has\nsmaller priority than 500)\n\n## Reference\n\n### Classes\n\n#### Public Classes\n\n* `fluentd`: Main class, includes all other classes.\n\n#### Private Classes\n\n* `fluentd::install`: Handles the packages.\n* `fluentd::service`: Handles the service.\n\n### Parameters\n\nThe following parameters are available in the `fluentd` class:\n\n#### `repo_install`\n\nDefault value: true\n\n#### `repo_name`\n\nDefault value: 'treasuredata'\n\n#### `repo_desc`\n\nDefault value: 'TreasureData'\n\n#### `repo_url`\n\nDefault value: 'http://packages.treasuredata.com/2/redhat/$releasever/$basearch'\n\n#### `repo_enabled`\n\nDefault value: true\n\n#### `repo_gpgcheck`\n\nDefault value: true\n\n#### `repo_gpgkey`\n\nDefault value: 'https://packages.treasuredata.com/GPG-KEY-td-agent'\n\n#### `repo_gpgkeyid`\n\nDefault value: 'C901622B5EC4AF820C38AB861093DB45A12E206F'\n\n#### `package_name`\n\nDefault value: 'td-agent'\n\n#### `package_ensure`\n\nDefault value: present\n\n#### `service_name`\n\nDefault value: 'td-agent'\n\n#### `service_ensure`\n\nDefault value: running\n\n#### `service_enable`\n\nDefault value: true\n\n#### `service_manage`\n\nDefault value: true\n\n#### `service_provider`\n\nDefault value:\n\n  - when `$facts['osfamily'] == 'redhat'`: redhat\n  - otherwise: undef\n\n#### `config_file`\n\nDefault value: '/etc/td-agent/td-agent.conf'\n\n#### `config_path`\n\nDefault value: '/etc/td-agent/config.d'\n\n#### `config_owner`\n\nDefault value: 'td-agent'\n\n#### `config_group`\n\nDefault value: 'td-agent'\n\n#### `configs`\n\nDefault value: {}\n\n#### `plugins`\n\nDefault value: {}\n\n### Public Defines\n\n* `fluentd::config`: Generates custom configuration files.\n* `fluentd::plugin`: Installs plugins.\n\nThe following parameters are available in the `fluentd::plugin` defined type:\n\n#### `title`\n\nPlugin name\n\n#### `plugin_ensure`\n\nDefault value: present\n\n#### `plugin_source`\n\nDefault value: 'https://rubygems.org'\n\n#### `plugin_provider`\n\nDefault value: tdagent\n\n#### `plugin_install_options`\n\nDefault value: []\nsee https://docs.puppetlabs.com/puppet/latest/reference/type.html#package-provider-gem,\ne.g.\n\n```puppet\nplugin_install_options =\u003e [{'--http-proxy' =\u003e $http_proxy}]\n```\n\nThe following parameters are available in the `fluentd::config` defined type:\n\n#### `title`\n\nConfig filename\n\n#### `config`\n\nConfig Hash, please see usage examples.\n\n## Limitations\n\nTested on CentOS 6, CentOS 7, Ubuntu 14.04, Debian 7.8\n\n## Development\n\nBug reports and pull requests are welcome!\n\n### Running Tests\n\n    $ bundle install\n    $ bin/rake lint\n    $ bin/rake metadata_lint\n    $ bin/rake spec\n    $ bin/rspec spec/lib\n    $ bin/rake beaker BEAKER_set=centos-6-x64\n    $ bin/rake beaker BEAKER_set=centos-7-x64\n    $ bin/rake beaker BEAKER_set=debian-7-amd64\n    $ bin/rake beaker BEAKER_set=ubuntu-server-1404-x64\n\n## License\n\nCopyright SPB TV AG\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use\nthis file except in compliance with the License.\n\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed\nunder the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR\nCONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and limitations\nunder the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoylent%2Fkonstantin-fluentd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoylent%2Fkonstantin-fluentd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoylent%2Fkonstantin-fluentd/lists"}