Track invites
Learners use a track invite link to claim access to a private track.
You can add limitations to a track invite link to prevent unlimited usage of the link:
  • Set the link itself to expire
  • Require learners to have an account to use the link
  • Expire the learner's access to the track after a certain amount of time
In this guide, you learn about:
If you have a private track on Instruqt, you can create a track invite using the web console. Currently, there is no way to create track invites using the CLI. To create a track invite:
  1. 1.
    Go to your organization page
  2. 2.
    Click on the tab Invites to navigate to the track invite overview page
  3. 3.
    Click on the Create button to add a new invite.

Step 1: Add a title and select a track

The track invite link has a title, which is shown only internally on the invites overview page.
  1. 1.
    Enter a title in the title field
  2. 2.
    Select a track using the track selector.
  1. 1.
    Limit the number of times the link can be used (use 0 for unlimited)
  2. 2.
    Choose Yes and set an expiration date and time for the link to stop working or choose No if you want a non-expiring link.

Step 3: (Optional) Require learners to have an account

  1. 1.
    Require learners to create an account (disallow anonymous access)
  2. 2.
    If you require learners to have an account, you can also add a list of allowed emails (or include an entire domain).
Once a learner claims an invite, they have access to the track forever unless you add limits. You can:
  1. 1.
    Limit the number of plays for a track
  2. 2.
    Make the track available to a learner for a limited time (track expiry)
If you've completed the form, you can save the track invite to get the unique link.
  1. 1.
    Press Save to save the invite and return to the Invites overview page.
  2. 2.
    Find your new invite link at the top of the table and press the ... button, then choose Copy Link.
  3. 3.
    In the Copy Invite URL modal, choose Copy To Clipboard to copy the link.
You may now share the invite link with learners who can click the link to add the track to their Study Room.
  1. 1.
    Go to your organization page
  2. 2.
    Click on the tab Invites to navigate to the track invite overview page
  3. 3.
    Find the invite link you want to delete and press the ... button.
  4. 4.
    Choose Delete
Learners can no longer use the track invite link to claim access to your track.
Learners who already claimed access to the track continue to have access if you delete the track invite link. Create an invite link with track access limits to prevent unlimited track access.
  1. 1.
    Go to your organization page
  2. 2.
    Click on the tab Invites to navigate to the track invite overview page
  3. 3.
    Find the invite link you want to delete and press the ... button.
  4. 4.
    Choose Edit
  5. 5.
    Change settings in the form and press Save
Changes to the track access limits will not affect learners who have already claimed access to your track.

Monitoring tracks played via an invite

This section explains how to monitor user activity for tracks played via an invite. There are two commands that are available:
  1. 1.
    The instruqt active-users command.
  2. 2.
    The instruqt track logs command.
The active-users command shows the invite's currently active users. Below we show an example invocation of this command:
1
» instruqt active-users --invite-id ddkk2oevzjw
2
==> Active students for invite (ID: ddkk2oevzjw)
3
Last Activity Track Challenge Participant User
4
2020-01-03 13:45:00 hashicorp/consul-connect challenge-two (2/10) abcd1234 "Adé Mochtar" [email protected]
5
2020-01-03 12:45:00 hashicorp/consul-connect challenge-one (1/10) 9876qwer "Michael Meier" [email protected]
6
2020-01-02 11:45:00 hashicorp/consul-connect challenge-three (3/10) jkhdf831 <anonymous> wio83vjs
7
2020-01-01 10:45:00 hashicorp/vault-basic challenge-one (1/6) nxpp29ks <anonymous> kjhsdf91
8
...
Copied!
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:
1
» instruqt track logs --participant-id abcd1234
2
==> Tailing logs for track 'instruqt/consul-connect' (ID: kddytu7taa8b)
3
2021-02-15T09:22:25Z abcd1234 INFO: Setting up environment
4
2021-02-15T09:22:25Z abcd1234 INFO: Running 'terraform init'; workdir: /tmp/
5
2021-02-15T09:22:25Z abcd1234 INFO: Initializing modules...
6
2021-02-15T09:22:25Z abcd1234 INFO: - core in core
7
2021-02-15T09:22:25Z abcd1234 INFO: - shell in container
8
2021-02-15T09:22:25Z abcd1234 INFO:
9
2021-02-15T09:22:25Z abcd1234 INFO: Initializing the backend...
Copied!
Last modified 29d ago