log_layers/
log_layers.rs

1//! This example illustrates how to add custom log layers in bevy.
2
3use bevy::{
4    log::{
5        tracing::{self, Subscriber},
6        tracing_subscriber::Layer,
7        BoxedLayer,
8    },
9    prelude::*,
10};
11
12struct CustomLayer;
13
14impl<S: Subscriber> Layer<S> for CustomLayer {
15    fn on_event(
16        &self,
17        event: &tracing::Event<'_>,
18        _ctx: bevy::log::tracing_subscriber::layer::Context<'_, S>,
19    ) {
20        println!("Got event!");
21        println!("  level={}", event.metadata().level());
22        println!("  target={}", event.metadata().target());
23        println!("  name={}", event.metadata().name());
24    }
25}
26
27// We don't need App for this example, as we are just printing log information.
28// For an example that uses App, see log_layers_ecs.
29fn custom_layer(_app: &mut App) -> Option<BoxedLayer> {
30    // You can provide multiple layers like this, since Vec<Layer> is also a layer:
31    Some(Box::new(vec![
32        bevy::log::tracing_subscriber::fmt::layer()
33            .with_file(true)
34            .boxed(),
35        CustomLayer.boxed(),
36    ]))
37}
38
39fn main() {
40    App::new()
41        .add_plugins(DefaultPlugins.set(bevy::log::LogPlugin {
42            custom_layer,
43
44            ..default()
45        }))
46        .add_systems(Update, log_system)
47        .run();
48}
49
50fn log_system() {
51    // here is how you write new logs at each "log level" (in "most important" to
52    // "least important" order)
53    error!("something failed");
54    warn!("something bad happened that isn't a failure, but thats worth calling out");
55    info!("helpful information that is worth printing by default");
56    debug!("helpful for debugging");
57    trace!("very noisy");
58}
log_layers/log_layers.rs

log_layers/
log_layers.rs
