https://github.com/ivlyth/process-bandwidth

an ebpf based program which focus on process's network bandwidth, like Nethogs but provides every connection's bandwidth as well, and even terminal graph
https://github.com/ivlyth/process-bandwidth

cli ebpf nethogs process-bandwidth

Last synced: 2 months ago
JSON representation

an ebpf based program which focus on process's network bandwidth, like Nethogs but provides every connection's bandwidth as well, and even terminal graph

• Host: GitHub
• URL: https://github.com/ivlyth/process-bandwidth
• Owner: Ivlyth
• License: mit
• Created: 2022-08-21T12:40:47.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-11-16T15:30:20.000Z (about 2 years ago)
• Last Synced: 2024-09-28T20:05:25.837Z (3 months ago)
• Topics: cli, ebpf, nethogs, process-bandwidth
• Language: C
• Homepage:
• Size: 1.84 MB
• Stars: 28
• Watchers: 1
• Forks: 2
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
`process-bandwidth` is an ebpf based program which focus on process's network bandwidth (include each connection).

it provides a clean terminal UI based on [tview](https://github.com/rivo/tview) (as a CLI tool), and provides a 

simple API to export data for prometheus (as a long-running task).

### Screenshots

![screenshot-top](./screenshots/pb-v0.3.1.png)

![screenshot-options](./screenshots/pb-v0.3.1-optons.png)

### Usage

in `top` mode, you can open/close settings by press `F4`, exit by press `ESC` or CTRL+C, and pause/resume the update by 

press `F5`, and you can click on the table header line (currently only support `In`, `Out`, `Total`) to change the sort 

column and order 

also you can use `tab` to change focus between process's table、connection's table and filter input box, and you can use up/down keys to  

scroll in the table, press the Enter key to choose current process or connection

### Requirements

linux kernel version >= 3.10

### Installation

please download through GitHub's release page, or you can build your own by just run `make` under the root 

directory of the project

### Filter

##### filter processes (default mode)

- GetConnections.ConnectionInfo.LocalPort=9091 or Name=java

##### filter connections (you should check the Connes and uncheck the Process)

- ConnectionInfo.LocalPort = 2181 or ConnectionInfo.LocalPort = 9091

##### filter both (you should check the both)

> Note: filter processes and connections at the same time it's only meaningful that you filter processes based on connection

and you want see connections only satisfies the filter for process. so we just use `or` to concat two (or more) filter,

but we know that one is for process and another is for connection. 

- GetConnections.ConnectionInfo.LocalPort = 2181 or ConnectionInfo.LocalPort = 2181

> filter function implement based on [uni-filter](https://github.com/Ivlyth/uni-filter), see more document [here](https://github.com/Ivlyth/uni-filter/blob/main/README.md)

## Thanks

- [tview](https://github.com/rivo/tview)

- [asciigraph](https://github.com/guptarohit/asciigraph)

  - I made a [copy](https://github.com/Ivlyth/process-bandwidth/blob/main/pkg/asciigraph) to support colors in tview's TextView component

- [ebpf](https://github.com/cilium/ebpf)

- [eCapture](https://github.com/ehids/ecapture)