Log Files – View and Export MideyeServer System Logs

Overview

The Log Files page provides a web-based log viewer for MideyeServer’s system log files. Administrators can select from available log files, view their contents in real-time with auto-scrolling, search for specific entries, and export log files for offline analysis or sharing with support teams.

This page eliminates the need for direct server access to review logs. The viewer supports real-time tailing (follow mode), case-insensitive search, and selectable lines — making it an effective tool for live troubleshooting, post-incident analysis, and diagnostic data collection.

Note

This page does not use a data grid. It renders log file contents in a specialized log viewer component optimized for large text files.

Access & Permissions

Required Role: ROOT, SUPER_ADMIN, or ADMIN

Navigation: Home → Logs → Log Files

Role	View Logs	Export Logs
ROOT	✅	✅
SUPER_ADMIN	✅	✅
ADMIN	✅	✅
OPERATOR	❌	❌

Caution

OPERATOR role users do not have access to system log files. This page requires ADMIN or higher privileges.

Features & Configuration

Selecting a Log File

A dropdown selector at the top of the page lists all available log files on the server. By default, mideyeserver.log is selected — this is the primary application log file.

Other log files may include rotated logs (e.g., mideyeserver.log.1, mideyeserver.log.2.gz), trace logs, and error-specific log files depending on the server configuration.

Log Viewer

The log viewer renders the selected file’s content in a scrollable, formatted display that fills the available viewport height. Key features:

Feature	Description
Follow mode	Auto-scrolls to the bottom as new log entries are written. Useful for live monitoring.
Search	Built-in search bar for finding specific text within the log file. Case-insensitive.
Line selection	Click on individual log lines to highlight and select them.
Responsive height	The viewer adjusts to fill the available viewport (calc(100vh - 250px)).

The log content is fetched via an authenticated API call using the current user’s JWT token, ensuring secure access to sensitive log data.

Exporting Log Files

Click the Export (download) icon button next to the log file selector to download the currently selected log file.

Export Dialog:

• Confirmation message: “Are you sure you want to export log file with name: [filename]?”
• On confirmation, the file is downloaded as a binary blob to the browser.

The exported file retains its original filename and format.

Actions

Select Log File

Purpose: Switch between different server log files. Steps: Use the dropdown selector to choose a log file. Result: The viewer loads and displays the selected file’s contents.

Search Within Log

Purpose: Find specific text patterns within the displayed log. Steps: Use the built-in search bar in the log viewer to enter a search term. Result: Matching lines are highlighted in the viewer. Search is case-insensitive.

Export Log File

Purpose: Download a log file for offline analysis or to share with support. Steps:

1. Select the desired log file from the dropdown.
2. Click the Export (download) icon.
3. Confirm the export in the dialog.

Result: The log file is downloaded to the browser as a file.

Common Use Cases

Live Troubleshooting

1. Select mideyeserver.log from the dropdown.
2. Enable follow mode to auto-scroll to new entries.
3. Reproduce the issue in another browser tab or on the network.
4. Watch for relevant log entries in real-time.

Investigating a Past Incident

1. Select the relevant log file (may be a rotated file for past dates).
2. Use the search function to find entries by timestamp, username, error message, or correlation ID.
3. Export the log file if needed for detailed offline analysis.

Collecting Diagnostic Data for Support

1. Select each relevant log file in turn.
2. Export each file using the download button.
3. Attach the exported files to a support ticket.

Troubleshooting

Issue	Possible Cause	Resolution
Log viewer appears empty	Log file is empty or newly rotated	Select a different log file or wait for new entries
Export fails	File size exceeds browser memory	Try exporting from the server directly via SSH
Search finds no results	Search is case-insensitive but requires exact substring	Try shorter or broader search terms
Page shows access denied	OPERATOR role	Log files require ADMIN role or higher

Related Pages

• Log Configuration — Change log levels and enable trace logging
• Authentication Logs — View structured authentication events (separate from system logs)
• Audit Logs — Track administrative actions and configuration changes