Skip to main content

Debugging provides support for debugging applications and layers, which includes:

  • logging
  • debugging support logging (and are based on the debugging library, providing user configurable console logging with advanced functions like the ability to log images and tables etc to the console.

In your browser console, select the log level you would like:

deck.log.level = 2
Log levelDescription
0Critical logs only
1Logs the reason for redraws and picking operations
2Logs layer updates
3+Additional logging around layer lifecycle, prop diffing etc

Starting v8.0, no longer bundles the debugging module in production mode. This includes the pre-bundled dist.min.js, and any bundle built with the environment variable NODE_ENV=production. To enable debugging in a production build, you may include the pre-bundled debug module AFTER the bundle:

<!-- the bundle that contains -->
<script src="app.js"></script>
<!-- the debug module -->
<script src="^9.0.0/debug.min.js"></script>

WebGL2/WebGPU debugging using

For lower level debugging, including debugging of layer rendering and picking, is built on which has extensive debugging and instrumentation support for WebGL2/WebGPU level code and GPU input values (shader uniforms and attributes). To enable debug logging simply issue the following commands in your browser console:

luma.log.level = 2

The following features are available:

  • Automatic sanity checks are performed on uniforms and attributes. Passing an undefined value to a uniform is a common JavaScript mistake that will immediately generate a descriptive exception in This can be tracked from the console output.

  • The Deck class and DeckGL react component have a debug flag which instructs to instruments the WebGL2/WebGPU context (with a performance cost) which allows tracing all GPU call errors, see below on luma debug log levels. It also generates exceptions immediately when a GPU operation fails, allowing you to pinpoint exactly where in the code the issue happened. Due to the asynchronous nature of the GPU, some GPU execution errors are surfaced and caught later than the calls that generate them.

In the browser console, setting luma.log.level to various values will enable increasing levels of debugging.

Log levelDescription
0Critical logs only
1Minimal logging
2 and 3Will display all uniforms and attributes before each draw call, allowing you to be confident in what values your shaders are actually working on.
4Will trace every single gl call.