{"id":15517031,"url":"https://github.com/deric/puppet-hindsight","last_synced_at":"2025-04-23T04:11:46.970Z","repository":{"id":57666944,"uuid":"87181875","full_name":"deric/puppet-hindsight","owner":"deric","description":"Manages Hindsight log processing engine","archived":false,"fork":false,"pushed_at":"2024-06-22T08:02:09.000Z","size":168,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-14T23:05:43.062Z","etag":null,"topics":["hindsight","log-analysis","logging"],"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/deric.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-04T12:06:38.000Z","updated_at":"2024-06-22T08:00:13.000Z","dependencies_parsed_at":"2023-02-01T06:01:05.417Z","dependency_job_id":null,"html_url":"https://github.com/deric/puppet-hindsight","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-hindsight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-hindsight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-hindsight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-hindsight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deric","download_url":"https://codeload.github.com/deric/puppet-hindsight/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250366725,"owners_count":21418772,"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":["hindsight","log-analysis","logging"],"created_at":"2024-10-02T10:10:56.782Z","updated_at":"2025-04-23T04:11:46.945Z","avatar_url":"https://github.com/deric.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# puppet-hindsight\n\n[![Puppet\nForge](http://img.shields.io/puppetforge/v/deric/hindsight.svg)](https://forge.puppetlabs.com/deric/hindsight) [![Puppet Forge\nDownloads](http://img.shields.io/puppetforge/dt/deric/hindsight.svg)](https://forge.puppetlabs.com/deric/hindsight/scores) [![Test](https://github.com/deric/puppet-hindsight/actions/workflows/test.yml/badge.svg)](https://github.com/deric/puppet-hindsight/actions/workflows/test.yml)\n\nModule for managing Mozilla's Hindsight configuration and service.\n\n## Related projects\n\nHindsight is a log forwarding engine (successor of Mozilla's Heka) implemented in low-level C with Lua scripting support.\n\n  * [hindsight](https://github.com/mozilla-services/hindsight)\n  * [lua_sandbox](https://github.com/mozilla-services/lua_sandbox)\n  * [lua_sandbox_extensions](https://github.com/mozilla-services/lua_sandbox_extensions)\n\n## Usage\n\nAll module names are expected to be available via package manager.\n\n```puppet\n  class{'::hindsight':\n    modules =\u003e [ 'luasandbox','luasandbox-elasticsearch',\n    'luasandbox-kafka','luasandbox-lpeg','luasandbox-systemd']\n  }\n```\nplugin configuration:\n\n```puppet\n  hindsight::plugin {'tcp':\n    filename =\u003e 'tcp.lua',\n    target   =\u003e 'input/tcp',\n    config   =\u003e {\n      instruction_limit =\u003e 0,\n      address =\u003e \"0.0.0.0\",\n      port =\u003e 5858,\n      keep_payload =\u003e false,\n      send_decode_failures =\u003e true,\n    }\n  }\n```\n`target` is file location in `run_dir` without extension (`.cfg`).\n\nThe simplest plugin is probably `debug`:\n\n```puppet\nhindsight::plugin {'debug':\n  filename =\u003e 'heka_debug.lua',\n  target   =\u003e 'output/debug',\n  config   =\u003e {\n    message_matcher =\u003e 'TRUE',\n  }\n}\n```\nin order to disable plugin use `ensure =\u003e absent`:\n\n```puppet\n  hindsight::plugin {'debug':\n    ensure   =\u003e absent,\n    filename =\u003e 'heka_debug.lua',\n    target   =\u003e 'output/debug',\n  }\n```\n\nNew since version `0.3.0`\n\n```puppet\n  hindsight::plugin {'debug':\n    filename =\u003e '',\n    target   =\u003e output/debug',\n    content  =\u003e template('path/to/template.erb');\n  }\n  # or\n  hindsight::plugin {'debug':\n    filename =\u003e '',\n    target   =\u003e output/debug',\n    source   =\u003e 'puppet:///fubarmodule/debug.cfg';\n  }\n```\n\n## Service pre-start commands\n\nBefore starting Hindsight service custom commands can be provided:\n\n```puppet\n  class{'::hindsight':\n    service_prestart =\u003e [ '/bin/echo foo', '/bin/echo bar']\n  }\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderic%2Fpuppet-hindsight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fderic%2Fpuppet-hindsight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderic%2Fpuppet-hindsight/lists"}