Skip to main content

Manual issues

Not everything worth tracking arrives in a log file. A manual issue lets you create an entry by hand - a bug you spotted, a feature request, or a task - and have it live in the same list as issues that Log Lens grouped from real events. It shares the workflow, tags, modules, severities, and history that automatic issues use, so you can triage everything in one place.

Kinds

Every manual issue has a kind. The default is issue.

KindMeaning
issueA general problem to track
bugA defect
feature_requestSomething to build
taskWork to be done

Fields

Only a title is required. Everything else has a sensible default.

FieldRules / default
titleRequired, up to 500 characters
descriptionOptional, up to 120,000 characters
kindOne of the kinds above; default issue
severityA valid level; default INFO
statusA valid workflow status; default open
source_frameRelated source (e.g. a file), up to 1,000 characters
environment1-100 characters; default local
noteCreation note, up to 10,000 characters
tag_idsArray of existing tag IDs
module_idAn existing module, or none

Tag IDs and the module are validated - if any tag or the module does not exist in the current application, creation fails.

Zero occurrences

A manual issue starts with a count of 0. It has no underlying log lines, so there is no raw event to open and no occurrence timeline - it exists purely as a tracking record. The description (or the title, if you left the description blank) becomes its sample message.

Preserved on refresh

Each manual issue gets a unique, randomly generated fingerprint and is marked with a manual origin. Because that fingerprint never collides with real log events, ingestion and reindexing will never merge, overwrite, or delete it. Your hand-written issues stay put no matter how often you refresh or reprocess your logs.

Creating one also records a status-history entry (using your note, or a default line naming the kind) and runs your automatic tag rules against the new issue.