witr: CLI truy vết process, port và container

Thách Thức Về Tính Nhân Quả Của Hệ Thống

Khoảng trống mà witr lấp đầy là: ps, top, lsof, ss, systemctl, và docker ps đều chỉ cho thấy trạng thái, không cho thấy nguyên nhân — bạn có một PID hay một socket đang lắng nghe, nhưng phải tự đối chiếu thủ công giữa các systemd unit, shell cha, session tmux, và container runtime để hiểu ai thực sự đã khởi động nó và vì sao nó vẫn đang chạy. witr coi đây là một câu hỏi duy nhất và dựng chuỗi nhân quả (supervisor, container, shell, hoặc session) chỉ trong một lệnh thay vì năm lệnh.

witr Làm Gì

witr là một công cụ command-line kiêm terminal UI viết bằng Go, giúp truy vết một process đang chạy, một port đang mở, một container, hoặc một file đang bị giữ, về đúng chuỗi hệ thống đã khởi động nó. witr hoạt động từ các truy vấn theo process, port, file, hoặc container, hoặc qua một TUI tương tác với bốn tab bao phủ process, port, container, và file lock, và có thể in kết quả dưới dạng text dễ đọc hoặc JSON máy đọc được.

Các Khả Năng Và Chế Độ Chính

• ✓Một lệnh duy nhất trả lời 'vì sao cái này đang chạy' bằng cách dựng chuỗi nhân quả — README gọi đây là giá trị cốt lõi của công cụ — thay vì chỉ liệt kê trạng thái từ các công cụ riêng lẻ.
• ✓Bốn chế độ truy vấn có thể lặp lại và kết hợp trong cùng một lệnh: --pid, --port, --file, và --container, cộng với tìm theo tên process ở dạng positional (mặc định khớp theo substring, dùng --exact để khớp chính xác).
• ✓Một TUI tương tác bốn tab (Processes, Ports, Containers, Locks) với side panel trực tiếp, hỗ trợ chuột, cột có thể sort/filter, và theme sáng/tối tự thích ứng.
• ✓Nhận diện container trên tám runtime chỉ trong một truy vấn: Docker, Podman, nerdctl, K8s/crictl, Incus, LXC, LXD, và FreeBSD jails, khớp theo tên, image, command, hoặc compose project/service label.
• ✓Thao tác trên process ngay trong TUI — gửi signal Kill, Terminate, Pause, Resume, hoặc renice một process — trên hệ Unix.
• ✓Output --json cùng sáu exit code (0-5) có ý nghĩa cụ thể, được thiết kế cho script, CI pipeline, và các bước kiểm tra monitoring, chứ không chỉ để đọc trên terminal.
• ✓Gán nguồn gốc (source) theo kiểu best-effort, chỉ chọn một nguyên nhân chính cho mỗi process — một systemd unit kèm lịch chạy, một session SSH kèm IP từ xa, một container docker, pm2, cron, hay một session tmux/screen được phát hiện — thay vì liệt kê mọi yếu tố liên quan.
• ✓Các panel trong TUI tự làm mới theo chu kỳ thích ứng, bắt đầu ở 3 giây và giãn ra khi hệ thống đang tải nặng.

Khi Nào Nên Dùng witr

• •Tìm ra thứ gì đang chiếm một port trước khi bạn khởi động service của mình, ví dụ witr --port 5000 --short để lấy chuỗi nhân quả chỉ trong một dòng.
• •Truy nguyên nhân gốc của một container cứ restart liên tục hoặc không chịu dừng, bằng cách truy vấn theo tên, image, hoặc compose project trên các runtime Docker/Podman/K8s.
• •Ứng phó sự cố (incident response), khi bạn cần chuỗi nhân quả — chứ không chỉ một PID — để giải thích cho team vì sao một process tồn tại và ai đang supervise nó.
• •Tìm ra thứ gì đang giữ một file lock, giống ví dụ dpkg lock trong README (witr --file /var/lib/dpkg/lock).
• •Khám phá hệ thống trực tiếp qua TUI khi bạn muốn xem process, port, container, và lock cùng lúc thay vì chạy bốn lệnh riêng biệt.
• •Viết script health check hoặc CI gate dựa trên exit code và output --json của witr, thay vì parse output dạng free-text từ ps/lsof.

Bắt Đầu Với witr

witr được phân phối dưới dạng một binary tĩnh duy nhất cho Linux, macOS, FreeBSD, và Windows, không cần cài thêm runtime dependency riêng. Cách nhanh nhất là dùng install script — curl -fsSL https://raw.githubusercontent.com/pranshuparmar/witr/main/install.sh | bash trên Unix, hoặc irm .../install.ps1 | iex trong PowerShell trên Windows — nhưng README còn liệt kê cài qua package manager cho apt (Ubuntu 26.04+ và Debian sid trở lên), Homebrew, MacPorts, Conda/mamba/pixi, AUR (witr-bin), winget, npm (@pranshuparmar/witr), FreeBSD Ports, Chocolatey, Scoop, AOSC OS, GNU Guix, Uniget, Aqua, Brioche, và Mise, cùng các package .deb/.rpm/.apk dựng sẵn và go install github.com/pranshuparmar/witr/cmd/witr@latest để cài từ source. README ghi chú rằng các bản đóng gói qua cộng đồng (apt, các package theo dõi trên Repology) có thể chậm hơn bản release mới nhất trên GitHub.

Sử Dụng witr: Lệnh Và Kết Quả Đầu Ra

Chạy witr không kèm argument, hoặc với -i / --interactive, để mở bốn tab của TUI (Processes, Ports, Containers, Locks). Để có câu trả lời nhanh, truyền vào tên process (witr node), hoặc một target flag: --pid, --port, --file, hay --container — cả bốn đều có thể lặp lại và kết hợp trong cùng một lệnh gọi. --short chỉ in ra dòng ancestry, --tree hiển thị dưới dạng cây (giới hạn 10 process con), và --json trả về output máy đọc được cho script. --exact tắt chế độ khớp tên theo substring/fuzzy mặc định. Khi một truy vấn không rõ ràng, witr liệt kê mọi kết quả khớp kèm PID và hướng dẫn chạy lại, thay vì tự đoán bạn muốn nói đến process nào.

Các Công Cụ Quan Sát Hệ Thống Khác

Ai Sẽ Được Lợi Từ witr?

witr đáng cài nếu bạn là developer, sysadmin, hay kỹ sư on-call thường xuyên phải hỏi 'cái gì đã khởi động cái này' về một process, port, hay container — nhất là khi bạn làm việc với Docker/Podman/Kubernetes và muốn dùng một công cụ duy nhất thay vì tự ghép output từ ps, lsof, và docker ps. Bỏ qua nó nếu hệ thống của bạn đơn giản tới mức bạn đã biết rõ nguồn gốc của mọi process, hoặc nếu bạn cần soi network traffic ở mức packet — witr giải thích nguồn gốc và ngữ cảnh, không phải traffic mạng.

Câu Hỏi Thường Gặp Về witr

Repo liên quan