Skip to main content

# Send Controller Logs (LCC.log)

## Signature​

    LCC.log(id, ...)
    LCC.log(log_map)

## Parameters​

- id
  Integer from 1 to 6, pointing to one of the controller's six log channels.
- ...
  Variadic arguments. Strings or tables; tables are serialised with `table.deep_dump`, strings can embed `[DATE]` and `[LINE]` placeholders.
- log_map
  Table whose keys match the aliases defined via `set_log_aliases`; values can be strings or tables.

## Returns​

- none

## Notes​

> Validates that a controller address has been configured, otherwise raises an error.
> Retries on network issues until the log is delivered; during retries a `sys.toast` notification is shown.
> When using the alias map form, only keys that match an alias are sent, routed to the corresponding channel number.

## Example​

    LCC.log(1, "[DATE] sync starting", { count = 128 })

    LCC.log({
        ["Status"] = "Sync complete",
        ["Error"] = "0"
    })