diagnostics_log/
lib.rs

1// Copyright 2021 The Fuchsia Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
3
4#![deny(missing_docs)]
5
6//! Provides the `log::Log` implementation that allows to publish `log` events to
7//! Fuchsia Logging System.
8//!
9//! This library isn't Fuchsia-specific and provides a general `log::Log` that allows
10//! the library to also be used in the host.
11
12#[cfg(target_os = "fuchsia")]
13mod fuchsia;
14#[cfg(target_os = "fuchsia")]
15use self::fuchsia as implementation;
16
17#[cfg(not(target_os = "fuchsia"))]
18mod portable;
19#[cfg(not(target_os = "fuchsia"))]
20use self::portable as implementation;
21
22pub use diagnostics_log_types::Severity;
23pub use implementation::*;
24
25/// Adds a panic hook which will log an `ERROR` log with the panic information.
26pub(crate) fn install_panic_hook(prefix: Option<&'static str>) {
27    let previous_hook = std::panic::take_hook();
28    std::panic::set_hook(Box::new(move |info| {
29        let message = format!("{}", info);
30        let prefix = prefix.unwrap_or("PANIC");
31        log::logger().log(
32            &log::RecordBuilder::new()
33                .level(log::Level::Error)
34                .line(Some(info.location().unwrap().line()))
35                .file(Some(info.location().unwrap().file()))
36                .key_values(&[("info", message.as_str())])
37                .args(format_args!("{prefix}"))
38                .build(),
39        );
40        previous_hook(info);
41    }));
42}
43
44/// A type which has a `Severity`.
45pub trait SeverityExt {
46    /// Return the severity of this value.
47    fn severity(&self) -> Severity;
48
49    /// Return the raw severity of this value.
50    fn raw_severity(&self) -> u8 {
51        self.severity() as u8
52    }
53}
54
55impl SeverityExt for log::Metadata<'_> {
56    fn severity(&self) -> Severity {
57        match self.level() {
58            log::Level::Error => Severity::Error,
59            log::Level::Warn => Severity::Warn,
60            log::Level::Info => Severity::Info,
61            log::Level::Debug => Severity::Debug,
62            log::Level::Trace => Severity::Trace,
63        }
64    }
65}
66
67/// Options to configure publishing. This is for initialization of logs, it's a superset of
68/// `PublisherOptions`.
69pub struct PublishOptions<'t> {
70    pub(crate) publisher: PublisherOptions<'t>,
71    pub(crate) install_panic_hook: bool,
72    pub(crate) panic_prefix: Option<&'static str>,
73}
74
75impl Default for PublishOptions<'_> {
76    fn default() -> Self {
77        Self {
78            publisher: PublisherOptions::default(),
79            install_panic_hook: true,
80            panic_prefix: None,
81        }
82    }
83}
84
85impl PublishOptions<'_> {
86    /// Whether or not to install a panic hook which will log an ERROR whenever a panic happens.
87    ///
88    /// Default: true.
89    pub fn install_panic_hook(mut self, enable: bool) -> Self {
90        self.install_panic_hook = enable;
91        self
92    }
93
94    /// Enable to always log file/line information, otherwise only log
95    /// when severity is ERROR or above.
96    #[cfg(target_os = "fuchsia")]
97    pub fn always_log_file_line(mut self) -> Self {
98        self.publisher.always_log_file_line = true;
99        self
100    }
101
102    /// Override the default string prefix for a logged panic message.
103    pub fn panic_prefix(mut self, prefix: &'static str) -> Self {
104        self.panic_prefix = Some(prefix);
105        self
106    }
107}
108
109macro_rules! publisher_options {
110    ($(($name:ident, $self:ident, $($self_arg:ident),*)),*) => {
111        $(
112            impl<'t> $name<'t> {
113                /// Sets the tags applied to all published events.
114                ///
115                /// When set to an empty slice (the default), events are tagged with the moniker of
116                /// the component in which they are recorded.
117                ///
118                /// Default: empty.
119                pub fn tags(mut $self, tags: &'t [&'t str]) -> Self {
120                    let this = &mut $self$(.$self_arg)*;
121                    this.tags = tags;
122                    $self
123                }
124
125                /// Enable a metatag. It'll be applied to all published events.
126                ///
127                /// Default: no metatags are enabled.
128                pub fn enable_metatag(mut $self, metatag: Metatag) -> Self {
129                    let this = &mut $self$(.$self_arg)*;
130                    this.metatags.insert(metatag);
131                    $self
132                }
133
134                /// An interest filter to apply to messages published.
135                ///
136                /// Default: EMPTY, which implies INFO.
137                pub fn minimum_severity(mut $self, severity: impl Into<Severity>) -> Self {
138                    let this = &mut $self$(.$self_arg)*;
139                    this.interest.min_severity = Some(severity.into().into());
140                    $self
141                }
142            }
143        )*
144    };
145}
146
147publisher_options!((PublisherOptions, self,), (PublishOptions, self, publisher));
diagnostics_log/lib.rs

diagnostics_log/
lib.rs
