{"id":13594897,"url":"https://github.com/Devrama/wonlog","last_synced_at":"2025-04-09T10:32:15.592Z","repository":{"id":46790857,"uuid":"222302561","full_name":"Devrama/wonlog","owner":"Devrama","description":"Stream your local logs to browsers.","archived":false,"fork":false,"pushed_at":"2023-07-06T15:14:30.000Z","size":1923,"stargazers_count":5,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-24T08:26:38.226Z","etag":null,"topics":["browser","log","logging","logio","monitoring","rtail","stream"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"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/Devrama.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":"2019-11-17T19:46:08.000Z","updated_at":"2023-02-27T00:46:29.000Z","dependencies_parsed_at":"2024-01-14T04:40:11.192Z","dependency_job_id":"3018a2ae-e9d0-435e-b57b-2ef43c1e6b0b","html_url":"https://github.com/Devrama/wonlog","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devrama%2Fwonlog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devrama%2Fwonlog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devrama%2Fwonlog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devrama%2Fwonlog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Devrama","download_url":"https://codeload.github.com/Devrama/wonlog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247550677,"owners_count":20956986,"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":["browser","log","logging","logio","monitoring","rtail","stream"],"created_at":"2024-08-01T16:01:40.558Z","updated_at":"2025-04-09T10:32:12.092Z","avatar_url":"https://github.com/Devrama.png","language":"TypeScript","readme":"# wonlog\n\nStream your local logs to browsers.\n\nThis project is inspired by [rtail](https://github.com/kilianc/rtail).\n\n## Features\n\n- stream raw text or JSON string logs to browser\n- search logs by a keyword\n- multiple log streams to a browser\n- sort logs\n- uses WebSocket\n\n## Screenshots\n\n![Screenshot - darkmode](https://raw.githubusercontent.com/Devrama/wonlog/master/docs/assets/images/screenshot1.png)\n![Screenshot - lightmode](https://raw.githubusercontent.com/Devrama/wonlog/master/docs/assets/images/screenshot2.png)\n![Screenshot - search \u0026 settings](https://raw.githubusercontent.com/Devrama/wonlog/master/docs/assets/images/screenshot3.png)\n![Screenshot - detail view](https://raw.githubusercontent.com/Devrama/wonlog/master/docs/assets/images/screenshot4.png)\n\n## Installing\n\nUsing npm:\n```bash\n$ npm install -g wonlog\n```\n\nUsing yarn:\n```bash\n$ yarn global add wonlog\n```\n\n## How to use\n\n### First, run a wonlog server\n```bash\n$ wonlog-server\n```\n\n### Second, open your browser with `http://localhost:7979`\n\n### Third, pipe your log to wonlog agents\n\n```bash\n# streaming output of you node server logs to wonlog agent\n$ node your_express_server.js | wonlog-agent --stream-name='My First Log stream' --verbose\n\n# openning a log file to wonlog agent\n$ cat log_file.txt | wonlog-agent --stream-name='My First Log stream' --verbose\n\n# streaming from a growing log file to wonlog agent\n$ tail -F log_file.txt | wonlog-agent --stream-name='My First Log stream' --verbose\n\n# streaming from JSON to wonlog agent\n$ echo '{ \"foo\": \"bar\" }' | wonlog-agent --stream-name='My First Log stream' --verbose\n$ echo \"{ foo: 'JSON5' }\" | wonlog-agent --stream-name='My First Log stream' --verbose\n```\n\n# JSON log format\n\n## Reserved Properties\n\n- `timestamp`: If `timestamp` property exists in a JSON formt log with either ISO Date string or the number of milliseconds elapsed since Janunary 1, 1970, `TIMESTAMP` column on wonlog screen shows it instead of the `timestamp` of current time.\n- `message`: If `message` property exists in a JSON format log, `MESSAGE` column shows it instead of stringified log.\n- `level`: If `level` property exists with values below in a JSON format log, `TIMESTAMP` column shows in different colors.\n    - `critical` or `fatal`\n    - `error`\n    - `warn` or `warning`\n    - `info`\n    - `debug`\n    - `trace`\n\n# CLI options\n\n## `wonlog-server`\n\n```bash\n$ wonlog-server --help\nUsage: wonlog-server [options]\n\nOptions:\n  --webapp-host [host]  WebApp Server host (default: \"0.0.0.0\")\n  --webapp-port [port]  WebApp Server port (default: \"7979\")\n  --server-host [host]  HTTP Server host (default: \"0.0.0.0\")\n  --server-port [port]  HTTP Server port (default: \"7978\")\n  -h, --help            display help for command\n```\n\n## `wonlog-agent`\n\n```\n$ wonlog-agent --help\nUsage: wonlog-agent [options]\n\nOptions:\n  -h, --server-host [host]  HTTP Server host (default: \"127.0.0.1\")\n  -p, --server-port [port]  HTTP Server port (default: \"7978\")\n  -s, --stream-name [name]  Stream name\n  -v, --verbose [type]      Print logs (default: false)\n  --help                    display help for command\n```\n\n# Running `wonlog-server` with Docker\n\n```bash\n$ docker pull devrama/wonlog:latest\n$ docker run --name wonlog-server -d -p 7979:7979 -p 7978:7978 devrama/wonlog:latest\n```\n","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDevrama%2Fwonlog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDevrama%2Fwonlog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDevrama%2Fwonlog/lists"}