# Console log

> Write each incoming value to the Console panel with a level and label, rate-limited.

Source: https://docs.tune.toys/nodes/log.console/

Console log prints every value it receives to the Console panel, with a level and a short label, so you can see what flows through a data chain.

## What it does

Each message on `value` becomes one Console line: the time, the level, the node's label and the value rendered as text (long values are cut at 4 KiB). With `trigger` cabled, the node logs the newest `value` only when the trigger fires.

Lines go to a bounded console ring in the host (5 000 entries); nothing is logged from the audio thread. The Console panel filters by level and node, searches, pauses and copies. Its sinks can download a `.log` file, and in Chromium write to a folder you choose.

## When to use it

Use it while building: put one after a [Web request](https://docs.tune.toys/nodes/web.request/) to see the response, after [Convert](https://docs.tune.toys/nodes/data.convert/) to check a JSON pointer, or on a request's `error` output to catch refusals.

## Ports

<!-- ports:start -->

| Port      | Direction | Signal         | Lanes |
| --------- | --------- | -------------- | ----- |
| `value`   | Input     | Data (any)     | 1     |
| `trigger` | Input     | Data (trigger) | 1     |

<!-- ports:end -->

## Parameters

<!-- parameters:start -->

| Parameter | Label | Range     | Default | Unit | Scale  | Notes                                                                                            |
| --------- | ----- | --------- | ------- | ---- | ------ | ------------------------------------------------------------------------------------------------ |
| `level`   | Level | 0 to 3    | 1       |      | linear | Severity shown in the Console and used by file sinks. Choices: 0 Debug, 1 Info, 2 Warn, 3 Error. |
| `rate`    | Rate  | 1 to 1000 | 20      | /s   | linear | Most lines written per second; extra values are counted, not logged.                             |

<!-- parameters:end -->

<!-- data:start -->

- `label`: text.

<!-- data:end -->

### Level (`level`)

Debug, Info, Warn or Error. It colours the line, lets the Console filter it, and decides which file a split-by-severity sink writes it to.

### Rate (`rate`)

The most lines written per second, 1 to 1 000 (20 by default). Extra values are counted and reported in one notice instead of flooding the Console.

### Label

The `label` text field (up to 32 characters) prefixes each line. Clicking the prefix in the Console selects the node in the Patch.

## Tips

- Use the Error level on `error` outputs so problems stand out.
- A Console log changes nothing else; remove it when you are done or keep it as documentation.

## See also

[Web request](https://docs.tune.toys/nodes/web.request/), [Convert](https://docs.tune.toys/nodes/data.convert/), [Cron](https://docs.tune.toys/nodes/time.cron/), [Data cables](https://docs.tune.toys/concepts/data-cables/).