Debug Print¶
A pass-through debug utility that logs a readable representation of any input value along with a label. It prints container structures and tensor shapes to help inspect workflow data without altering it.
Usage¶
Insert this node at points in your workflow where you want to inspect intermediate values. Provide the value to inspect and a short label; the node logs a concise representation to the application logs while passing the value forward unchanged, allowing inline debugging.
Inputs¶
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| value | True | WILDCARD | The value to inspect and log. Accepts any type, including lists, tuples, dicts, numbers, strings, booleans, and tensors. | 42 |
| label | True | STRING | A short identifier for the log entry to help find it in logs. | preprocessor_output |
Outputs¶
| Field | Type | Description | Example |
|---|---|---|---|
| value | WILDCARD | The original input value, passed through unchanged. | 42 |
Important Notes¶
- Logging occurs at the DEBUG level; ensure your logging configuration is set to show DEBUG messages to see output.
- Tensor values are summarized by their shape (e.g., Tensor[...]) rather than full contents to keep logs concise.
- Lists, tuples, and dicts are logged structurally; very large or deeply nested data may produce lengthy log lines.
- If an error occurs during formatting, the node still returns the original value and logs an error message.
- Both inputs are required; provide a descriptive label to make log entries searchable.
Troubleshooting¶
- No debug output visible: Set the application log level to DEBUG and check the correct log destination.
- Hard to identify entries: Use a unique, descriptive label per debug point.
- Too much output: Place the node sparingly or reduce data size before logging; consider logging only at critical points.
- Tensor contents not shown: This node intentionally logs tensor shapes only; use specialized inspection nodes or save to files if you need full values.
- Custom object appears as type name only: The node logs unknown types by their class name; convert to a basic type or provide a custom string if more detail is needed.