# Uroboros | A GNU/Linux Monitoring And Profiling Tool Focused On Single Processes

**URL:** <https://onehack.st/t/uroboros-a-gnu-linux-monitoring-and-profiling-tool-focused-on-single-processes/171691>\
**Category:** Tools & Scripts\
**Tags:** learning, tools, video-editing\
**Created:** [February 3, 2021, 9:54am UTC](https://onehack.st/t/uroboros-a-gnu-linux-monitoring-and-profiling-tool-focused-on-single-processes/171691 "2021-02-03T09:54:16Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![TheStrength](https://onehack.st/user_avatar/onehack.st/thestrength/32/46753_2.png) [@TheStrength](https://onehack.st/u/TheStrength)\
**Post date:** [February 3, 2021, 9:54am UTC](https://onehack.st/t/uroboros-a-gnu-linux-monitoring-and-profiling-tool-focused-on-single-processes/171691/1 "2021-02-03T09:54:16Z")

</div>

![image](https://onehack.st/uploads/default/original/3X/3/9/39dc99d92bab47867387c47a6cddea4688d655dd.png)

Uroboros is a GNU/Linux monitoring tool focused on single processes.

[![Build and Test](https://github.com/evilsocket/uroboros/workflows/Build%20and%20Test/badge.svg)](https://github.com/evilsocket/uroboros/workflows/Build%20and%20Test/badge.svg)

While utilities like top, ps and htop provide great overall details, they often lack useful temporal representation for specific processes, such visual representation of the process data points can be used to profile, debug and generally monitor its good health. There are tools like psrecord that can record some of the activity of a process, but some graphical server is required for rendering, and it’s neither complete nor realtime.

Uroboros aims to fill this gap by providing a single tool to record, replay and render in realtime process runtime information in the terminal, without affecting the process performances like more invasive ptrace based solutions would do.

[![click here for a video](https://camo.githubusercontent.com/db8b031803c951b7096ece57b5eaf3c5739467d9e0509725447060aff372985a/68747470733a2f2f61736369696e656d612e6f72672f612f3338323039312e706e67)](https://asciinema.org/a/382091)

**Work in progress**

## Usage

For the moment there are no binary releases and building from sources is the only way (requires the go compiler, will install the binary in $GOPATH/bin):

```auto
# make sure go modules are used
GO111MODULE=on go get github.com/evilsocket/uroboros/cmd/uro

```

To monitor by pid:

```auto
sudo uro -pid 1234

```

To search by process name:

```auto
sudo uro -search test-process

```

Only show a subset of tabs:

```auto
sudo uro -pid 1234 -tabs "cpu, mem, io"

```

To save a recording on disk:

```auto
sudo uro -pid 1234 -record /tmp/process-activity.dat

```

To play a recording from disk (works on any OS and does not require sudo):

```auto
uro -replay /tmp/process-activity.dat

```

For more options:

```auto
uro -help

```

### Keybindings

| Key | Action |
| --- | --- |
| | Show the next tab view. |
| | Show the previous tab view. |
| | Scroll down tables. |
| | Scroll up tables. |
| j | Scroll down lists. |
| k | Scroll up lists. |
| | Select list elements. |
| p | Pause (default and replay modes). |
| f | Fast forward (replay mode). |
| q / | Quit uro. |

## License

Released under the GPL3 license.

## GitHub:

> **[GitHub - evilsocket/uroboros: A GNU/Linux monitoring and profiling tool focused...](https://github.com/evilsocket/uroboros)**
>
> A GNU/Linux monitoring and profiling tool focused on single processes.