{"id":43068071,"url":"https://github.com/pierredavidbelanger/raftman","last_synced_at":"2026-01-31T13:20:00.109Z","repository":{"id":57518666,"uuid":"93787287","full_name":"pierredavidbelanger/raftman","owner":"pierredavidbelanger","description":"A syslog server with integrated full text search via a JSON API and Web UI","archived":false,"fork":false,"pushed_at":"2023-02-24T19:00:16.000Z","size":29,"stargazers_count":44,"open_issues_count":1,"forks_count":15,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-06-20T01:56:37.690Z","etag":null,"topics":["full-text-search","golang","log","syslog","syslog-server"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pierredavidbelanger.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2017-06-08T20:04:04.000Z","updated_at":"2024-05-04T09:41:27.000Z","dependencies_parsed_at":"2024-06-20T01:31:04.918Z","dependency_job_id":"4769dae8-6009-47fa-89b2-06df30d61f3a","html_url":"https://github.com/pierredavidbelanger/raftman","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/pierredavidbelanger/raftman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pierredavidbelanger%2Fraftman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pierredavidbelanger%2Fraftman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pierredavidbelanger%2Fraftman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pierredavidbelanger%2Fraftman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pierredavidbelanger","download_url":"https://codeload.github.com/pierredavidbelanger/raftman/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pierredavidbelanger%2Fraftman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28944317,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T13:02:32.153Z","status":"ssl_error","status_checked_at":"2026-01-31T13:00:07.528Z","response_time":128,"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":["full-text-search","golang","log","syslog","syslog-server"],"created_at":"2026-01-31T13:19:55.980Z","updated_at":"2026-01-31T13:20:00.104Z","avatar_url":"https://github.com/pierredavidbelanger.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# raftman\n\n![raftman](https://raw.githubusercontent.com/pierredavidbelanger/raftman/master/frontend/static/ui/logo-96.png)\n\nA syslog server with integrated full text search via a JSON API and Web UI.\n\n- [getting started](#getting-started)\n- [configuration](#configuration)\n\n## getting started\n\n### store logs\n\nTo get started quickly, just run the containerized version of raftman:\n\n```\nsudo docker run --rm --name raftman \\\n    -v /tmp:/var/lib/raftman \\\n    -p 514:514/udp \\\n    -p 5514:5514 \\\n    -p 8181:8181 \\\n    -p 8282:8282 \\\n    pierredavidbelanger/raftman\n```\n\n\nThis will start raftman with all default options. It listen on port 514 (UDP) and 5514 (TCP) on the host for incoming RFC5424 syslog packets and store them into an SQLite database stored in `/tmp/logs.db` on the host. It also exposes the JSON API on http://localhost:8181/api/ and the Web UI on http://localhost:8282/.\n\n### send logs\n\nTime to fill our database. The easyest way is to just start [logspout](https://github.com/gliderlabs/logspout) and tell it to point to raftman's syslog port:\n\n```\ndocker run --rm --name logspout \\\n    -v /var/run/docker.sock:/var/run/docker.sock:ro \\\n    --link raftman \\\n    gliderlabs/logspout \\\n        syslog://raftman:514\n```\n\n\nThis last container will grab other containers output lines and send them as syslog packet to the configured syslog server (ie: our linked raftman container).\n\n### generate logs\n\nNow, we also need to generate some output. This will do the job for now:\n\n```\ndocker run --rm --name test \\\n    alpine \\\n    echo 'Can you see me'\n```\n\n\n### visualise logs\n\nThen we can visualize our logs:\n\nwith the raftman API:\n\n```\ncurl http://localhost:8181/api/list \\\n    -d '{\"Limit\": 100, \"Message\": \"see\"}'\n```\n\n\nor pop the Web UI at http://localhost:8282/\n\n## configuration\n\nAll raftman configuration options are set as arguments in the command line.\n\nFor example, here is the what the command line would looks like if we set all the default values explicitly:\n\n```\nraftman \\\n    -backend sqlite:///var/lib/raftman/logs.db?insertQueueSize=512\u0026queryQueueSize=16\u0026timeout=5s\u0026batchSize=32\u0026retention=INF \\\n    -frontend syslog+udp://:514?format=RFC5424\u0026queueSize=512\u0026timeout=0s \\\n    -frontend syslog+tcp://:5514?format=RFC5424\u0026queueSize=512\u0026timeout=0s \\\n    -frontend api+http://:8181/api/ \\\n    -frontend ui+http://:8282/\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpierredavidbelanger%2Fraftman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpierredavidbelanger%2Fraftman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpierredavidbelanger%2Fraftman/lists"}