How to use the Global Secure Access (preview) traffic logs
Monitoring the traffic for Global Secure Access (preview) is an important activity for ensuring your tenant is configured correctly and that your users are getting the best experience possible. The Global Secure Access traffic logs provide insight into who is accessing what resources, where they're accessing them from, and what action took place.
This article describes how to use the traffic logs for Global Secure Access.
How the traffic logs work
Viewing traffic logs requires a Reports Reader role in Microsoft Entra ID.
The Global Secure Access logs provide details of your network traffic. To better understand those details and how you can analyze those details to monitor your environment, it's helpful to look at the three levels of the logs and their relationship to each other.
A user accessing a website represents one session, and within that session there may be multiple connections, and within that connection there may be multiple transactions.
- Session: A session is identified by the first URL a user accesses. That session could then open many connections, for example a news site that contains multiple ads from several different sites.
- Connection: A connection includes the source and destination IP, source and destination port, and fully qualified domain name (FQDN). The connection components comprise the 5 tuple.
- Transaction: A transaction is a unique request and response pair.
Within each log instance, you can see the connection ID and transaction ID in the details. By using the filters, you can look at all connections and transactions for a single session.
How to view the traffic logs
- Sign in to the Microsoft Entra admin center as at least a Reports Reader.
- Global Secure Access (Preview) > Monitor > Traffic logs.
The top of the page displays a summary of all transactions as well as a breakdown for each type of traffic. Select the Microsoft 365 or Private access buttons to filter the logs to each traffic type.
At this time, Session ID information is not available in the log details.
View the log details
Select any log from the list to view the details. These details provide valuable information that can be used to filter the logs for specific details or to troubleshoot a scenario. The details can be added as a column and used to filter the logs.
Filter and column options
The traffic logs can provide many details, so to start only some columns are visible. Enable and disable the columns based on the analysis or troubleshooting tasks you're performing, as the logs could be difficult to view with too many columns selected. The column and filter options align with each item in the Activity details.
Select Columns from the top of the page to change the columns that are displayed.
To filter the traffic logs to a specific detail, select the Add filter button and then enter the detail you want to filter by.
For example if you want to look at all the logs from a specific connection:
Select the log detail and copy the
connectionIdfrom the Activity details.
Select Add filter and choose Connection ID.
In the field that appears, paste the
connectionIdand select Apply.
The following details may be helpful for troubleshooting and analysis:
- If you're interesting in the size of the traffic being sent and received, enable the Sent Bytes and Received Bytes columns. Select the column header to sort the logs by the size of the logs.
- If you are reviewing the network activity for a risky user, you can filter the results by user principal name and then review the sites they're accessing.
- To look at traffic associated with specific
The log details provide valuable information about your network traffic. Not all details are defined in the list below, but the following details are useful for troubleshooting and analysis:
- Transaction ID: Unique identifier representing the request/response pair.
- Connection ID: Unique identifier representing the connection that initiated the log.
- Device category: Device type where the transaction initiated from. Either client or remote network.
- Action: The action taken on the network session. Either Allowed or Denied.
Configure diagnostic settings to export logs
You can export the Global Secure Access traffic logs to an endpoint for further analysis and alerting. This integration is configured in Microsoft Entra diagnostic settings.
Browse to Identity > Monitoring & health > Diagnostic settings.
Select Add Diagnostic setting.
Give your diagnostic setting a name.
Select the Destination details for where you'd like to send the logs. Choose any or all of the following destinations. Additional fields appear, depending on your selection.
- Send to Log Analytics workspace: Select the appropriate details from the menus that appear.
- Archive to a storage account: Provide the number of days you'd like to retain the data in the Retention days boxes that appear next to the log categories. Select the appropriate details from the menus that appear.
- Stream to an event hub: Select the appropriate details from the menus that appear.
- Send to partner solution: Select the appropriate details from the menus that appear.
Your use of the Microsoft Entra Private Access and Microsoft Entra Internet Access preview experiences and features is governed by the preview online service terms and conditions of the agreement(s) under which you obtained the services. Previews may be subject to reduced or different security, compliance, and privacy commitments, as further explained in the Universal License Terms for Online Services and the Microsoft Products and Services Data Protection Addendum (“DPA”), and any other notices provided with the Preview.