Struct bevy::log::LogPlugin

pub struct LogPlugin;

Adds logging to Apps. This plugin is part of the DefaultPlugins. Adding this plugin will setup a collector appropriate to your target platform:

• Using tracing-subscriber by default, logging to stdout.
• Using android_log-sys on Android, logging to Android logs.
• Using tracing-wasm in WASM, logging to the browser console.

You can configure this plugin using the resource LogSettings.

fn main() {
    App::new()
        .insert_resource(LogSettings {
            level: Level::DEBUG,
            filter: "wgpu=error,bevy_render=info,bevy_ecs=trace".to_string(),
        })
        .add_plugins(DefaultPlugins)
        .run();
}

Log level can also be changed using the RUST_LOG environment variable. For example, using RUST_LOG=wgpu=error,bevy_render=info,bevy_ecs=trace cargo run ..

It has the same syntax as the field LogSettings::filter, see EnvFilter. If you define the RUST_LOG environment variable, the LogSettings resource will be ignored.

If you want to setup your own tracing collector, you should disable this plugin from DefaultPlugins with App::add_plugins_with:

fn main() {
    App::new()
        .add_plugins_with(DefaultPlugins, |group| group.disable::<LogPlugin>())
        .run();
}

Panics

This plugin should not be added multiple times in the same process. This plugin sets up global logging configuration for all Apps in a given process, and rerunning the same initialization multiple times will lead to a panic.

Trait Implementations

impl Default for LogPlugin

fn default() -> LogPlugin

Returns the “default value” for a type.

impl Plugin for LogPlugin

fn build(&self, app: &mut App)

Configures the App to which this plugin is added.

fn name(&self) -> &str

Configures a name for the Plugin which is primarily used for debugging.