witchcraft-server 6.4.0

A highly opinionated embedded application server for RESTy APIs, compatible with the Witchcraft ecosystem
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

// Copyright 2022 Palantir Technologies, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
use crate::debug::Diagnostic;
use crate::minidump;
use crate::minidump::log;
use bytes::Bytes;
use conjure_error::Error;
use http::HeaderValue;
use minidump_writer::minidump_writer::MinidumpWriterConfig;
use std::ffi::OsString;
use std::fs;
use std::io::Cursor;
use std::os::unix::prelude::{OsStrExt, OsStringExt};
use std::os::unix::process;
use std::path::{Path, PathBuf};
use tempfile::NamedTempFile;
use tokio::runtime::Handle;
use witchcraft_log::error;

/// A diagnostic which returns a stack trace of every thread in the server.
///
/// It is only supported on Linux.
pub struct ThreadDumpDiagnostic {
    socket_dir: PathBuf,
}

impl ThreadDumpDiagnostic {
    pub fn new(socket_dir: &Path) -> Self {
        ThreadDumpDiagnostic {
            socket_dir: socket_dir.to_owned(),
        }
    }
}

impl Diagnostic for ThreadDumpDiagnostic {
    fn type_(&self) -> &str {
        "rust.thread.dump.v1"
    }

    fn content_type(&self) -> HeaderValue {
        HeaderValue::from_static("text/plain")
    }

    fn safe_loggable(&self) -> bool {
        true
    }

    fn result(&self) -> Result<Bytes, Error> {
        let target_file = NamedTempFile::new_in("var/data/tmp").map_err(Error::internal_safe)?;
        let handle = Handle::current();

        let client = handle.block_on(minidump::connect(&self.socket_dir))?;
        client
            .send_message(0, target_file.path().as_os_str().as_bytes())
            .map_err(Error::internal_safe)?;
        // send_message doesn't wait for a response, so send a ping after to synchronize
        client.ping().map_err(Error::internal_safe)?;

        let info = handle.block_on(log::process_minidump(target_file.path()))?;

        Ok(Bytes::from(info))
    }
}

pub fn handle_request(buf: Vec<u8>) {
    let target_file = PathBuf::from(OsString::from_vec(buf));
    let ppid = process::parent_id();
    let minidump =
        match MinidumpWriterConfig::new(ppid as _, ppid as _).write(&mut Cursor::new(vec![])) {
            Ok(minidump) => minidump,
            Err(e) => {
                error!("error creating minidump", error: Error::internal_safe(e));
                return;
            }
        };
    let _ = fs::write(target_file, minidump);
}