Skip to main content
ThreatLab exercises put real log data into your SIEM so you can practise SOC investigation techniques in a hands-on environment. This guide covers the full analyst workflow — finding an exercise, starting it, working through each investigation step, and recording your completion so your progress and points are updated.

Finding exercises

Navigate to Exercises in the left sidebar to browse the full catalogue. Each exercise card shows the title, difficulty level, estimated duration, point value, and MITRE ATT&CK tags. Use the tags and difficulty filter to find scenarios that match your current learning goals. Learning Paths organise exercises into a recommended sequence. If your administrator has set up a learning path, follow it in order — each exercise unlocks the next as you complete it.

Starting an exercise

1

Open the exercise detail page

Click the exercise title from the catalogue or learning path view. The detail page shows the full description, MITRE tags, and the ordered list of investigation steps you will work through.
2

Click Start

Click the Start button. ThreatLab creates a session and ships the exercise log archive to your configured SIEM destination. Depending on archive size, shipping may take a few seconds.
3

Locate the logs in your SIEM

Once the archive is shipped, the exercise page shows the index name or sourcetype where the logs were ingested. Open your SIEM and search that location to confirm the data has arrived before you begin investigating.
4

Investigate and work through each step

Read each step’s investigation prompt, search the logs in your SIEM, and record the artifact value you discover. Submit the value in the artifact field for that step. When you are ready to move on, proceed to the next step — partial progress auto-saves so you can close the browser and return later.
Starting an exercise ships real log data to your organisation’s SIEM. Check with your administrator before starting exercises in a production environment — use a dedicated training index or destination to avoid mixing exercise data with live operational data.

Section shipment status

Some exercises stage their log archives in multiple sections that ship at different points during the attempt — for example, releasing later evidence only after you have submitted earlier artifacts. When an exercise uses staged shipping, the exercise detail page shows a section shipment panel that tells you, per section, exactly what is happening with its logs. Each section row displays one of five states:
StateWhat it means
Not dueThe section is waiting on a release delay. Its logs will ship automatically once the delay elapses.
Waiting on artifactThe section is gated on one or more expected artifacts. The panel lists which artifacts still need to be submitted before the logs ship.
ShippingThe section is eligible and ThreatLab is currently sending the archive to your SIEM.
ShippedThe section’s logs are in your SIEM and ready to investigate.
FailedAn upload attempt failed. ThreatLab will retry automatically — no action is needed from you.
The panel only shows learner-safe details: it never exposes internal error stacks or operational data. If your role has the operational-error capability, the failure reason is shown verbatim; otherwise you only see that ThreatLab is retrying.

Manually pushing logs

If you click Ship logs to SIEM during an attempt, ThreatLab returns one of the following explicit reasons so you know exactly what happened:
ReasonMeaning
shippedAt least one section was just shipped to your SIEM.
partialSome sections shipped, but others were already shipped earlier.
already_shippedEvery section that is eligible right now has already been shipped.
not_dueNo section is currently due — they are all still inside their release delay.
waiting_on_artifactsSections are eligible only once you submit the gated artifacts. Keep investigating.
shippingA previous shipment is already in flight; ThreatLab will not duplicate it.
cooldown_skippedThe destination SIEM is inside its dedupe cooldown window; no new upload was needed.
failedA shipment attempt failed. ThreatLab will retry; check the section shipment panel for details.
If a section is stuck on Waiting on artifact, open the section row in the shipment panel — it lists exactly which expected artifacts are missing so you know which steps to keep working on.

Working through steps

Steps appear in order on your exercise workspace. Each step includes an investigation prompt that describes what you are looking for, and an artifact submission field where you enter your answer. Submissions are checked case-insensitively — capitalisation differences will not cause a correct answer to be rejected. Your progress auto-saves after each accepted submission, so closing the page does not lose your work.

Investigation notebook

Your exercise workspace includes a private notebook where you can write notes as you investigate. To open it, click Notebook from the exercise workspace toolbar.
  • Observation — raw data points you notice in the logs
  • Hypothesis — possible explanations you are testing
  • Finding — confirmed conclusions from your investigation
  • Other — anything that does not fit the above categories
Notebook entries are private to you. Administrators with the review_notebooks capability can read them if your organisation uses a supervised training model, so treat your notebook as a professional working document.

Completing an exercise

When all step artifacts have been submitted and accepted, ThreatLab automatically records your completion, awards the exercise’s point value to your account, and updates the leaderboard. The exercise moves to your History page where you can review your submitted artifacts and the time you took.

Redoing an exercise

Open a completed exercise and click Redo to start a fresh session. ThreatLab creates a new session and ships the archive again. If you have the force_siem_push capability, the platform bypasses the normal upload cooldown between sessions.
Check the MITRE ATT&CK tags on the exercise before you start — they hint at which adversary techniques appear in the logs and can save you significant investigation time by narrowing your search.