Hangouts Meet audit log

Understand users video meeting activity
If you have Drive Enterprise edition, upgrade to G Suite Enterprise to get this service.

As an administrator, you can track video meeting activity in your organization using the Hangouts Meet audit log. For example, you can see when a user starts a meeting, where they’re joining meetings from, and who was in a meeting. Details for phone calls, including cost, can be found in the Voice audit logs.

Step 1: Open your Meet audit log

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Reports.

    To see Reports, you might have to click More controls at the bottom.

  3. On the left, under Audit, click Hangouts Meet.
  4. (Optional) On the toolbar, click Manage columns Manage columns and select the columns you want to see or hide.
  5. See below for how to interpret and customize log data. 

Step 2: Understand Meet audit log data

Key concepts

Review the key concepts to better understand the available audit log data.

Concept Description
Network congestion ratio

Percentage of time that the network prevented a device from sending higher-quality video due to insufficient or unstable bandwidth, such as high or unstable jitter.

Watch this metric to detect network regression in your domain.
Jitter

Variation of the latency on packets flowing between Google servers and a device in a video meeting.

In an ideal network, packets come at a constant interval. In reality, the network introduces a variety of delays, which cause the packets to come at irregular intervals.
Round trip time Length of time it takes for a packet to travel to Google servers and come back.
Bit rate Amount of audio or video information received or sent, in bits per second (bps).
Estimated download or upload bandwidth Approximate amount of network bandwidth used to send and receive audio, video, and presentation data.
Data you can view

The following tables describe the data that you can see in the Meet audit log, using Meet activity log APIs, or using the Meet quality tool.

Details for phone calls, including cost, can be found in the Voice audit logs.

Note: Different event types might include different fields.

Activity information

Data type Log UI API Quality tool Description
Date ✔ ✔ ✔ Date and time the event occurred (displayed in your browser's default time zone)
Activity name ✔ ✔   The action that was logged, such as participation in a video meeting
Activity description ✔ ✔   Details of the event

Meeting information

Data type Log UI API Quality tool Description
Conference ID ✔ ✔   Unique identifier of the meeting.
Meeting Code ✔ ✔ ✔ Code for the meeting, for example, abc-hexp-tqy. Recurrent meetings have the same meeting code.
Organizer Email ✔ ✔   Email address of the meeting creator.
Calendar Event Id ✔ ✔   The identifier for the Google Calendar event associated with the meeting.

Participant information

Data type Log UI API Quality tool Description
identifier_type   ✔   Indicates the type of the participant identifier.
Participant Identifier ✔ ✔  

Unique participant identifier, such as an email address, phone number, or device ID.

Entries appear empty for anonymous and external users.
Participant Outside Organization ✔ ✔   Indicates if the participant is not a member of your organization.
Participant Name ✔ ✔ ✔ Participant name displayed in the meeting.
Call Rating out of 5 ✔ ✔ ✔ Rating given by the participant at the end of the meeting.

Location information

Data type Log UI API Quality tool Description
IP Address ✔ ✔   Participant's external IP address.
City ✔ ✔   City or geographical region where the participant joined. This information comes from the participant's device IP address or phone number.
Country ✔ ✔ ✔ Country where the participant joined.

Session information

Data type Log UI API Quality tool Description
Duration ✔ ✔ ✔ Time in seconds that the participant stayed in the meeting.
Product Type ✔ ✔ ✔ Meeting product (classic Hangouts or Meet).
endpoint_id   ✔   Unique endpoint identifier for the current call. Joining the same meeting twice will generate 2 distinct endpoint IDs.
Client Type ✔ ✔ ✔ The participant's device type.

Network statistics

Data type Log UI API Quality tool Description
Transport Protocol ✔ ✔ ✔ Network protocol used.
Estimated Download Bandwidth in kbps ✔ ✔   Mean estimated amount of data received per second, in kilobits per second.
Estimated Upload Bandwidth in kbps ✔ ✔   Mean estimated amount of data sent per second, in kilobits per second.
Network Congestion Ratio ✔ ✔ ✔ Percentage of time when the sending bandwidth was capped.
Network Round Trip Time Mean In ms ✔ ✔ ✔ Mean network round-trip time, in milliseconds.
Network Send Jitter Mean in ms ✔ ✔ ✔ 90th percentile network jitter for sent packets, in milliseconds.
Network Recv Jitter Mean in ms ✔ ✔ ✔ Mean network jitter for received packets, in milliseconds.
Network Recv Jitter Max in ms ✔ ✔ ✔ Maximum network jitter for received packets, in milliseconds.

Audio statistics

Data type Log UI API Quality tool Description
Audio Receive Duration ✔ ✔ ✔ Length of time that the participant received audio, in seconds.
Audio Receive Bitrate Mean in kbps ✔ ✔ ✔ Mean bit rate of received audio streams, in kilobits per second.  
Audio Receive Packet Loss Mean ✔ ✔ ✔ Mean packet loss, as a percentage, for received audio streams.
Audio Receive Packet Loss Max ✔ ✔ ✔ Maximum packet loss, as a percentage, for received audio streams.
Captured Energy     ✔ Level of audio captured by the microphone.
  • None—The microphone isn’t capturing audio energy or can’t be detected.
  • Low—The microphone is capturing low energy, which can be due to the participant being quiet or far from the device, or the microphone’s gain setting being too low.
  • Good—Microphone is in the acceptable volume range.
Audio Send Duration ✔ ✔ ✔ Length of time that the participant sent audio, in seconds. 
Audio Send Bitrate Mean in kbps ✔ ✔ ✔ Mean bit rate of the sent audio stream, in kilobits per second.
Audio Send Packet Loss Mean ✔ ✔ ✔ Mean packet loss, as a percentage, for the sent audio stream.
Audio Send Packet Loss Max ✔ ✔ ✔ Maximum packet loss, as a percentage, for the sent audio stream.
Played out energy     ✔ Audio volume received and transmitted to the audio card. Peripheral selection and muted speakers won’t be captured by this metric.
  • None—The received audio had no volume, which can be due to no one speaking (expected behavior) or an issue with the microphone (unexpected behavior).
  • Low—The audio received had very low volume, which can indicate that participants were inaudible or rarely speaking.
  • Good—The received audio was in an acceptable volume range.

Video statistics

Data type Log UI API Quality tool Description
Video Receive Duration ✔ ✔ ✔ Length of time that the participant received video, in seconds
Video Receive Bitrate Mean in kbps ✔ ✔ ✔ Mean bitrate of received video streams, in kilobits per second
Video Receive Packet Loss Mean ✔ ✔ ✔ Mean packet loss, as a percentage, for received video streams
Video Receive Packet Loss Max ✔ ✔ ✔ Maximum packet loss, as a percentage, for received video streams
Video Receive FPS Mean ✔ ✔ ✔ Mean frame rate per second (FPS) of received video streams
Video Receive Long Side Median ✔ ✔ ✔

Most used long side of the received video streams (pixels)

Note: In landscape video, the long side is the video width. In portrait video, the long side is the height.
Video Receive Short Side Median ✔ ✔ ✔ Most used short side of the received video streams (pixels)
Video Send Duration ✔ ✔ ✔ Length of time in seconds that the participant’s camera sent video 
Video Send Bitrate Mean in kbps ✔ ✔ ✔ Mean bit rate of the sent video stream, in kilobits per second
Video Send Packet Loss Mean ✔ ✔ ✔ Mean packet loss, as a percentage, for the sent video stream
Video Send Packet Loss Max ✔ ✔ ✔ Maximum packet loss, as a percentage, for the sent video stream
Video Send FPS Mean ✔ ✔ ✔ Mean frame rate per second (FPS) of the sent video stream
Video Send Long Side Median ✔ ✔ ✔ Long side resolution, in pixels, used most
Video Send Short Side Median ✔ ✔ ✔ Short side resolution, in pixels, used most

Presentation statistics

Data type Log UI API Quality tool Description
Screencast Receive Duration ✔ ✔ ✔ Length of time that the participant received a shared screen, in seconds
Screencast Receive Bitrate Mean in kbps ✔ ✔ ✔ Mean bitrate of the received screencasts in kilobits per second
Screencast Receive Packet Loss Max ✔ ✔ ✔ Maximum packet loss, as a percentage, for received screencasts
Screencast Receive FPS Mean ✔ ✔ ✔ Mean frame rate per second (FPS) of received screencasts
Screencast Receive Packet Loss Mean ✔ ✔ ✔ Mean packet loss, as a percentage, for received screencasts
Screencast Receive Long Side Median ✔ ✔ ✔ Long side of the received screencasts, in pixels, used most
Screencast Receive Short Side Median ✔ ✔ ✔ Median of the short side of the received screencasts, in pixels
Screencast Send Duration ✔ ✔ ✔ Length of time that the participant sent a screencast, in seconds
Screencast Send Bitrate Mean in kbps ✔ ✔ ✔ Mean bitrate of sent screencasts, in kilobits per second
Screencast Send Packet Loss Mean ✔ ✔ ✔ Mean packet loss, as a percentage, for sent screencasts
Screencast Send Packet Loss Max ✔ ✔ ✔ Maximum packet loss, as a percentage, for sent screencasts
Screencast Send FPS Mean ✔ ✔ ✔ Mean frame rate per second (FPS) of sent screencasts
Screencast Send Long Side Median ✔ ✔ ✔ Median long side resolution of the sent screencasts, in pixels
Screencast Send Short Side Median ✔ ✔ ✔ Median of the short side of the sent screencasts, in pixels

Step 3: Customize and export your audit log data

Filter the audit log data by user or activity

You can customize your audit log to show specific events or users. 

  1. Open your Hangouts Meet audit log.
  2. Click + Add Filter.
  3. Enter or select the criteria for your filter. You can filter on any combination of the data you can view in the log.
  4. (Optional) Click Date range, select a period from the list, or enter a start and end date, and time.
  5. Click Apply.

Filter by organizational unit

You can filter by organizational unit to compare statistics between child organizations in a domain.

  1. Open your audit log as shown above.
  2. At the top, click Organization filter, search for a name or select an organizational unit from the list.
  3. (Optional) Click Date range, select a period from the list, or enter a start and end date, and time.

    Note: You can filter by any event at + Add a filter , and then filter the results by Organization filter or Date range.

  4. Click Apply.

You can only filter the current organization hierarchy, even when searching for older data.

Export your audit log data

You can export your audit log data to Google Sheets or download it to a CSV file.

  1. Open your audit log as shown above.
  2. (Optional) To change the data to include in your export, click Manage columns Manage columns, select or remove the columns that you want to export, and click Save.
  3. Click Download Download.
  4. Under Select columns, click Currently selected columns or All columns.
  5. Under Select format, click Google Sheets or Comma-separated values (.csv).
  6. Click Download.

You can export up to 210,000 cells. The maximum number of rows depends on the number of columns you select. Audit logs to Sheets are limited to 10,000 rows, while CSV exports can include up to 500,000 rows.

Tip: For large exports, use BigQuery or the Reports API.

Export your audit log to BigQuery

To export logs and usage reports to BigQuery, see Set up BigQuery logs in the Admin console.

How old is the data I'm seeing?

For details on exactly when data becomes available and how long it's retained, see Data retention and lag times.

Was this helpful?
How can we improve it?