Monitoring a workshop

This section explains how to troubleshoot issues during a workshop. There are two commands that help you to troubleshoot issues:

  1. The active users command.

  2. The track logs command.

The active-users command shows the invite's currently active users. Below we show an example invocation of this command:

» instruqt active-users --invite-id ddkk2oevzjw
==> Active students for invite (ID: ddkk2oevzjw)
Last Activity Track Challenge Participant User
2020-01-03 13:45:00 hashicorp/consul-connect challenge-two (2/10) abcd1234 "Adé Mochtar" [email protected]
2020-01-03 12:45:00 hashicorp/consul-connect challenge-one (1/10) 9876qwer "Michael Meier" [email protected]
2020-01-02 11:45:00 hashicorp/consul-connect challenge-three (3/10) jkhdf831 <anonymous> wio83vjs
2020-01-01 10:45:00 hashicorp/vault-basic challenge-one (1/6) nxpp29ks <anonymous> kjhsdf91
...

The fourth column in the result represents the user's participant ID. This identifier is unique for the user's current play. With this identifier you can filter the logs of this track to debug the user's sandbox environment:

» instruqt track logs --participant-id abcd1234
==> Tailing logs for track 'instruqt/consul-connect' (ID: kddytu7taa8b)
2021-02-15T09:22:25Z abcd1234 INFO: Setting up environment
2021-02-15T09:22:25Z abcd1234 INFO: Running 'terraform init'; workdir: /tmp/
2021-02-15T09:22:25Z abcd1234 INFO: Initializing modules...
2021-02-15T09:22:25Z abcd1234 INFO: - core in core
2021-02-15T09:22:25Z abcd1234 INFO: - shell in container
2021-02-15T09:22:25Z abcd1234 INFO:
2021-02-15T09:22:25Z abcd1234 INFO: Initializing the backend...