{"id":19788356,"url":"https://github.com/graylog2/graylog-guide-chef","last_synced_at":"2025-05-01T00:31:01.669Z","repository":{"id":30512675,"uuid":"34067117","full_name":"Graylog2/graylog-guide-chef","owner":"Graylog2","description":"Chef handler to send events to Graylog via GELF HTTP","archived":false,"fork":false,"pushed_at":"2019-04-11T16:26:18.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":4,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-04-15T00:39:04.893Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Graylog2.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}},"created_at":"2015-04-16T16:28:00.000Z","updated_at":"2021-05-10T06:06:33.000Z","dependencies_parsed_at":"2022-08-17T20:05:35.916Z","dependency_job_id":null,"html_url":"https://github.com/Graylog2/graylog-guide-chef","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Graylog2%2Fgraylog-guide-chef","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Graylog2%2Fgraylog-guide-chef/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Graylog2%2Fgraylog-guide-chef/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Graylog2%2Fgraylog-guide-chef/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Graylog2","download_url":"https://codeload.github.com/Graylog2/graylog-guide-chef/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224229149,"owners_count":17277137,"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-12T06:26:58.043Z","updated_at":"2024-11-12T06:26:58.596Z","avatar_url":"https://github.com/Graylog2.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Chef::Handler::Graylog\n\nThis gem provides a `Chef::Handler` that subscribes to various Chef runtime\nevents.\n\nAll captured events will be sent to a Graylog server via GELF HTTP.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'chef-handler-graylog'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install chef-handler-graylog\n\n## Requirements\n\nA Graylog server with a running GELF HTTP input is required to receive events\nsent by this plugin.\n\n## Usage\n\nThe gem includes a Chef start handler and needs to be configured in the `client.rb`\nconfiguration. Make sure to wrap the initialization in a begin/rescue block\nto avoid killing the Chef client due to errors.\n\n```ruby\nbegin\n  require 'chef/handler/graylog/gelf_start_handler'\n\n  # IP address and port of the GELF HTTP input on your Graylog server.\n  graylog_server_url = 'http://10.0.2.2:12201/gelf'\n  options = {}\n\n  start_handlers \u003c\u003c Chef::Handler::Graylog::GelfStartHandler.new(graylog_server_url, options)\nrescue Object =\u003e e\n  Chef::Log.error(\"Loading Graylog start handler failed: #{e.message}\")\nend\n```\n\n### Available Options\n\n* `:timeout` - The timeout for the GELF HTTP requests in seconds. (default: `1`)\n  Make sure to choose a small timeout because the plugin might try to send a\n  lot of HTTP requests. A big timeout will slow down the Chef run in case of\n  an error while sending the events.\n* `:ssl_verify_mode` - Can either be set to `:verify_peer` or `:verify_none`. (default: `:verify_peer`)\n* `:ssl_ca_path` - Directory that holds the certificate authority. (default: `nil`)\n* `:ssl_ca_file` - File that holds the certificate authority. (default: `nil`)\n* `:ssl_client_cert` - Client certificate used for authentication. (default: `nil`)\n* `:ssl_client_key` - Client key used for authentication. (default: `nil`)\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\n1. Fork it ( https://github.com/Graylog2/graylog-guide-chef/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraylog2%2Fgraylog-guide-chef","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgraylog2%2Fgraylog-guide-chef","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraylog2%2Fgraylog-guide-chef/lists"}