Skip to content

Plan and record maintenance

Plan work on equipment, carry it out, and close it with the outcome. Each device keeps a history: what was done, when, by whom and with what result.

Role: owner, admin or editor. Viewers can read the worklist and records.

Plan new work

  1. Open Maintenance (under Operations) and press New work.
  2. Equipment: type in "Find by tag, name or code" and pick the device from the list.
  3. Fill in the work:
  4. Maintenance type: Inspection, Calibration, Preventive maintenance, Corrective repair, Firmware update, Configuration change, Functional test, Equipment replacement or Other. To add your own type, type it in New custom type and press Add.
  5. Title: what the work is, for example "Quarterly inspection of line 2 PLC".
  6. Start as: Planned, Scheduled (the default), In progress or Completed.
  7. Due date, Priority (Low, Normal, High, Urgent), Technician or team and Maintenance window.
  8. Repeats: Does not repeat, Weekly, Monthly, Quarterly, Annually or Every N days.
  9. Optional: Procedure or vendor notes reference, External ticket (your ticket number in another system) and Notes. Keep passwords and configuration content out of notes.
  10. Press Save. The work appears in the list with a work order number, for example MW-000020.

Faster, from the device: open the device (from Assets, a QR scan or a search). Its Maintenance section has four quick actions that open the same form inside the device panel with the type and starting state filled in:

Quick action Type Starts as
Log inspection Inspection Completed
Record repair Corrective repair Completed
Record firmware change Firmware update In progress
Schedule maintenance Preventive maintenance Scheduled

Find work

The figures at the top of Maintenance are Open work, Overdue, Due in the next 30 days, Completed in period and Needs follow-up. Open and overdue are current; completed counts the dates shown under the figures.

Filter the list by site, status, type and priority, set From and To dates, search by work order, title or device, and choose the order (Due date, Priority, Last changed, Work order or Completed date). Export CSV downloads the work matching your filters as a spreadsheet file (for example maintenance-2026-11-09.csv), with the work order, device, asset tag, site, type, title, status, dates, outcome, firmware versions before and after, and follow-up.

Do the work

Click the work's title to open it. It has three tabs: Work, Complete and History.

  1. On Work, press Start when the work begins. The status becomes In progress. (Mark planned and Cancel work are there too.)
  2. When the work is done, open Complete and fill in:
  3. Done on: the date the work was done.
  4. Outcome: Successful, Partially done, Failed or Not needed.
  5. Notes and Rollback notes.
  6. Needs follow-up: tick it if something is left to do.
  7. Press Record as completed.

Firmware updates have one more field on Complete: Firmware version now installed. Enter the version the device shows. BreachSpider records it on the device and checks the device again. Findings change only when that check confirms the version: recording the work alone does not clear anything.

Repeating work: when work that repeats is completed, BreachSpider creates the next occurrence by itself, due one interval after the previous due date. For example, monthly work due 2026-11-12 is followed by work due 2026-12-12.

Check the history

The History tab lists every status change with the date, time and who made it, for example "Scheduled → In progress by [email protected]". The device's own Maintenance section lists all its work by date, with the work order, title, status and type.

Cancel work

Open the work, press Cancel work and answer "Why is this work cancelled?". The work stays in the record as Cancelled. A cancelled repeating work does not create a next occurrence.

Next

Back up and verify a configuration