You can use the audit and investigation page to run searches related to SAML log events. There you can view a record of actions to track your users' successful and unsuccessful sign-ins to SAML applications. Entries usually appear within an hour of the user action.
For a full list of services and activities that you can investigate, such as Google Drive or user activity, read through the About the audit and investigation tool.
Forward log event data to Google Cloud
Supported editions for this feature: Enterprise Standard and Enterprise Plus; Education Standard and Education Plus, Voice Premier. Compare your edition
You can opt in to share the log event data with Google Cloud. If you turn on sharing, data is forwarded to Cloud Logging, where you can query and view your logs, and control how you route and store your logs.
Open the audit and investigation page
Access SAML log event data
-
Sign in to your Google Admin console.
Sign in using your administrator account (does not end in @gmail.com).
- On the left, click Reporting
Audit and investigation
SAML log events.
Filter the data
- Open the log events as described above in Access SAML log event data.
- Click Add a filter, and then select an attribute.
- In the pop-up window, select an operator
select a value
click Apply.
-
(Optional) To create multiple filters for your search:
- Click Add a filter and repeat step 3.
- (Optional) To add a search operator, above Add a filter, select AND or OR.
- Click Search.
Note: Using the Filter tab, you can include simple parameter and value pairs to filter the search results. You can also use the Condition builder tab, where the filters are represented as conditions with AND/OR operators.
Attribute descriptions
For this data source, you can use the following attributes when searching log event data:
Attribute | Description |
---|---|
Actor | Email address of the user who performed the action |
Actor group name |
Group name of the actor. For more information, see Filtering results by Google Group. To add a group to your filtering groups allowlist:
|
Actor organizational unit | Organizational unit of the actor |
Application name | The SAML application that initiated the event |
Date | The date and time the event occurred (displayed in your browser's default time zone) |
Event | Two types of events are logged: Successful and failed sign-in attempts |
Failure type | For failed sign-in attempts, a failure type is displayed. Go to Failure types and solutions below for details. |
Initiated by | The provider who initiated the event. Can be the identity provider or the service provider. |
IP address | The internet protocol (IP) address used by the user to sign in to the SAML application. This might reflect the user's physical location, but not necessarily. For example, it could instead be a proxy server or a virtual private network (VPN) address. |
Response second level status | Status information about the success or failure of the SAML request. For details on status codes, go to SAML v2.0 Core, Section 3.2.2.2. |
Response status | Status information about the success or failure of the SAML request. For details on status codes, go to SAML v2.0 Core, Section 3.2.2.2. |
Filter data by failure type
- Open the log events as described above in Access SAML log event data.
- Click Add a filter
Failure type.
- From the drop down list, select an option.
- Click Apply.
Failure types and solutions
The following failure types are recorded in the log events:
Manage log event data
Manage search results column data
You can control which data columns appear in your search results.
- At the top-right of the search results table, click Manage columns
.
- (Optional) To remove current columns, click Remove
.
- (Optional) To add columns, next to Add new column, click the Down arrow
and select the data column.
Repeat as needed. - (Optional) To change the order of the columns, drag the data column names.
- Click Save.
Export search result data
- At the top of the search results table, click Export all.
- Enter a name
click Export.
The export displays below the search results table under Export action results. - To view the data, click the name of your export.
The export opens in Google Sheets.
Create reporting rules
Go to Create and manage reporting rules.
When and how long is data available?
Go to Data retention and lag times.