Skip to content

Print Log

The Print Log provides a chronological table of all print activity across your printers, giving you a quick at-a-glance history of every print.

Overview

The Print Log is a dedicated view mode within the Archives page that focuses on print activity as a flat, filterable table. Unlike the standard archive views (grid, list, calendar), the Print Log shows one row per print event with key details at a glance.

Accessing the Print Log

  1. Go to the Archives page
  2. Click the Print Log button in the header toolbar (next to the grid/list/calendar view toggles)

Table Columns

Each row in the Print Log represents a single print event:

Column Description
Date/Time When the print completed
Print Name Name of the print (with thumbnail)
Printer Which printer ran the job
User Username who started the print (when authentication is enabled)
Status Result badge (color-coded)
Duration Total print time
Filament Material type and color indicator

Status Badges

Status Color Description
Completed Green Print finished successfully
Failed Red Print encountered an error
Stopped Orange Print was manually stopped
Cancelled Grey Print was cancelled before finishing
Skipped Purple Print was skipped in the queue

Filtering

Narrow down log entries using the filter controls at the top of the table:

Filter Description
Search Free-text search across print names
Printer Show entries from a specific printer
User Show entries from a specific user
Status Filter by result (completed, failed, stopped, cancelled, skipped)
Date From Show entries from this date onward
Date To Show entries up to this date

Combining Filters

All filters can be combined. For example, show only failed prints from "Workshop X1C" in the last week by selecting the printer, status, and date range together.

Pagination

The Print Log supports configurable pagination for navigating large histories:

Setting Options
Rows per page 10, 25, 50, or 100
Navigation Previous / Next page buttons

The current page range and total entry count are displayed alongside the navigation controls.

Clearing the Log

The Clear button removes all log entries from the database.

Permanent Action

Clearing the log permanently deletes all log entries. This action cannot be undone.

Archives Are Not Affected

The Print Log is stored independently from your archives and print queue. Clearing the log only removes log entries -- your archived 3MF files, metadata, and queue history remain untouched.

How It Works

Automatic Logging

Log entries are written automatically whenever a print completes. No configuration is required -- once archiving is active, print events are recorded in the log.

Independent Storage

The Print Log uses its own database table (print_log_entries), separate from the archives table. This means:

  • Log entries exist independently of archives
  • Deleting an archive does not remove its log entry
  • Clearing the log does not affect archives
  • The log is lightweight and optimized for fast querying

Permissions

When authentication is enabled, the Print Log respects the following permissions:

Action Required Permission
View the Print Log ARCHIVES_READ
Clear all log entries ARCHIVES_DELETE_ALL

API Access

List Log Entries

GET /api/v1/print-log/

Query Parameters:

Parameter Type Description
search string Search print names
printer_id integer Filter by printer ID
created_by_username string Filter by username
status string Filter by status (completed, failed, stopped, cancelled, skipped)
date_from datetime Start of date range
date_to datetime End of date range
limit integer Number of entries per page (default 25)
offset integer Pagination offset

Example:

curl -H "X-API-Key: your-key" \
  "http://localhost:8000/api/v1/print-log/?status=failed&limit=10"

Clear All Log Entries

DELETE /api/v1/print-log/

Removes all log entries. Requires ARCHIVES_DELETE_ALL permission.

Example:

curl -X DELETE -H "X-API-Key: your-key" \
  "http://localhost:8000/api/v1/print-log/"

Tips

Quick Status Check

Use the status filter to quickly find all failed prints and investigate patterns.

Date Range Analysis

Set a date range to review a specific time period, such as "last week" or "this month."

Per-User Tracking

When authentication is enabled, filter by user to see each person's print activity.

Lightweight History

The Print Log loads faster than the full archive views since it only fetches tabular data without thumbnails and 3MF metadata.