Track logs

Inspect track logs and troubleshoot your configurations

When a learner plays a track, events such as a sandbox provisioning, setup scripts, and more are captured within track logs.

View track logs

You can view track logs using the Web UI or the Instruqt CLI.

🌐 Web UI

1. Select the track you want to view logs for.

2. In the Statistics section, near the bottom left of the Track Dashboard, select Logs.

3. Input a date range, severity level, and sandbox ID (optional).

4. Click Apply.

💻 Instruqt CLI

1. Run the following command to view all logs for a track:

   instruqt track logs <TRACK_SLUG>

2. Filter the date range of logs using the --since flag:

   instruqt track logs <TRACK_SLUG> --since 6h

3. Filter specific sandbox logs using the --participant-id flag:

   instruqt track logs <TRACK_SLUG> --since 6h --participant-id 88ewfsfsdf89

You can determine the ID of a sandbox through the _SANDBOX_ID environment variable, present in all Instruqt sandboxes. Simply run echo $_SANDBOX_ID in a terminal tab.