InTouch Hub · Blue Isle Software

Log Error Clusterer

Cluster a batch of error log lines into root-cause groups with counts and likely causes.

logserrorstriageclustering

Log Error Clusterer

Turns a noisy pile of error log lines into a short, ranked list of root-cause groups — so you can see what is failing and how often instead of scrolling thousands of near-duplicate lines.

What it does

The InTouch AI assistant loads this skill as a prompt. It:

  1. Splits the batch into individual entries (multi-line stack traces stay attached to their parent line).
  2. Normalizes each entry into a stable signature by masking the variable parts — timestamps, IDs, UUIDs, paths, IPs, ports, line numbers, hex addresses, quoted literals — leaving the exception class, error code, and message skeleton.
  3. Clusters entries with matching signatures (same exception class + top stack frame counts as one cluster).
  4. Counts each cluster, ranks by frequency (severity breaks ties), and infers a likely root cause plus a suggested next step for each.

What to feed it

A batch of raw error/warning log lines as plain text — for example the tail of an application log, a grep ERROR dump, a CI failure log, or aggregated alert output. One entry per line; stack traces may follow their line. No particular format is required; the skill tolerates mixed timestamp styles and unstructured messages.

What it returns

A Markdown Error Log Cluster Report:

It will not invent error codes or stack frames that aren't in the input; uncertain clusters are flagged "needs investigation" rather than guessed.

Example use

Paste a few hundred lines of an application error log and ask the assistant to run log-error-clusterer. Instead of reading every line, you get back something like "78% of errors are a single DB connection-pool-exhausted cluster; one FATAL cluster is a null deref in OrderService" with the next step for each.