Documentation

Ataytis Vega Studio documentation.

Build, inspect, refine, and share Vega-powered Power BI visuals.

Refine and validate

Inspector and diagnostics

Use Data table, Live signals, and Diagnostics to understand the running Vega view and resolve problems methodically.

Open the inspector

Choose Inspect visual from the command bar or press Ctrl + backquote to open and close the inspector. The inspector remains connected to the current applied Vega view and updates as the visual renders.

The Ataytis Vega Studio inspector open beneath the preview, showing the Data table tab with Power BI rows and Studio helper fields.
The inspector docks below the preview. Data table, Live signals, and Diagnostics sit on the left of its toolbar; the preview zoom controls sit on the right.

Data table

Data table shows any one dataset from the Vega view — the Power BI-backed dataset or anything your transforms derive from it. It is where you confirm that a field is named what you think it is named, and that a transform produced the records you expected. Rows can be sorted and paged at 10, 25, 50, 100, 150, or 200 per page, with the header fixed while you scroll.

  • Start with dataset to validate the Power BI input.
  • Use the Vega dataset selector at the foot of the table to switch to a derived dataset and inspect your transforms step by step.
  • Look for NaN, circular, infinite, object, or truncated-value placeholders that point to unexpected data shapes.
  • Compare field names here with every field and datum[...] reference in the specification.

Live signals

Live signals lists every signal in the running Vega view alongside its current value. Because the values update as you interact with the preview, it is the fastest way to find out why an event handler, brush, or responsive calculation is not behaving as you expect.

Diagnostics

Diagnostics presents specification and configuration parsing errors plus Vega warnings at the selected log level. If no warnings or errors are present, the inspector reports that no log messages require attention.

Log levelUse
NoneSuppress diagnostic messages.
ErrorShow failures that prevent correct parsing or rendering.
WarnInclude Vega warnings that may indicate invalid assumptions or deprecated behavior.
InfoInclude normal informational status; this is the default project level.
DebugExpose the most detailed available diagnostic output when deeper investigation is required.

Debugging sequence

  1. 1

    Open Diagnostics

    Resolve JSON parsing errors before investigating data or styling.

  2. 2

    Inspect dataset

    Confirm the expected rows and fields reach the Vega view.

  3. 3

    Inspect derived datasets

    Find the first transform whose output differs from your expectation.

  4. 4

    Inspect signals

    Confirm parameters and event-driven state have the expected live values.

  5. 5

    Reduce the specification

    Temporarily remove later marks or transforms until the smallest failing section remains.

  6. 6

    Reapply and retest

    Apply one correction at a time, then validate both the Studio preview and Power BI report canvas.

Inspector and diagnostics — Ataytis Vega Studio | AtaytisTech