Skip to main content

Events Module

The Events module provides an audit trail and operational visibility across the platform. It records everything from Terminal connections, Tunnel activity to deployments and device actions.

Event types you will see

  • Deployment events
    • Single deployment: A template or container deployed to a single device.
    • Batch deployment: A template, script, or agent update executed across multiple devices as one job.
    • Stack deployment: A compose stack rollout from a Template (may be single or batch scope, but marked as stack).
  • Script executions: Ad‑hoc or saved scripts, including exit code and duration.
  • Agent lifecycle: Agent install/update/uninstall and connectivity changes.
  • Auth and admin: Sign‑in attempts, MFA enrollment, user/group/role changes, license updates.

Statuses and lifecycle

  • queued → running → succeeded/failed/cancelled
  • Partial success is surfaced on batch jobs with per‑device breakdowns.

Working with the Events table

  • Filter by project, device, user, or type to narrow results.
  • Search free text in messages and metadata.
  • Click any event row to open Event Details. This shows:
    • Current state and timestamps (created, started, finished)
    • Correlation/Job ID and links to related items (template, device, user)
    • For batch/stack events: per‑device logs and status with filters
  • Export filtered results for audits or incident reviews.

Troubleshooting tips

  • Copy the Job ID from a deployment and paste it into the Events search to see all related entries.
  • For failures, open the event details and inspect per‑device logs to identify common root causes (image pull auth, port conflicts, timeouts).
  • Subscribe to notifications in Project Settings > Notifications to receive alerts for critical events.