What This Page Does

The Log Viewer lets you see what is happening behind the scenes on your site. It shows activity records (called "logs") that your site creates as it runs. You can use it to spot errors, search for specific events, and clean up old log files to free up space.

[Screenshot: page-overview]

How to Get Here

Navigate to Admin Panel > Tools > Log Viewer

Understanding the Page

When you open the Log Viewer, you will see a summary bar at the top, a file list on the left, and a viewing area on the right.

Quick Links Bar

At the very top, below the page title, you will see a row of links to other tools in the same family (Feature Toggles, Style Manager, Layout Manager, and others). The Log Viewer link is highlighted to show you are on this page.

Summary Cards

Four cards give you a quick snapshot of your logs:

[Screenshot: statistics-cards]

File Browser (Left Side)

The left panel lists all your log files, grouped by category:

• Application Logs -- General site activity
• API Logs -- Communication between your site's systems
• Video Processor Logs -- Video conversion and processing activity
• Storage Server Logs -- File storage and delivery activity
• Admin Logs -- Actions taken in the admin panel

Each file shows its name and size. If a file contains errors from today, a red badge shows the error count next to the filename.

Click a group name to expand or collapse it. Click a file to view its contents.

[Screenshot: file-browser-panel]

Log Viewer (Right Side)

When you select a file, its contents appear here. Each line is color-coded so you can quickly tell what type of entry it is:

• Red lines are errors
• Yellow lines are warnings
• Blue lines are informational messages
• Gray lines are detailed debug messages

An information bar above the log content shows the file size, total number of lines, when it was last updated, and which lines you are currently viewing.

Common Tasks

How to View a Log File

1. Look at the file list on the left side of the page.
2. Click the group name (for example, Application Logs) to expand it if it is collapsed.
3. Click the file you want to view.
4. The file contents appear in the viewing area on the right.

How to Search Within a Log File

Use this when you are looking for a specific word or phrase in the file you have open.

1. Select a log file from the left panel.
2. Type your search term into the Search box above the log content.
3. Press Enter or click Apply.
4. Matching text is highlighted in yellow so you can spot it easily.

How to Filter by Type

Use this to show only errors, warnings, or other specific types of entries.

1. Select a log file from the left panel.
2. Click the Level dropdown above the log content.
3. Select the type you want to see:

• All Levels -- Show everything
• Error -- Only errors
• Warning -- Only warnings
• Info -- Only informational messages
• Debug -- Only detailed debug messages

1. Click Apply.

How to Search Across All Log Files

Use this when you are not sure which file contains the information you need.

1. Click the Search All Logs button at the top of the page.
2. A search window opens.
3. Type your search term (at least 2 characters).
4. Optionally, select a level from the dropdown to narrow results.
5. Click Search or press Enter.
6. Results appear showing the file name, line number, and matching content.
7. Click any result to jump directly to that file in the viewer.

[Screenshot: global-search-results]

How to Watch a Log File in Real Time

Use this when you want to see new activity appear as it happens, for example while testing something on your site.

1. Select a log file from the left panel.
2. Click the Tail Mode button (the circular arrow icon) in the toolbar above the log content.
3. A green LIVE indicator appears, and new entries will show up automatically.
4. Click Tail Mode again to stop live monitoring.

How to Download a Log File

Use this to save a copy of a log file to your computer.

1. Select a log file from the left panel.
2. Click the Download button (the down arrow icon) in the toolbar.
3. The file saves to your computer's downloads folder.

How to Clear a Log File

This empties the file but keeps it in place so your site can continue writing to it.

1. Select a log file, or hover over a file in the left panel and click the gear icon that appears.
2. In the management window that opens, click Truncate.
3. Confirm when prompted.

How to Archive a Log File (Rotate)

This saves the current file with a date stamp in its name and creates a fresh, empty file in its place. It is the safest way to start with a clean log without losing your history.

1. Select a log file, or hover over a file in the left panel and click the gear icon.
2. In the management window, click Rotate.
3. Confirm when prompted.
4. The old file appears in the file list with a date-and-time suffix (for example, error2026-02-03143022.log), and the original filename is now an empty file ready for new entries.

How to Split a Large Log File

If a log file has grown very large and is slow to view, you can break it into smaller pieces.

1. Select a log file, or hover over a file in the left panel and click the gear icon.
2. In the management window, choose a split size from the dropdown:

• 10 MB
• 25 MB (the default)
• 50 MB
• 100 MB

1. Click Split.
2. Confirm when prompted.
3. The original file is replaced by numbered parts (for example, errorpart1.log, errorpart2.log).

How to Delete a Single Log File

1. Select the log file you want to remove.
2. Click the Delete button (the trash icon) in the toolbar.
3. Confirm when prompted.

How to Clean Up Old Log Files

Use this to remove log files that are past a certain age, freeing up disk space.

1. Click the Delete Old Logs button (red) at the top of the page.
2. Choose how old files must be before they are deleted:

• 7 days
• 14 days
• 30 days (recommended)
• 60 days
• 90 days

1. Click Delete Logs.
2. A confirmation message tells you how many files were removed.

Filters and Search

Searching

Type a keyword into the Search box above the log content and press Enter or click Apply. Matching text is highlighted in yellow.

Filtering

Use the Level dropdown to show only certain types of log entries:

To clear your filters, set the dropdown back to All Levels, clear the search box, and click Apply.

Tips for New Users

Troubleshooting

A log file is slow to open

What you see: You click a file and it takes a long time to load, or the page feels sluggish.

How to fix it:

1. Use the Level filter to show only the type of entries you need (for example, Error).
2. Use the Search box to find specific entries instead of scrolling through everything.
3. If the file is very large, open the management window (click the gear icon) and use Split to break it into smaller files.
4. You can also use Rotate to archive the large file and start fresh.

No files appear in the file list

What you see: The left panel is empty or all groups show zero files.

How to fix it:

1. This is normal if your site is brand new and has not generated any log files yet.
2. Visit a few pages on your site, then come back and refresh the Log Viewer.
3. If you still see no files after your site has been running for a while, contact your hosting provider or developer to confirm logging is set up correctly.

Live monitoring is not showing new entries

What you see: You turned on Tail Mode but no new lines appear.

How to fix it:

1. Make sure the log file you selected is one that your site actively writes to. Some files may only update during specific events (like video processing).
2. Try triggering an action on your site (such as uploading a video or visiting a page) and watch for new entries.
3. If nothing appears after several minutes, the file may not be in active use. Try a different log file.

The page asks you to log in again

What you see: You are redirected to the login page or see an error about an invalid session.

How to fix it:

1. Log back in to the admin panel.
2. Navigate back to Admin Panel > Tools > Log Viewer.
3. This happens when your session expires after being idle for a while. It is normal.

You see a message that changes are disabled

What you see: An orange banner at the top of the page says modifications are disabled, and buttons like Delete, Truncate, Rotate, and Split do not work.

How to fix it:
This means your site is running in demonstration mode. Contact your developer or administrator to switch to full mode so you can manage log files.

Related Pages