{"id":18605962,"url":"https://github.com/axllent/bwlog","last_synced_at":"2025-04-10T20:31:21.133Z","repository":{"id":57607867,"uuid":"179763707","full_name":"axllent/bwlog","owner":"axllent","description":"BWLog - Lightweight bandwidth logger for *nix","archived":false,"fork":false,"pushed_at":"2023-02-25T06:41:31.000Z","size":736,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-03-25T04:13:25.089Z","etag":null,"topics":["bandwidth","go","golang","logger","monitor"],"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/axllent.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-04-05T22:40:12.000Z","updated_at":"2024-09-18T22:51:51.000Z","dependencies_parsed_at":"2024-06-20T09:26:20.323Z","dependency_job_id":"ccf0ee32-0882-43ab-b970-8ce2f7702885","html_url":"https://github.com/axllent/bwlog","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fbwlog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fbwlog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fbwlog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/axllent%2Fbwlog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/axllent","download_url":"https://codeload.github.com/axllent/bwlog/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248290033,"owners_count":21078923,"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":["bandwidth","go","golang","logger","monitor"],"created_at":"2024-11-07T02:23:44.291Z","updated_at":"2025-04-10T20:31:20.851Z","avatar_url":"https://github.com/axllent.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BWLog - Lightweight bandwidth logger for *nix\n\nA lightweight bandwidth logger written in Go. The tool logs the incoming and outgoing network\ntraffic from each of the specified network interfaces, and provides a web frontend to view\nboth a live graph and statistics history for each interface.\n\n![BWLog Screenshot](screenshot.png \"BWLog Screenshot\")\n\n\n## Usage options\n\n```\nBWLog: A lightweight bandwidth logger\n\nUsage:\n  bwlog -i eth0 -d ~/bwlog/ [flags]\n  bwlog [command]\n\nAvailable Commands:\n  update      Update bwlog to the latest version\n  version     Display the app version \u0026 update information\n\nFlags:\n  -d, --database string     Database directory to save CSV files (default \"./\")\n  -i, --interfaces string   Interfaces to monitor, comma separated eg: eth0,eth1\n  -l, --listen string       Interface \u0026 port to listen on (default \"0.0.0.0:8080\")\n  -p, --password string     Auth password file (must contain a single \"\u003cuser\u003e \u003cpass\u003e\")\n  -s, --save string         How often to save the database to disk. Examples: 30s, 5m, 1h (default \"60s\")\n      --sslcert string      SSL certificate (must be used together with --sslkey)\n      --sslkey string       SSL key (must be used together with --sslcert)\n```\n\n## Installing\n\nDownload and extract suitable binary for your system from the [releases](https://github.com/axllent/bwlog/releases) page.\n\n\n## Running BWLog\n\n```shell\nbwlog -i eth0 -d ~/bwlog/\n```\n\nSee `bwlog -h` for options.\n\nUnless you have specified different listening options, you should be able to connect to `127.0.0.1:8080`\nwith your web browser.\n\n\n## Basic auth\n\nIf you want to use basic auth, simply create a file with two words in it, your username and password, eg:\n```\nMyUser MySecretPass\n```\nThen just add `-p \u003cpassword_file\u003e` to your startup flags. BWLog does not handle multiple users/passwords.\n\n\n## HTTPS\n\nTo enable HTTPS you must use both the `--sslcert` and `--sslkey` options to specify the respective certificate files.\n\n\n## Compiling from source\n\nEnsure you have `go` and `make` installed, then just:\n\n```shell\nmake\n```\n\n\n## Integrate with systemd\n\nBWLog does not have a background daemon. If you want bwlog to run automatically in the background then you can\neasily integrate it with systemd.\n\nCreate a file `/etc/systemd/system/bwlog.service`, ensuring sure you modify the  `ExecStart` to your requirements.\n\n```\n[Unit]\nDescription=BWLog\n\n[Service]\nExecStart=/usr/local/bin/bwlog -d /opt/bwlog/ -i eth0,eth1\nRestart=always\nRestartSec=10\n# Output to syslog\nStandardOutput=syslog\nStandardError=syslog\nSyslogIdentifier=bwlog\n\n[Install]\nWantedBy=multi-user.target\n```\n\nEnable the service: `systemctl enable bwlog.service`\n\nStart the service: `systemctl start bwlog.service`\n\nIf you make changes to `/etc/systemd/system/bwlog.service` you will need to `systemctl daemon-reload`\nbefore restarting the service.\n\n\n## TODOs\n\nThere are some other things I'd like to do at some stage if I ever get inspired and have some time:\n\n- Switch to vue.js\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxllent%2Fbwlog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faxllent%2Fbwlog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faxllent%2Fbwlog/lists"}