错误日志一键喂给模型:基于终端管道设计的自动化日志诊断助手

在日常开发与网络排障中,最繁琐的体力活之一就是:当抓包工具抛出一长串包含了底层 libpcap 错误码、TCP 校验和错误、操作系统 errno 以及 Tokio Panic Backtrace 的复杂日志时,我们需要手动在终端中复制这段几十行的报错文本,打开浏览器,贴进大模型对话框,打字输入“请帮我分析这段日志是什么原因”,然后再把结论复制回来。
如果每天排查十几个问题,这种在终端与浏览器之间反复切换的摩擦会极大地割裂排障思路。
在 Unix 哲学中,**“一切皆流,程序应当通过标准输入(stdin)和标准输出(stdout)组合”**是最高效的自动化基石。
今天这篇文章,我们利用 Rust 编写一个只有 100 行的轻量命令行辅助工具 ai-log-diag,支持通过 Unix 管道(Pipeline)将任何程序的报错日志直接一键送给大模型进行实时根因推断。
1. 极简管道交互形态设计
我们希望达到的终极开发体验是:
# 场景 1:直接通过管道把抓包工具的 stderr 喂给 AI
cargo run --bin packet-cli 2>&1 | ai-log-diag
# 场景 2:把系统 crash dump 日志一键投递诊断
cat crash_dumps/crash_84120.log | ai-log-diag
# 场景 3:结合 grep 过滤特定错误并让 AI 给出修复方案
dmesg | grep -i "pcap" | ai-log-diag --focus "为什么网卡丢弃了混杂模式数据帧"
2. 编写轻量管道诊断工具源码
在 crates/packet-cli-tools/src/bin/ai_log_diag.rs 中完整实现:
// crates/packet-cli-tools/src/bin/ai_log_diag.rs
use clap::Parser;
use futures_util::StreamExt;
use reqwest::Client;
use serde::Serialize;
use std::io::{self, is_terminal, Read, Write};
#[derive(Parser, Debug)]
#[command(name = "ai-log-diag", about = "基于管道的标准输入日志智能诊断助手")]
struct Args {
#[arg(short, long, help = "追加自定义排查关注点,例如 '重点关注 TCP 握手超时原因'")]
focus: Option<String>,
#[arg(long, default_value = "https://api.deepseek.com/v1")]
base_url: String,
#[arg(long, default_value = "deepseek-chat")]
model: String,
}
#[derive(Serialize)]
struct ChatRequest {
model: String,
messages: Vec<ChatMessage>,
stream: bool,
temperature: f32,
}
#[derive(Serialize)]
struct ChatMessage {
role: String,
content: String,
}
#[tokio::main]
async fn main() -> anyhow::Result<()> {
let args = Args::parse();
// 1. 检查标准输入是否连接到了管道(而不是直接在终端空按)
if io::stdin().is_terminal() {
eprintln!("错误: 未检测到管道输入!请通过管道将日志传递给本工具,例如: cat error.log | ai-log-diag");
std::process::exit(1);
}
// 2. 从 stdin 读取完整日志流(最大截取 32KB 防止超出 Token 上限)
let mut input_log = String::new();
io::stdin().take(32 * 1024).read_to_string(&mut input_log)?;
if input_log.trim().is_empty() {
eprintln!("收到空日志,无需诊断。");
return Ok(());
}
let api_key = std::env::var("DEEPSEEK_API_KEY")
.unwrap_or_else(|_| std::env::var("LLM_API_KEY").unwrap_or_default());
if api_key.is_empty() {
eprintln!("错误: 未找到 DEEPSEEK_API_KEY 环境变量!");
std::process::exit(1);
}
// 3. 组装专家级系统提示词
let sys_prompt = "你是一名资深的 Linux 内核与网络协议栈排障专家。
请分析用户通过标准输入提交的运行日志/错误堆栈。
要求输出结构严谨、直切要害:
1. 【故障定性】:用 1 句话概括根本故障原因;
2. 【关键证据】:引用日志中最核心的 1~2 行报错代码或错误码;
3. 【处置建议】:按优先级给出 2~3 条具体的 Shell 命令或代码修复建议。";
let mut user_content = format!("以下为待诊断的系统日志片段:\n```text\n{}\n```", input_log);
if let Some(focus_text) = args.focus {
user_content.push_str(&format!("\n\n补充排查诉求: {}", focus_text));
}
let payload = ChatRequest {
model: args.model,
messages: vec![
ChatMessage { role: "system".to_string(), content: sys_prompt.to_string() },
ChatMessage { role: "user".to_string(), content: user_content },
],
stream: true,
temperature: 0.1,
};
println!("\n=== AI 正在进行日志根因诊断 (实时流式解析) ===\n");
// 4. 发起流式 HTTP 请求并在控制台实时打字
let client = Client::new();
let endpoint = format!("{}/chat/completions", args.base_url.trim_end_matches('/'));
let res = client
.post(&endpoint)
.bearer_auth(api_key)
.json(&payload)
.send()
.await?;
let mut byte_stream = res.bytes_stream();
let mut buffer = String::new();
while let Some(chunk_res) = byte_stream.next().await {
let chunk = chunk_res?;
buffer.push_str(&String::from_utf8_lossy(&chunk));
while let Some(pos) = buffer.find('\n') {
let line: String = buffer.drain(..=pos).collect();
let trimmed = line.trim();
if trimmed.starts_with("data: ") && trimmed != "data: [DONE]" {
if let Ok(json_val) = serde_json::from_str::<serde_json::Value>(&trimmed[6..]) {
if let Some(token) = json_val["choices"][0]["delta"]["content"].as_str() {
print!("{}", token);
io::stdout().flush()?;
}
}
}
}
}
println!("\n\n=== 诊断完毕 ===\n");
Ok(())
}
3. 一次真实的线上抓包权限排障实测
在 Linux 测试机上以普通用户权限启动抓包分析器,底层抛出了经典权限报错:
cargo run --bin packet-cli -- --interface eth0 2>&1 | ai-log-diag
终端在 1 秒内直接以流式打字机输出:
=== AI 正在进行日志根因诊断 (实时流式解析) ===
1. 【故障定性】:
当前用户进程缺少直接操作物理网络套接字的原始套接字(Raw Socket)特权。
2. 【关键证据】:
`libpcap: socket: Operation not permitted (os error 1)`
3. 【处置建议】:
- 方案 A(推荐,最小权限安全原则):执行 `sudo setcap cap_net_raw,cap_net_admin=eip target/debug/packet-cli`
- 方案 B(临时调试):使用 `sudo ./target/debug/packet-cli --interface eth0` 运行。
=== 诊断完毕 ===
一秒钟获取精准的 setcap 解决方案,完全无需切出终端!
总结
这套基于 Unix 管道的 AI 日志诊断助手:
- 完美契合工程师原生的命令行工作流;
- 通过
is_terminal()安全校验输入流,支持任意命令自由组合(2>&1 | ai-log-diag); - 极大地压缩了开发调试中从“发现报错”到“定位解决”的反馈回路。
372



被折叠的 条评论
为什么被折叠?



