Teacher Assist User Manual

Introduction to Teacher Assist #

With Teacher Assist teachers are given the ability to monitor and control students while class is in session. With this tool, teachers can ensure that students stay on track and follow along with the subject being taught. Having the ability to track student engagement in real-time is a big asset for teachers, Google Workspace Super admins, and Principals. 

Functionality that teachers have: 

  • Monitor the current screen of all students in their classrooms.
  • View all of the tabs on students’ Chrome Browser. 
  • Close browser tabs that are irrelevant for students.
  • View the browser history during the active session. 
  • Distribute a website to automatically open and display on some or all students’ screens. 
  • To block a website from being used while class is in session.  

Super Admins, principals, or teachers can create a group of students whose behavior is alarming. The group can be monitored and controlled with the same abilities above.

Who can access the Teacher Assist tool? #

By default, all G Suite Super Admins have access to the tool.

Login to Chrome #

Note: for Teacher Assist to work – the students have to be logged into Chrome browser and GAT Shield has to be enabled. Visit this page for more information

Teachers #

Teachers are Google workspace users who are assigned as Teachers to a Google Classroom.

Teachers who own or have created a Google Classroom can log in and use Teacher Assist.

Classroom groups #

Within Teacher Assist we have an option for Classroom groups. Classroom groups are artificial classrooms, where the Super Admin of the domain can create Classroom Groups and assign users to them.

The users can be assigned as Students and Teachers to the classroom groups. Please check this how-to for more details.

How can a teacher start a session? #

Launch Teacher Assist from the Google Apps button 

Alternatively can be launched from this URL:  https://gs.generalaudittool.com/apps/teachers

Google Classrooms control #

From the menu on the left select Classrooms

Teacher Assist classroom session #

On the right side click on the Play button to start a session

The classroom session will be started.

You will see a list of students if they are already connected and logged in to their devices. The browsing activity will be automatically displayed

Important: Make sure that students are signed in to their school Google account on ChromeOS devices and if they’re using Windows or Apple devices that they sign in and sync with their Google Chrome browserShield must be deployed on the student accounts.

View student’s open Chrome tabs #

Double-click on a student’s screen, to view things in greater depth. Alternatively, click on the action drop-down where you’ll see the option VIEW.

When you have clicked VIEW or double-clicked on the screen, you will see the current screen the student is on.

On the right-hand side, you will see a Tab list of all tabs that are currently opened on the student Chrome browser.

Clicking on the icons next to the webpage will either Switch, Open, or Close the Tab.

Take action on a single student  #

Hover over the action button to see all of the individual actions you can take.

You will be presented with the following options: 

    1. Open New Tab – this will open a new tab on the student’s device. 
    2. Distribute Current Page – will distribute the current tab to all other students. 
    3. Block Current Page – This will prevent the student from accessing the webpage. 
    4. Browsing History – will show all of the webpage accessed by the student from the point of the session starting.
    5. Chat – It will launch a chat window with the student.
    6.  Set Lock Tab – This will lock the student in the current tab.
    7.  Release Lock Tab – It will release the locked tab.
    8.  Pin Student – Pin this student to the top of the virtual class granular display.
    9.  Unpin Student
    10.  Attendance Note – take note of the attendance of missing students.

Take action on all students  #

When hovering over the classroom action bar, you will be presented with the following options:

  • Select All – select all students.
  • Clear selection – clear the selected students.
  • Open New tab – set a page as allowed and distribute the page to ALL users.
  • Push Site Collection – push out any defined Google Sites.
  • Classroom Announcement – send an announcement to all students that will appear on their screen.
  • Site control – apply rules for all students in the classroom
    • Block all sites by default – block all pages (disable the students to access any site)
    • Allow – individual pages – allowed pages will only be allowed
    • Block – individual pages
  • Reconnect – if the class is having any connectivity issues.
  • Attendance list – A list of students and respective notes on why they haven’t attended the virtual class.

The above rules are applied for the Teacher assist session. Pages will be allowed after the Teacher leaves the session.


  • Reconnect – Set reestablishment of the connection. Use if students were not logged in to their account at the start of the session. Use reconnect to reconnect with student accounts.

Classroom details #

In the Classroom tab, view all the Classrooms and apply the filter by Teacher 

  • Click on the Play button to start a session
  • Click on the Pen icon to view details for the classroom.
    • List of Students
    • Prepare class session
      • Apply rules
        • Block all sites by default
        • Allow pages
        • Block pages
  • Click on the Arrows icon to refresh the classroom membership (refresh to update new members of the class) or view the Attendance List.

    • The last button will lead you to the Classroom insight tab

Classroom Insights #

Classroom Insights will display additional information regarding the classrooms.

This will allow the teachers to view everything about the classrooms.

People list all students and teachers in the classroom.

In Classworks see all the classwork for the classroom, the Due date, the Average grade for the classwork, and the description.

The Grades will show all the submitted grades by the teachers for each student and the average for each classwork.

The browsing activity will use data from Shield to display the browsing done by the students for any given day (3 months back)

Groups in Teacher Assist #

Launch Teacher Assist and click on Groups

From the top right side click on Create new group

Enter a name for the group

Fill in all the details

  • Description – enter a description and edit the group name
  • Teachers – enter the teacher email and click on the Add button
  • Students – enter the student email and click on Add button

When ready with settings, click on the Exit button

The group will be created and saved under the Groups tab

Groups and Classrooms #

Teacher Assist Groups and Classrooms work in the sample principle, the Teachers can control the Students in Classes and Groups

Troubleshooting #

Connection State #

Green – WebSocket connection is established and working.

Yellow – WebSocket connection is trying to be re-establish.

Red – WebSocket connection is lost.

Grey – The user is not logged in to their account (Shield is not deployed to this user). If a student has logged in after the Teacher assist session has started their account will be “grey”, you can use Reconnect to reset the connection so the new students are visible.

Status messages #

  • Error: MSG001, ‘Messaging connection error.  The problem is caused by a connection error, invalid link or server can not create a connection. Please contact us at support@gatlabs.com
  • Error: MSG002, ‘Messaging connection error. The problem is caused by configuration or the messaging system is not enabled for the domain. Please contact us at support@gatlabs.com
  • Looking for a student – application is looking for a student, if the connection process stops at this stage it means the remote peer (student) is not connected or online
  • The student is online, preparing to stream – the student is connected to the system and is waiting for the streaming [webrtc] connection. If the message is not changing it means that the streaming connection can not be created, because of network/firewall/nat settings.
  • Connection is failing to complete on the remote side (user enrolled in another session) – the remote peer refused connection because the user is already in another session. A student can’t be in two monitored classrooms at once.
  • Connection is failing to complete on the remote side disabled by config – the remote peer refused connection because it’s disabled by config. Configuration should be updated in 15 min. If the situation repeats please contact us at support@gatlabs.com
  • Connection is failing to complete on the remote side (browser has been closed) – the remote peer refused connection because all tabs for the user’s browser are closed. This is the same as ‘there is nothing to see here. The student must open at least one tab in the browser for the teacher to see.

Network and Firewall Requirements #

Make sure the Firewall settings allow those ports:

  • The Port for messaging is 9871 TCP for WebSocket and HTTP traffic.
  • WebRTC ICE server port 3478 UDP/TCP

This website uses cookies to ensure you get the best experience on our website