tcptrace

KO | EN

gitlite — search

#javascript #react #ai #llm #golang #deep-learning #macos #windows #cli #kubernetes #awesome-list #pytorch #mcp #open-source

(★ 17)

TCP internal state tracing on Linux.

tcptrace Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# TCP Trace - Hackathon Project

TCP Trace is a PoC implementation for the [Hackathon Idea](https://hackbox.microsoft.com/project/772). The idea is to detect network errors by tracing internal TCP state on Linux:

>This project aims to isolate network-related errors by tracing the server-side TCP Retransmits at the node level. The project will keep retransmit counts per service >identifier like cgroup and port. It will allow early detection of network-related issues, which will help during an incident, and, in some cases, help prevent customer-impacting problems.

TCP Trace uses three [eBPF](https://ebpf.io/what-is-ebpf/) programs to hook into various **attach points** in the Linux kernel:

- tc ingress: Number of incoming TCP packets.
- tc egress: Number of outgoing TCP packets.
- tcp_retransmit_skb: Number of TCP retransmits.

## Build

TCP Trace consists of two parts; eBPF objects (programs, maps) and a user-space program. User-space program uses [libebpf-bootsrap](https://github.com/libbpf/libbpf-bootstrap) to load and attach eBPF objects into the kernel. After being loaded, eBPF programs and maps completely run in the kernel space (crazy efficient!). Since eBPF maps are reachable from the userspace, It is very easy to share data between eBPF programs and the user-space application.

![image](https://user-images.githubusercontent.com/10650777/188182966-2f855f51-b506-4555-a220-9359c99d282d.png)

* Install build dependencies:

```
  sudo apt install clang llvm pkg-config libelf1 libelf-dev zlib1g-dev
  ```
* Install submodule dependencies (libbpf-bootstrap) and build

```
  make init && make
  ```
* Run the PoC binary
  ```
  sudo ./src/tcp_tracing
  ```

tcptrace

tcptrace Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

tcptrace

tcptrace Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README