S
snmp161/melisa
Single-binary Linux performance diagnostics via eBPF/BCC, built for humans and AI agents (MCP)
更新 2026-11-19
在 GitHub 查看 ↗直链 · 无中转页
- ★ 数取值
- 0 ★ · snmp161/melisa · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 从该仓库的 GitHub 页面直接读取 · 条目类型:开源项目
- 收录与活跃
- 收录于 2026-11-20 · 最近见到 2026-11-20 · 共见到 1 次 · 被 1 个来源列出
- 评分构成
- 综合分 103 · 1 个来源 · repo
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: 开源项目。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
snmp161/melisa;我们收录于 2026-11-20;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# melisa
以下摘录自该仓库的 README(片段)
melisa is a point-in-time Linux performance diagnostic tool. It collects data through 8 procfs/sysfs collectors, a registry of 67 BCC tools, and one native eBPF collector, then produces a JSON report with raw measurements, threshold-based anomalies, a heuristic health score, and suggested tuning actions. It works as a standalone CLI or as an MCP server for interactive analysis.
bash
sudo melisa collect --profile quick -o report.json
The command writes a JSON report to report.json (-o - selects stdout). Total runtime depends on the selected profile, host, and available collection tools.
## Key Features
| Feature | What it does |
| Health Score | Heuristic 0–100 summary derived from USE metrics and detected anomalies |
| 37 Anomaly Rules | Static thresholds over current values and, where applicable, two-point rate measurements |
| Recommendations | Suggested tuning commands with evidence, tagged as "fix" or "optimization"; review before applying |
| 67 BCC Tool Specifications | Histogram, event, and stack-trace parsers; actual availability depends on the host |
| GPU/PCIe Topology | NVIDIA GPU metrics, PCI→NUMA mapping, and cross-NUMA GPU-NIC pair detection |
| Page Reclaim Tracking | Direct reclaim rates, compaction stalls, and THP split counters |
| NUMA Analysis | Per-node miss ratio, distance matrix, and CPU mapping |
| Network Data | Conntrack, softnet, IRQ distribution, accept queues, and TCP/UDP sysctls |
| MCP Server | MCP access over stdio for interactive diagnostics |
| Before/After Diff | Comparison of health scores, USE metrics, anomalies, and histograms |
| Observer Effect Mitigation | Tier 1 baselines run before BCC/eBPF tools; PID exclusion and overhead measurement |
| Documentation | 22 chapters in English and Russian covering Linux performance and melisa internals |
## Quick Start
GitHub Releases provides Linux tar.gz archives and DEB/RPM packages for amd64 and arm64. DEB packages target Debian and Ubuntu; RPM packages target AlmaLinux, Rocky Linux, and RHEL. Packages install the binary as /usr/bin/melisa.
bash
# Build (requires Go 1.27+, cross-compile from macOS/Linux)
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o melisa ./cmd/melisa/
# Deploy and run
scp melisa root@server:/usr/local/bin/
ssh root@server "melisa collect --profile quick -o /tmp/report.json"
# Install BCC tools (first time only)
ssh root@server "melisa install"
The CLI does not require a configuration file. Tier 2 tools are optional and can be installed with melisa install.
## MCP Server
melisa includes a built-in Model Context Protocol server. AI agents connect over stdio and interactively diagnose system performance.
Claude Desktop / Cursor config (claude_desktop_config.json):
json
"mcpServers": {
"melisa": {
"command": "ssh",
"args": ["root@your-server", "/usr/local/bin/melisa", "mcp"]
### MCP Tools
| Tool | What it does |
| get_health | Tier 1 collection with health score and anomalies |
| collect_metrics | Collection using a selected profile, with optional focus and pid filters |
| explain_anomaly | Possible causes and suggested actions for an anomaly ID |
| list_anomalies | All 37 anomaly metric IDs with descriptions |
bash
sudo melisa collect --profile quick -o report.json
The command writes a JSON report to report.json (-o - selects stdout). Total runtime depends on the selected profile, host, and available collection tools.
## Key Features
| Feature | What it does |
| Health Score | Heuristic 0–100 summary derived from USE metrics and detected anomalies |
| 37 Anomaly Rules | Static thresholds over current values and, where applicable, two-point rate measurements |
| Recommendations | Suggested tuning commands with evidence, tagged as "fix" or "optimization"; review before applying |
| 67 BCC Tool Specifications | Histogram, event, and stack-trace parsers; actual availability depends on the host |
| GPU/PCIe Topology | NVIDIA GPU metrics, PCI→NUMA mapping, and cross-NUMA GPU-NIC pair detection |
| Page Reclaim Tracking | Direct reclaim rates, compaction stalls, and THP split counters |
| NUMA Analysis | Per-node miss ratio, distance matrix, and CPU mapping |
| Network Data | Conntrack, softnet, IRQ distribution, accept queues, and TCP/UDP sysctls |
| MCP Server | MCP access over stdio for interactive diagnostics |
| Before/After Diff | Comparison of health scores, USE metrics, anomalies, and histograms |
| Observer Effect Mitigation | Tier 1 baselines run before BCC/eBPF tools; PID exclusion and overhead measurement |
| Documentation | 22 chapters in English and Russian covering Linux performance and melisa internals |
## Quick Start
GitHub Releases provides Linux tar.gz archives and DEB/RPM packages for amd64 and arm64. DEB packages target Debian and Ubuntu; RPM packages target AlmaLinux, Rocky Linux, and RHEL. Packages install the binary as /usr/bin/melisa.
bash
# Build (requires Go 1.27+, cross-compile from macOS/Linux)
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o melisa ./cmd/melisa/
# Deploy and run
scp melisa root@server:/usr/local/bin/
ssh root@server "melisa collect --profile quick -o /tmp/report.json"
# Install BCC tools (first time only)
ssh root@server "melisa install"
The CLI does not require a configuration file. Tier 2 tools are optional and can be installed with melisa install.
## MCP Server
melisa includes a built-in Model Context Protocol server. AI agents connect over stdio and interactively diagnose system performance.
Claude Desktop / Cursor config (claude_desktop_config.json):
json
"mcpServers": {
"melisa": {
"command": "ssh",
"args": ["root@your-server", "/usr/local/bin/melisa", "mcp"]
### MCP Tools
| Tool | What it does |
| get_health | Tier 1 collection with health score and anomalies |
| collect_metrics | Collection using a selected profile, with optional focus and pid filters |
| explain_anomaly | Possible causes and suggested actions for an anomaly ID |
| list_anomalies | All 37 anomaly metric IDs with descriptions |
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/snmp161-melisa/)
- 来源
- github · https://github.com/snmp161/melisa
- 按领域浏览
- 开源项目
- 收录于
- 今天
更多条目
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。