Skip to content
Community

EXPLORE TOPICS

Editorial approach

New to CoreTrailKit?

Observe your services. Keep the evidence close.

CoreTrailKit
Back to articles
GUIDE/ CoreTrailKit

Investigate a service incident with CTK

Imagine a worker stops and dependent health checks start failing. The useful question is not which dashboard has the most red marks, but which source reported what, and when.

By CoreTrailKit3 min read

01

1. Establish the current scope

Open the affected watched repository from Home. In Overview, identify the service that needs attention, then open Observe for the full reading. Check freshness before treating a retained snapshot as current.

Read What, When, Why and How together. An out-of-memory report, an exit code and an unhealthy check are different facts. No cause recorded means the source did not state one; it is not an invitation to invent an explanation.

02

2. Separate a failure from a missing observation

Use Signals to inspect which runtime and health readings are present. Normalize helps show whether both sides were combined or one side is missing. A running process with no health check has less evidence than a service with a passing check.

Insights and Inference organize the same available evidence. They do not create a new measurement or make an unobserved dependency become established. Return to Observe whenever you need the source-stated cause.

03

3. Reconstruct the recorded sequence

Open Timeline and compare the affected service before, during and after the incident. Use Activity to inspect changes across watched repositories. Note both the service and the time instead of treating nearby events as a proven chain of causation.

The local history retains the latest 1,000 recorded changes per repository. It is a change history, not an unlimited raw-log archive or a continuous recording of every event between polling intervals.

04

4. Check current alarms and dependencies

Alarms surfaces currently stated causes; it is not the complete historical incident list. A cause that is no longer stated can leave Alarms while the earlier record stays in Timeline and Activity.

Use Topology Tree and Knowledge Graph when dependency evidence exists. An unresolved or absent dependency is a limitation of the available evidence. Do not label the database as the cause merely because it is usually involved in the architecture.

05

5. Repair outside CTK and verify the result

Use your editor, terminal or deployment workflow to investigate further and make the change. CTK does not commit a patch or deploy a fix. Keep the observing watch running when appropriate, then compare a new successful reading with the earlier failure.

If you link a solution to a stated cause, Recommendations can show its relationship to subsequent readings. An empty Recommendations screen before a solution is linked is expected. A linked note is not proof that the repair worked; fresh evidence still matters.

06

What success looks like

You can state the observed failure, its source, its time and the later verification separately. If the record only supports “the health check failed,” preserve that uncertainty rather than writing “CTK proved the root cause.”

Know the limits

CTK exposes observed evidence. An exit code or failed health check is not proof of every deeper cause, and Recommendations does not automatically fix a service.

Sources & further reading

A technical publication by CoreTrailKit.

Browse all articles

CONTINUE EXPLORING