Show HN: Procinsh – Linuxプロセスを3Dでインスペクトするツール
Show HN: Procinsh – A 3D Linux process inspector (github.com)
要約
Procinshは、Linuxのプロセスをシェル上で3D表示するWebベースのインスペクターです。Rustで開発されており、プロセスの階層や詳細情報を視覚的に探索できます。インストールにはRustやBPF関連のツールが必要ですが、ソースからのビルドが推奨されています。
全文翻訳
ProcInSh - プロセスをシェルで
ProcInSh(「プロック・イン・シェル」と発音)は、Linux向けのWebベースのプロセスインスペクターです。「Ghost in the Shell」のように、ゴースト(プロセス)を漂わせながらプロセス空間を探索できます。
ブログ記事も参照してください。
インタラクティブデモを試してみてください。
質問やディスカッションは、Discordサーバーにご参加ください。
スクリーンショット
使用方法
Linux x86-64が必要です。どちらのインストール方法もネイティブコードをコンパイルするため、Rust、Cコンパイラ、BPFバックエンドを持つclang、bpftool、pkg-config、libelfおよびzlibの開発ファイル、そして/sys/kernel/btf/vmlinuxにあるBTF情報が必要です。
WSL2でのサポートは非常に限定的です。crates.ioからインストールするのではなく、ソースからProcInShをビルドすることを推奨します。
crates.ioからインストール
crates.ioからProcInShをインストールして実行してください:
(申し訳ありませんが、Ubuntuを使用していると仮定しています。それ以外の場合は適宜解釈してください)
sudo apt-get install --yes --no-install-recommends \
build-essential clang llvm pkg-config libelf-dev zlib1g-dev python3 \
linux-tools-common linux-tools-generic
cargo install procinsh --locked
その後、実行してブラウザでhttp://127.0.0.1:9090を開いてください。リモートアクセスを許可するには--allow-non-loopbackを使用しますが、注意してください。これは認証なしにプロセスメモリと環境変数を公開します。
sudo "$HOME/.cargo/bin/procinsh" --listen 127.0.0.1:9090
sudoを使いたくない場合は、代わりにsetcapを使用してください。
sudo setcap \
cap_sys_ptrace,cap_bpf,cap_perfmon,cap_dac_read_search,cap_sys_admin=ep \
"$HOME/.cargo/bin/procinsh"
"$HOME/.cargo/bin/procinsh" --listen 127.0.0.1:9090
CAP_SYS_ADMINは、他のネットワーク名前空間でのUNIXソケットピア診断を有効にします。これがない場合、ProcInShは利用可能なソケット情報を保持し、欠落しているピア診断を警告として報告します。不明なピアは、接続されていないソケットを意味するわけではありません。
Linuxでのセルフビルド
Ubuntu
Node.js 22.12以降(npm付き)と、rustup経由のRustも必要です。Rustのバージョンとコンポーネントはrust-toolchain.tomlでピン留めされており、必要に応じてrustupが自動的にインストールします。
このリポジトリをクローンし、ルートディレクトリから以下を実行してください:
sudo apt-get install --yes --no-install-recommends \
build-essential clang llvm pkg-config libelf-dev zlib1g-dev python3 \
linux-tools-common linux-tools-generic
npm --prefix web ci
npm --prefix web run build
cargo build --release --locked
その後、実行します:
sudo ./target/release/procinsh --listen 127.0.0.1:9090
NixOS
rustup経由でRustをインストールした場合、リポジトリのルートにshell.nixを作成します:
{ pkgs ? import <nixpkgs> { } }:
pkgs.mkShell {
packages = with pkgs; [ nodejs_22 clang llvm pkg-config elfutils zlib bpftools gnumake ];
hardeningDisable = [ "all" ];
}
Nixシェル内でWebアセットとバイナリをビルドします:
nix-shell --run 'npm --prefix web ci --no-audit --no-fund && npm --prefix web run build && cargo build --release --locked'
バイナリは/nix/storeなどのライブラリにリンクします。これらの依存関係がnix-collect-garbageによって削除されないように、GCルートを作成します:
nix-build shell.nix -A inputDerivation -o .nix-gcroot
バイナリを使用中は.nix-gcrootを保持してください。その後、実行します:
sudo ./target/release/procinsh --listen 127.0.0.1:9090
WSL2(Ubuntu)でのビルド
Ubuntuのbpftoolラッパーは、WSL2カーネルのバージョンがUbuntuツールパッケージのバージョンと異なるため、bpftool not found for kernel ...というエラーが発生する場合があります。ラッパーをバイパスして、パッケージ化された実行可能ファイルにBPFTOOLを設定してください:
sudo apt-get update
sudo apt-get install --yes --no-install-recommends \
build-essential clang llvm pkg-config libelf-dev zlib1g-dev python3 \
linux-tools-common linux-tools-generic
for tool in /usr/lib/linux-tools/*/bpftool; do
if [ -x "$tool" ]; then
export BPFTOOL="$tool"
break
fi
done
"${BPFTOOL:?No packaged bpftool found; install linux-tools-generic}" version
"$BPFTOOL" btf dump file /sys/kernel/btf/vmlinux format c >/tmp/procinsh-vmlinux.h
npm --prefix web ci
npm --prefix web run build
cargo build --release --locked
その後、実行します:
sudo ./target/release/procinsh --listen 127.0.0.1:9090
さて、どこへ行こうか?プロセス空間は広大だ。