minidump-processor

一个用于从minidump文件生成堆栈跟踪和其他有用信息的库。这个crate提供API来生成minidump中线程的符号化堆栈跟踪，以及一个类似于Google Breakpad项目中的工具的minidump_stackwalk。

JSON模式是稳定的，并在此处进行了文档记录。

如果你想要更底层的minidump内容访问，请使用minidump crate。

对于使用此库的命令行应用程序，请参阅minidump-stackwalk。 这是minidump-processor的主要和稳定接口，我们推荐大多数生产用户使用。

对于使用此库的GUI应用程序，请参阅minidump-debugger。 这是一个实验性外部项目。

如果你确实需要将minidump-processor作为库使用，我们仍然推荐使用稳定的JSON输出。原生API工作良好，包含所有相同的信息，我们只是还没有稳定它们，所以更新更有可能导致破坏。以下是一个获取JSON输出的最小示例（使用serde_json解析）

use minidump::Minidump;
use minidump_processor::ProcessorOptions;
use minidump_unwind::{http_symbol_supplier, Symbolizer};
use serde_json::Value;

#[tokio::main]
async fn main() -> Result<(), ()> {
    // Read the minidump
    let dump = Minidump::read_path("../testdata/test.dmp").map_err(|_| ())?;
 
    // Configure the symbolizer and processor
    let symbols_urls = vec![String::from("https://symbols.totallyrealwebsite.org")];
    let symbols_paths = vec![];
    let mut symbols_cache = std::env::temp_dir();
    symbols_cache.push("minidump-cache");
    let symbols_tmp = std::env::temp_dir();
    let timeout = std::time::Duration::from_secs(1000);
 
    // Use ProcessorOptions for detailed configuration
    let options = ProcessorOptions::default();

    // Specify a symbol supplier (here we're using the most powerful one, the http supplier)
    let provider = Symbolizer::new(http_symbol_supplier(
        symbols_paths,
        symbols_urls,
        symbols_cache,
        symbols_tmp,
        timeout,
    ));
 
    let state = minidump_processor::process_minidump_with_options(&dump, &provider, options)
        .await
        .map_err(|_| ())?;

    // Write the JSON output to an arbitrary writer (here, a Vec).
    let mut json_output = Vec::new();
    state.print_json(&mut json_output, false).map_err(|_| ())?;

    // Now parse it (here parsed into an arbitrary JSON Object for max flexibility).
    let json: Value = serde_json::from_slice(&json_output).map_err(|_| ())?;

    // Now read whatever values you want out of it
    if let Some(Value::Number(pid)) = json.get("pid") {
        println!("pid: {}", pid);
    }

    Ok(())
}