{"id":20445902,"url":"https://github.com/rapid7/le_chef","last_synced_at":"2025-08-21T03:33:05.379Z","repository":{"id":1645274,"uuid":"2370790","full_name":"rapid7/le_chef","owner":"rapid7","description":null,"archived":true,"fork":false,"pushed_at":"2024-11-06T08:53:22.000Z","size":61,"stargazers_count":20,"open_issues_count":14,"forks_count":34,"subscribers_count":59,"default_branch":"master","last_synced_at":"2025-03-22T08:13:06.589Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rapid7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2011-09-12T12:00:49.000Z","updated_at":"2025-03-05T09:43:51.000Z","dependencies_parsed_at":"2024-01-26T12:47:24.007Z","dependency_job_id":null,"html_url":"https://github.com/rapid7/le_chef","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/rapid7/le_chef","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rapid7%2Fle_chef","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rapid7%2Fle_chef/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rapid7%2Fle_chef/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rapid7%2Fle_chef/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rapid7","download_url":"https://codeload.github.com/rapid7/le_chef/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rapid7%2Fle_chef/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271420553,"owners_count":24756594,"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","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-15T10:15:38.315Z","updated_at":"2025-08-21T03:33:05.110Z","avatar_url":"https://github.com/rapid7.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"Logentries_agent Chef Cookbook\n==============\n\nInstalls/Configures the Logentries agent to allow logging to [Logentries](https://logentries.com)\n\nRequirements\n------------\n\n### Platform:\n\n* Debian\n* Ubuntu\n* Rhel\n\n### Cookbooks:\n\nThe following are dependencies of the Logentries cookbook\n\n* apt\n* yum\n\nAttributes\n----------\n\n### Default\n\n* `node['le']['account_key']` - your Logentries account_key (this can be found following [this link](https://logentries.com/doc/accountkey/))\n* `node['le']['data_bag_name']` - Name of a data bag containing account key.\n* `node['le']['data_bag_item_name']` - Name of a data bag item containing account key.\n* `node['le']['hostname']` - sets the hostname of the log to the machine name, defaults to `node['hostname']`\n* `node['le']['logs_to_follow']` - An array of logs to follow or an array of hashes\n* `node['le']['datahub']['enable']` - To send logs to datahub set this to true. Default is false\n* `node['le']['datahub']['server_ip']` - IP of your datahub server\n* `node['le']['datahub']['port']` - port datahub is running on, normally port 10000\n* `node['le']['pull-server-side-config']` - Specifies whether to make an api call to pull configuration or not, by default this is set to true meaning an api call will be made to logentries.com. Default is true\n* `node['le']['deb']` - the distro of the debian platform , defaults to node['lsb']['codename'].\n\nNotice: If `node['le']['account_key']` is empty, then the chef will get account_key from the data bag.\n\n### Data bag\nExample of a data bag:\n\n```json\n{\n  \"id\": \"le\",\n  \"account_key\": \"f8dbebcc-f907-41e1-9089-701134572b36\"\n}\n```\n\n\n### Example of logs_to_follow\n* caveats - name needs to be unique\n\nUsage\n-----\nThere are 3 main scenarios in which the Logentries Linux Agent can be run.\n\n#### Default (no datahub and pull configuration from logentries.com)\n```ruby\noverride['le']['account_key'] = \u003clogentries_account_key\u003e\noverride['le']['logs_to_follow'] = ['/var/log/syslog']\noverride['le']['logs_to_follow'] = [{:name =\u003e 'syslog', :log =\u003e '/var/log/syslog'}]\n```\n\nThis is the normal case where you send the data directly to Logentries and get the configuration for your logs from Logentries as well.\nTo send data to logentries you will have to override node['le']['account_key']\n\n#### Local configuration only\n```ruby\noverride['le']['pull-server-side-config'] = false\noverride['le']['logs_to_follow'] = [{:name =\u003e 'syslog', :log =\u003e '/var/log/syslog', :token =\u003e '00000000-0000-0000-0000-000000000000'}]\n```\nTo send data to Logentries without specifying an account key, you can set override['le']['pull-server-side-config'] to false. This will only send the logs specified in the configuration file without contacting Logentries. In this case you have to create the logs in advance and know the tokens as well.\n\n\n#### Datahub\n```ruby\noverride['le']['datahub']['enable'] = true\noverride['le']['pull-server-side-config'] = false\noverride['le']['datahub']['server_ip'] = '1.2.3.4'\noverride['le']['datahub']['port'] = 10000\noverride['le']['logs_to_follow'] = [{:name =\u003e 'syslog', :log =\u003e '/var/log/syslog'}]\n```\nThis scenario is for datahub users looking to push a config and not need to register to send their logs to their datahub instance.\n\nUsage\n-----\n\nPut depends 'yum', and 'apt', in your metadata.rb to gain access to the resources.\n\nUpdating the Logentries Agent\n=============================\n\nRestarting the Chef script will allow the recipe to install any updates to the Logentries agent.\n\nLicense and Author\n------------------\n\n* Author:: Joe Heung (\u003cjoe.heung@logentries.com\u003e)\n\nCopyright (C) 2015, RevelOps Inc.\n\nLicense:: All rights reserved\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frapid7%2Fle_chef","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frapid7%2Fle_chef","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frapid7%2Fle_chef/lists"}