Go Process Inspector

Name: Go Process Inspector
Rating: 4.9 (97 reviews)
Author: monsterxx03

DevOps

by monsterxx03

检查运行中的 Go 进程，查看 goroutine 状态、内存统计与二进制信息，并通过终端 UI、HTTP API 或 SSE 端点访问数据。

排查 Go 服务运行态问题很顺手，能直接查看 goroutine、内存和二进制信息，还同时提供终端 UI、HTTP API 与 SSE，临时诊断和接入监控都方便。

97GitHub

什么是 Go Process Inspector？

检查运行中的 Go 进程，查看 goroutine 状态、内存统计与二进制信息，并通过终端 UI、HTTP API 或 SSE 端点访问数据。

核心功能 (4 个工具)

gomemstats

dump golang process's memory statistics

goroutines

dump golang process's goroutines

goruntime

get golang process's runtime info

pgrep

find process IDs by process name

README

Go Process Inspector

A tool for inspecting and analyzing running Go processes, including goroutine states, memory statistics, and binary information.

Features

View detailed goroutine information (status, scheduling info)
Analyze process memory statistics
Cross-platform support (Linux and macOS)
Terminal UI for interactive inspection
HTTP API for programmatic access
mcp server

Installation

bash

go install github.com/monsterxx03/gospy@latest

Usage

CLI Interface

bash

# Interactive terminal UI
sudo gospy top --pid <pid>

# HTTP API server
sudo gospy serve --port 8974

# Get process summary
sudo gospy summary --pid <pid>

# Get process summary in JSON format
sudo gospy summary --pid <pid> --json

Summary Command Options

--pid/-p - Target process ID (required)
--bin/-b - Path to binary file (optional)
--json/-j - Output results in JSON format

API Endpoints

GET /goroutines?pid=<pid> - List all goroutines
GET /memstats?pid=<pid> - Get memory statistics
GET /runtime?pid=<pid> - Get runtime version info

MCP Server

The MCP server provides an http (streamableHTTP) endpoint. To enable:

bash

>>> sudo gospy serve --enable-mcp --port 8974

Starting API server on port 8974
Endpoints:
  GET /runtime?pid=<PID>     - Get runtime info
  GET /goroutines?pid=<PID> - Get goroutines list
  GET /memstats?pid=<PID>   - Get memory stats
  GET /mcp   - MCP http endpoint

Available MCP tools:

goroutines - Dump goroutines for a go process
gomemstats - Dump memory stats for a go process
goruntime - Dump runtime info for a go process
pgrep - Find pid from process name

Config in cursor

Terminal UI Controls

q - Quit
r - Refresh data
s - Suspend/Resume top view
/ - Search/filter goroutines

Terminal UI Screenshot

Building from Source

bash

git clone https://github.com/monsterxx03/gospy.git
cd gospy
make

Requirements

Go 1.20+
Linux or macOS (Apple Silicon only)
Root privileges (required for memory access)

Root Privileges

gospy requires root privileges to:

Read process memory (/proc/<pid>/mem on Linux)
Access Mach APIs on macOS

Run with sudo:

bash

sudo gospy top --pid <pid>

For development/debugging, you may want to:

Build the binary first: make
Run with sudo: sudo ./gospy [command]

Credits

Version 0.7.0 was completely rewritten from scratch with aider, which wrote >90% of the code. Additional assistance from:

DeepSeek (R1 + V3 models) - AI coding assistant

Total AI compute cost: ~$2 USD

License

MIT - See LICENSE file for details.

常见问题