{"id":13549093,"url":"https://github.com/evilsocket/uroboros","last_synced_at":"2025-04-04T21:09:24.423Z","repository":{"id":46104487,"uuid":"325059537","full_name":"evilsocket/uroboros","owner":"evilsocket","description":"A GNU/Linux monitoring and profiling tool focused on single processes.","archived":false,"fork":false,"pushed_at":"2021-11-14T17:42:51.000Z","size":172,"stargazers_count":674,"open_issues_count":0,"forks_count":37,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-03-28T20:08:46.577Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evilsocket.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-28T16:21:56.000Z","updated_at":"2025-03-24T00:16:57.000Z","dependencies_parsed_at":"2022-08-26T06:41:12.584Z","dependency_job_id":null,"html_url":"https://github.com/evilsocket/uroboros","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilsocket%2Furoboros","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilsocket%2Furoboros/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilsocket%2Furoboros/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evilsocket%2Furoboros/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evilsocket","download_url":"https://codeload.github.com/evilsocket/uroboros/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247249530,"owners_count":20908212,"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-08-01T12:01:18.186Z","updated_at":"2025-04-04T21:09:24.399Z","avatar_url":"https://github.com/evilsocket.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"Uroboros is a GNU/Linux monitoring tool focused on single processes. \n\n![Build and Test](https://github.com/evilsocket/uroboros/workflows/Build%20and%20Test/badge.svg)\n\nWhile \nutilities like top, ps and htop provide great overall details, they often lack useful temporal representation for \nspecific processes, such visual representation of the process data points can be used to profile, debug and \ngenerally monitor its good health. There are tools like psrecord that can record some of the \nactivity of a process, but some graphical server is required for rendering, and it's neither complete nor realtime.\n\nUroboros aims to fill this gap by providing a single tool to record, replay and render in realtime process \nruntime information in the terminal, without affecting the process performances like more invasive ptrace based \nsolutions \nwould do.\n\n[![click here for a video](https://asciinema.org/a/382091.png)](https://asciinema.org/a/382091)\n\n**Work in progress**\n\n## Usage\n\nFor the moment there are no binary releases and building from sources is the only way (requires the go compiler, \nwill install the binary in $GOPATH/bin):\n\n    # make sure go modules are used\n    GO111MODULE=on go get github.com/evilsocket/uroboros/cmd/uro\n\nTo monitor by pid:\n\n    sudo uro -pid 1234\n\nTo search by process name:\n\n    sudo uro -search test-process\n\nOnly show a subset of tabs:\n\n    sudo uro -pid 1234 -tabs \"cpu, mem, io\"\n\nTo save a recording on disk:\n\n    sudo uro -pid 1234 -record /tmp/process-activity.dat\n\nTo play a recording from disk (works on any OS and does not require sudo):\n\n    uro -replay /tmp/process-activity.dat\n\nFor more options:\n    \n    uro -help\n\n### Keybindings\n\n|           Key            | Action                                                     |\n| :----------------------: | ---------------------------------------------------------- |\n| \u003ckbd\u003e\u0026lt;Right\u0026gt;\u003c/kbd\u003e | Show the next tab view. |\n| \u003ckbd\u003e\u0026lt;Left\u0026gt;\u003c/kbd\u003e  | Show the previous tab view. |\n| \u003ckbd\u003e\u0026lt;Down\u0026gt;\u003c/kbd\u003e  | Scroll down tables. |\n| \u003ckbd\u003e\u0026lt;Up\u0026gt;\u003c/kbd\u003e    | Scroll up tables. |\n|       \u003ckbd\u003ej\u003c/kbd\u003e       | Scroll down lists. |\n|       \u003ckbd\u003ek\u003c/kbd\u003e       | Scroll up lists. |\n| \u003ckbd\u003e\u0026lt;Enter\u0026gt;\u003c/kbd\u003e | Select list elements. |\n|       \u003ckbd\u003ep\u003c/kbd\u003e       | Pause (default and replay modes). |\n|       \u003ckbd\u003ef\u003c/kbd\u003e       | Fast forward (replay mode). |\n|       \u003ckbd\u003eq\u003c/kbd\u003e / \u003ckbd\u003e\u0026lt;C-c\u0026gt;\u003c/kbd\u003e | Quit uro. |\n\n## License\n\nReleased under the GPL3 license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilsocket%2Furoboros","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevilsocket%2Furoboros","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevilsocket%2Furoboros/lists"}