Data and logging actions / Action reference
Log message
Manual / Actions / Data and logging
Write a message to the run log, and optionally to a file.
Read Shared action rules for disabling this action, outputs, error routing, and recovery.
Configuration and behavior
| Parameter | Default | Notes |
|---|---|---|
| Message * | - | Recorded in the job's step log after variables resolve. `${run.now |
| Also write to a file | off | Shows the fields below. |
| Destination folder | - | Created if missing. Its parent must not be a symlink (on macOS use /private/tmp/…, not /tmp/…). |
| File name | - | Required when writing to a file. A plain name. |
| Format | Plain text | Plain text writes one line (line breaks escaped). JSON requires the message to be one JSON object and writes it compacted on one line - JSON Lines when appending. |
| Write mode | Append | Append adds one line per job; Overwrite replaces the file each job. |
| Rotate at | 100MB |
When the file reaches this size it is gzipped to .1.gz and a new file started. The five most recent archives are kept. Accepts KB/MB/GB or a byte count. |
Outputs: message, path (file output only).