Skip to main content

Logs

The Logs page provides centralized access to log data collected from all edge devices in your tenant. Logs are aggregated and stored in Loki, allowing you to search, filter, and stream log entries from a single interface.

Log Sources​

Logs are collected from multiple sources on each edge device:

  • VPP Logs -- Output from the VPP data plane, including interface events, plugin messages, and error conditions.
  • System Logs -- Operating system-level logs from the edge device (syslog).
  • Application Logs -- Logs from edge services such as the MQTT agent, WireGuard, and other components running on the device.

Search and Filter​

Use the search and filter controls to locate specific log entries:

  • Keyword Search -- Free-text search across log messages. Useful for finding specific error messages, IP addresses, or event identifiers.
  • Severity Filter -- Filter by log level:
    • Info -- Informational messages about normal operations.
    • Warn -- Warnings that may indicate potential issues.
    • Error -- Errors that require attention.
  • Time Range -- Narrow results to a specific time window. Supports predefined ranges (1h, 6h, 24h) and custom date/time selection.
  • Device Filter -- Select one or more specific edge devices to view logs from only those devices.

Filters can be combined. For example, you can search for the keyword "timeout" with severity "error" on a specific edge within the last 6 hours.

Real-Time Log Streaming​

Enable live tail mode to stream logs in real time as they arrive. The log view auto-scrolls to show the most recent entries, similar to running tail -f on a log file.

Live tail is useful for:

  • Monitoring an edge during a configuration change.
  • Watching for errors during troubleshooting.
  • Verifying that a fix has resolved a recurring issue.

You can pause auto-scroll at any time to inspect a specific log entry without losing your place.

Log Export​

To save logs for offline analysis or to share with support, use the Download button to export the current log view as a text file. The export respects your current filters, so only the matching log entries are included.

Timestamp Display​

All log timestamps are displayed according to your configured timezone preference. You can change your timezone under Settings > Date & Time. This ensures that log entries align with your local time when correlating events.

info

Logs are retained for a configurable period. The default retention period is 30 days. Logs older than the retention window are automatically purged. If you need to preserve logs beyond this period, use the export feature to download them before they expire.