Шаблон «Log»

Потокова стрічка з до 20 рядків у порядку від найновіших, кожен з опціональною позначкою часу та рівнем серйозності. Сервер зберігає буфер прокручування назад, який можна завантажити в застосунку, тоді як Дія наживо завжди показує найновіші рядки.

Fields

Field	Type	Description
`template`	string	Required. Must be `"log"`
`lines`	array	Required. 1–20 line objects, newest first (see below)
`state`	string	Status text shown beside the activity name (e.g. the source name)
`icon`	string	SF Symbol name (e.g. `"doc.text"`) or MDI icon with `mdi:` prefix
`accent_color`	string	Named color or hex used for the heading icon. Default: `green`
`background_color`	string	Background color override
`text_color`	string	Text color override

ℹ Інформація

The heading above the feed is the activity's top-level name, not a content field. Set it when you create the activity.

Line object

Each entry in lines is an object:

Field	Type	Description
`text`	string	Required. The log message. Max 512 characters
`at`	integer	Unix timestamp (seconds) shown as the line's time
`level`	string	One of `info`, `warn`, `error` — tints the line and its marker

ℹ Інформація

Send the newest line first, up to 20 lines per push. To stream a feed, prepend the new line and re-send the array. The Live Activity always shows the most recent lines that fit the ~4 KB APNs payload.

💡 Порада

The server keeps a rolling scroll-back backlog beyond what fits on screen. The PushWard app fetches it with GET /activities/{slug}?include=log_backlog to show full history in-app — the field is read-only and never needs to be sent.

Example: Streaming Deploy Log

Потоковий журнал розгортання

{
  "state": "ongoing",
  "content": {
    "template": "log",
    "state": "pushward-server",
    "icon": "doc.text",
    "accent_color": "purple",
    "lines": [
      { "text": "Rollout complete — 3/3 pods healthy", "at": 1718990000, "level": "info" },
      { "text": "Image pull slow on node arm-2", "at": 1718989950, "level": "warn" },
      { "text": "Applied manifest revision d86246c", "at": 1718989930, "level": "info" },
      { "text": "Sync started by webhook", "at": 1718989900, "level": "info" }
    ]
  }
}

Typical Flow

Start the feed (ended -> ongoing): Send the first batch of lines, newest first
Append events (ongoing -> ongoing): Prepend each new line and re-send lines — older lines roll into the backlog
Finish (ongoing -> ended): Send a closing line, then end the activity

Use Cases

CI/CD — live deploy and pipeline logs
Home automation — event feeds (motion, doors, presence)
Monitoring — rolling alert and incident streams
Self-hosting — download/import progress, backup steps, sync activity