Skip to content
Kaisoft Docs

System Logs

View application logs and diagnostics for troubleshooting and monitoring Konnect’s internal operations.

Overview

Section titled “Overview”

The System Logs page provides real-time access to Konnect’s application logs. Use it to:

  • Monitor application health and activity
  • Debug connection issues with data sources
  • View API request and response details
  • Track AI assistant operations and tool usage
  • Diagnose errors and unexpected behaviour

Opening the System Logs

Section titled “Opening the System Logs”
  1. Click System Logs in the sidebar navigation.
  2. The log viewer opens with the most recent log entries displayed.

Understanding the log display

Section titled “Understanding the log display”

Each log entry shows:

FieldDescription
TimestampWhen the event occurred
LevelSeverity — DEBUG, INFO, WARN, or ERROR
SourceWhich component generated the log (e.g., MQTT, OPC-UA, Database, AI)
MessageThe log message with details

Log levels

Section titled “Log levels”
LevelColourMeaning
DEBUGGreyDetailed diagnostic information for developers
INFOBlueNormal operational events (connections, queries, etc.)
WARNYellowPotential issues that don’t prevent operation
ERRORRedFailures that require attention

Filtering logs

Section titled “Filtering logs”

Step-by-step:

  1. Use the Level dropdown to filter by severity (e.g., show only WARN and ERROR).
  2. Use the Source dropdown to filter by component (e.g., only MQTT logs).
  3. Use the Search field to find logs containing specific text.
  4. Filters combine — you can filter by level AND source AND search text simultaneously.

Common log patterns

Section titled “Common log patterns”

Successful database connection

Section titled “Successful database connection”
INFO [Database] Connected to PostgreSQL at host.docker.internal:5432/manufacturing
INFO [Database] Discovered 12 tables in schema 'public'

MQTT broker connection

Section titled “MQTT broker connection”
INFO [MQTT] Connecting to mqtt://broker.example.com:1883
INFO [MQTT] Connected successfully, client ID: konnect-abc123
INFO [MQTT] Subscribed to topic: factory/#

AI assistant query

Section titled “AI assistant query”
INFO [AI] User query: "Show me temperature readings for the last hour"
INFO [AI] Selected tools: [database_query, chart_generation]
INFO [AI] Executed query on PostgreSQL (42ms, 360 rows)
INFO [AI] Generated line chart for dashboard

Connection error

Section titled “Connection error”
ERROR [Database] Failed to connect to MySQL at 192.168.1.100:3306 — Connection refused
WARN [Database] Retrying connection in 5 seconds...
ERROR [Database] Connection retry failed after 3 attempts

Auto-scroll and live updates

Section titled “Auto-scroll and live updates”
  • Logs update in real time as events occur.
  • Auto-scroll is enabled by default — new log entries scroll into view automatically.
  • Scroll up manually to pause auto-scroll and review older entries.
  • Click Resume to re-enable auto-scroll.

Log retention

Section titled “Log retention”

Logs are stored in memory during the current session. When Konnect restarts, previous logs are cleared. For persistent logging, configure Docker logging drivers:

Terminal window
docker run -d \
  --name konnect \
  --log-driver json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  -p 7080:7080 \
  -v konnect_data:/app/data \
  ghcr.io/kyanitesolutions/konnect:beta-latest

You can then access persistent logs with:

Terminal window
docker logs konnect --tail 100 --follow

Next steps

Section titled “Next steps”