Files
wekan/docs/Features/Admin-Panel/Problems/Tests.md
T
Lauri Ojansivu a8fd080bc8 Docs mirror the Admin Panel and the menus: a page for every menu entry.
The docs tree is laid out like the menus - a menu path is a docs path.
Admin Panel / Settings follows the new structure: Visibility.md is
Appearance.md, with new Features.md, Feature-Profiles.md, Security.md,
Activities-and-Notifications.md and Delete.md; the section indexes,
Admin-Panel.md, Admin-Panel-URLs.md (with the moved-pane redirects) and
Validation.md follow the live menus, and Who-Sees-What.md explains in one
place which layer decides what is shown and what is allowed.

Pages are added for the menu entries that had none, each written from
the code: every Admin Panel / Problems pane, the member menu, the board
header, Board Settings, the All Boards left menu, and the list,
swimlane and card menus. Older links to the moved panes are updated
across docs/.

TODO.md records what documenting the menus found: Edit Profile does not
save a username for non-admins, the Support page's signed-out case is
unreachable, Create board from this card is hidden from members who can
edit the card, All Boards Settings is unreachable, and the Share template
targets live in browser storage.

Thanks to xet7 !
2026-11-19 01:22:22 +02:00

1.9 KiB

Admin Panel / Problems / Tests

Runtime self-checks that failed: the kind of invariant a WeKan unit test asserts, checked on the running server without a browser and without Playwright. Address: /admin/problems/tests. Site administrators only.

Where the rows come from

The tests stream of the eventlog collection, written by server/lib/selfChecks.js through server/lib/testLog.js. The checks run once, 15 seconds after the server starts. Only a failure is recorded; a passing check writes nothing.

Check (Source column) Fails when
self-check:database-roundtrip a one-document query to the database fails
self-check:writable-path a probe file cannot be written and removed in WRITABLE_PATH/files
self-check:heap-headroom the V8 heap uses 90 % or more of its limit
self-check:free-disk-space the files filesystem has less free space than WEKAN_MIN_FREE_DISK_MB (default 256 MiB)

A failure is recorded with category test-failure, name TestBleed, action failed and severity medium; the Detail column is the check's error message.

The admin-only method runSelfChecks runs the checks again on demand. The pane itself has no button for it.

The table

The same read-only event table as the Security Report: Date and time, Category, Name, Severity, Action, Source, Username, IPv4, Location, IPv6, Location, Attempts and Detail, newest first, 10 rows a page, with a search box that filters as you type. "No new problems." means no check has failed since the stream was last cleared.

Acknowledge or clear the stream on Summary. Rows older than EVENTLOG_RETENTION_DAYS (default 90) are deleted daily. The rows are also on GET /api/admin/problems/tests (REST API).