Struct bevy_log::LogPlugin

pub struct LogPlugin {
    pub filter: String,
    pub level: Level,
}

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.

fn main() {
    App::new()
        .add_plugins(DefaultPlugins.set(LogPlugin {
            level: Level::DEBUG,
            filter: "wgpu=error,bevy_render=info,bevy_ecs=trace".to_string(),
        }))
        .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 LogPlugin::filter, see EnvFilter. If you define the RUST_LOG environment variable, the LogPlugin settings will be ignored.

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

fn main() {
    App::new()
        .add_plugins(DefaultPlugins.build().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.

Fields

filter: String

Filters logs using the EnvFilter format

level: Level

Filters out logs that are “less than” the given level. This can be further filtered using the filter setting.

Trait Implementations

impl Default for LogPlugin

fn default() -> Self

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 setup(&self, _app: &mut App)

Runs after all plugins are built, but before the app runner is called. This can be useful if you have some resource that other plugins need during their build step, but after build you want to remove it and send it to another thread.

fn name(&self) -> &str

Configures a name for the Plugin which is primarily used for checking plugin uniqueness and debugging.

fn is_unique(&self) -> bool

If the plugin can be meaningfully instantiated several times in an App, override this method to return false.