Logging and Warnings#

Vega and Vega-Lite report warnings while compiling or evaluating a chart. A conversion can succeed even though Vega dropped an invalid property or recovered from a data problem, so check these messages when a chart does not look as expected.

This examples use a logarithmic scale whose inferred domain includes zero. Save this Vega-Lite specification:

chart.vl.json
{
  "$schema": "https://vega.github.io/schema/vega-lite/v6.json",
  "data": {
    "values": [
      {"category": "A", "value": 100},
      {"category": "B", "value": 200}
    ]
  },
  "mark": "bar",
  "encoding": {
    "x": {"field": "category", "type": "nominal"},
    "y": {
      "field": "value",
      "type": "quantitative",
      "scale": {"type": "log"}
    }
  }
}

Every output struct carries the messages Vega produced in logs:

use vl_convert_rs::{VlConverter, VlOpts};

let spec = std::fs::read_to_string("chart.vl.json")?;
let converter = VlConverter::new();
let output = converter
    .vegalite_to_svg(spec, VlOpts::default(), Default::default())
    .await?;

for entry in output.logs {
    eprintln!("{}: {}", entry.level, entry.message);
}

This prints:

WARN: Log scale domain includes zero: [0,200]

The crate also emits these messages, plus its own operational messages, through the log crate under the vl_convert target. If no logger is installed when the first converter is created, the crate installs env_logger, so setting RUST_LOG=vl_convert=info works without any additional configuration. To use a different logger, initialize it before creating a converter.