How to investigate private application access requiring Microsoft Entra Private Access connector
In brief
The documentation now requires a non-trial Microsoft Entra P1 or P2 license plus at least 100 monthly active users to view alerts and receive notifications. It also clarifies Private Access licensing, least-privilege roles, Graph permissions, and expanded signal and alert investigation guidance.
What Entra admins need to know
Administrators should verify licensing and access assignments before configuring or investigating Private Access health alerts.
This editorial summary was generated by AI from the documentation changes. Verify important details in the full Microsoft Learn article.
Documentation change
The comparison below shows only the changed extract. Use the full-page view for complete context.
How to use Microsoft Entra health monitoring signals and alertsHow to investigate Microsoft Entra health monitoring signals and alerts
This article describes the health metrics related to private application access requiring Microsoft Entra Private Access connector and how to troubleshoot a potential issue when you receive an alert.
Prerequisites
There are different roles, permissions, and license requirements to view health monitoring signals and configure and receive alerts. We recommend using a role with least privilege access to align with the Zero Trust guidance.
A tenant with a Microsoft Entra P1 or P2 license is required to view the Microsoft Entra health scenario monitoring signals.
A tenant with both a non-trial Microsoft Entra P1 or P2 license and at least 100 monthly active users is required to view alerts and receive alert notifications.
A tenant with a Microsoft Entra
InternetPrivate Access license is required. For details, see the licensing section of What is Global Secure Access?.The Reports Reader role is the least privileged role required to view scenario monitoring
signals.signals, alerts, and alert configurations.The Helpdesk Administrator is the least privileged role required to update alerts and update alert notification configurations.
The
HealthMonitoringAlert.Read.Allpermission is required to view the alerts using the Microsoft Graph API.The
HealthMonitoringAlert.ReadWrite.Allpermission is required to view and modify the alerts using the Microsoft Graph API.For a full list of roles, see
Least privileged role by taskLeast privileged role by task.The Global Secure Access Log Reader role
of viewing the traffic logs in Microsoft Entra Internet Access andis required to view Microsoft Entra PrivateAccess.Access traffic logs.
Investigate the signalssignal and alert
To investigate a signal, gatherStart your investigation by comparing the following data:alert timeframe, signal trend, and affected entities. Then correlate the affected users and applications with connector status and logs.
View the details of the alert.
- In the Microsoft Entra admin center, review the
metricssignal graph, alert timeframe, anddetails of theaffected entities. For more information, seeInvestigate the alert and signalsInvestigate the signals and alerts.
- For Microsoft Graph guidance, see Microsoft Graph health monitoring overview.
- In the Microsoft Entra admin center, review the
Sign
intoin to the Microsoft Entra admin center as at least aReports ReaderReports Reader.Browse to Entra ID > Monitoring & health > Health. The page opens to the Service Level Agreement (SLA) Attainment page.
Select the Health Monitoring tab.
Select the Private application access requiring Microsoft Entra Private Access connector
scenario.scenario, and then select an active alert.Review your Microsoft Entra Private Access connector status. Confirm that the connector and updater services are running. For more information, see Microsoft Entra private network connector maintenance.
Review
Microsoft Entra Private Accessthe connector groups andits assignmentstheir application assignments. Confirm that each affected application is assigned tothe applications.a group with healthy connectors. For more information, see Microsoft Entra private network connector groups.Review
sign-in logs.the sign-in logs
. Look for affected users
beingwho are blocked from signing in to the application.
Review the Global Secure Access traffic logs. Filter the logs to the alert timeframe and affected user or application, and look for private application transaction failures.
Review
trafficthe Global Secure Access audit logs for recent connector group or application assignment changes.:::image type="content" source="media/howto-investigate-private-access-connector-signals/global-secure-access-audit-logs.png" alt-text="Screenshot of audit logs filtered to the Global Secure Access service." lightbox="media/howto-investigate-private-access-connector-signals/global-secure-access-audit-logs.png":::
:::image type="content" source="media/howto-investigate-private-access-connector-signals/private-access-alert.png" alt-text="Screenshot of the Private application access requiring Microsoft Entra Private Access connector scenario with one active alert." lightbox="media/howto-investigate-private-access-connector-signals/private-access-alert.png":::
Understand the signal
An alert can indicate a change in the number of users or private applications that fail to connect because a connector isn't available.
Global Secure Access network traffic logs - Global Secure Access | Microsoft LearnA spike can indicate that one or more connectors became unavailable, a connector group lost capacity, or an application was assigned to the wrong connector group.Look for privateA dip can indicate that connector availability recovered. It can also indicate that traffic or applicationtraffic transaction failures.assignments changed.
Compare the alert start time with connector status, connector event logs, audit logs, and planned maintenance before you change the configuration.
Mitigate common issues
The following common issues can cause this alert. This list isn't exhaustive, but it provides a starting point for your investigation.
A connector is inactive or unavailable
A connector service might be stopped, its trust certificate might be expired, or the connector host might be unable to reach the Microsoft Entra service.
To investigate and mitigate the issue:
- In the alert, identify the affected users and private applications and note the alert start time.
Browse to Global Secure Access > Connect > Connectors, and identify inactive connectors in the connector group that serves the affected applications.
- On each affected connector server, confirm that the connector and updater services are running.
- Run the Connector Diagnostics tool to check certificate validity, ports 80 and 443, outbound proxy configuration, certificate revocation list access, service state, and back-end endpoint access.
- Review
audit logs.- the connector Admin event log for service, trust certificate, registration, or connectivity errors.
How to access Global Secure Access audit logs (preview) - Global Secure Access | Microsoft LearnRestore the connector service or connectivity. If the trust certificate expired, reregister or reinstall the connector by following Troubleshoot private network connectors.- Confirm that the connector becomes active and that new traffic log entries no longer show connector-related transaction failures.
An application is assigned to the wrong connector group
The assigned connector group might not contain a healthy connector that can reach the affected application's network.
To investigate and mitigate the issue:
- In the alert, identify whether failures are concentrated on one or more applications.
- Review each affected application's connector group assignment.
- Confirm that the assigned group contains active connectors in a network that can reach the application's destination.
- Review the audit logs for a connector group or application assignment change near the alert start time.
- Restore the intended assignment, or add healthy connectors that can reach the application to the assigned group.
- Test access and confirm recovery in the traffic logs and health signal.
A connector group has insufficient capacity or resilience
A connector group with a single connector, sustained high utilization, or poor connectivity to the service or back-end applications can cause intermittent failures.
To investigate and mitigate the issue:
- Check whether the connector group has at least two active connectors for high availability.
- Review connector host CPU and network utilization. Keep sustained CPU and memory utilization below the documented thresholds.
- From each connector server, test connectivity to the affected back-end application.
- If a connector host is unavailable, remove it from active service and add a healthy or backup connector to the group.
- If utilization is sustained, add connectors or increase host capacity. For sizing and performance guidance, see Microsoft Entra private network connectors.
- Confirm that failures stop and the signal returns to its expected range.
Related content
@@ -2,8 +2,9 @@ title: How to investigate private application access requiring Microsoft Entra Private Access connector description: Learn how to monitor and troubleshoot private application access scenarios that require the Microsoft Entra Private Access connector, using Microsoft Entra Health monitoring tools. ms.topic: how-to-ms.date: 11/18/2025+ms.date: 09/14/2026 ms.reviewer: gauthamca+ai-usage: ai-assisted # Customer intent: As an IT admin, I want to learn how to monitor and troubleshoot private application access scenarios that require the Microsoft Entra Private Access connector, using Microsoft Entra Health monitoring tools. ---@@ -16,7 +17,7 @@ To learn more about how Microsoft Entra Health works, see: - [What is Microsoft Entra Health?](/entra/identity/monitoring-health/concept-microsoft-entra-health) -- [How to use Microsoft Entra health monitoring signals and alerts](/entra/identity/monitoring-health/howto-use-health-scenario-alerts)+- [How to investigate Microsoft Entra health monitoring signals and alerts](/entra/identity/monitoring-health/howto-investigate-health-scenario-alerts) This article describes the health metrics related to private application access requiring Microsoft Entra Private Access connector and how to troubleshoot a potential issue when you receive an alert. @@ -32,63 +33,110 @@ This scenario: ## Prerequisites -There are different roles, permissions, and license requirements to view health monitoring signals and configure and receive alerts. We recommend using a role with least privilege access to align with the [Zero Trust guidance](/security/zero-trust/zero-trust-overview).+There are different roles, permissions, and license requirements to view health monitoring signals and configure and receive alerts. We recommend using a role with least privilege access to align with the [Zero Trust guidance](/security/zero-trust/zero-trust-overview). -- A tenant with a [Microsoft Entra P1 or P2 license](/entra/fundamentals/get-started-premium) is required to *view* the Microsoft Entra health scenario monitoring signals.+- A tenant with a [Microsoft Entra P1 or P2 license](/entra/fundamentals/get-started-premium) is required to *view* the Microsoft Entra health scenario monitoring signals.+- A tenant with both a non-trial [Microsoft Entra P1 or P2 license](/entra/fundamentals/get-started-premium) *and* at least 100 monthly active users is required to *view alerts* and *receive alert notifications*. -- A tenant with Microsoft Entra Internet Access license is required. For details, see the licensing section of [What is Global Secure Access?](/entra/global-secure-access/overview-what-is-global-secure-access).+- A tenant with a Microsoft Entra Private Access license is required. For details, see the licensing section of [What is Global Secure Access?](/entra/global-secure-access/overview-what-is-global-secure-access). -- The [Reports Reader](/entra/identity/role-based-access-control/permissions-reference#reports-reader) role is the least privileged role required to *view scenario monitoring signals.*+- The [Reports Reader](/entra/identity/role-based-access-control/permissions-reference#reports-reader) role is the least privileged role required to *view scenario monitoring signals, alerts, and alert configurations*. -- The HealthMonitoringAlert.Read.All permission is required to *view the alerts using the Microsoft Graph API*.+- The [Helpdesk Administrator](/entra/identity/role-based-access-control/permissions-reference#helpdesk-administrator) is the least privileged role required to *update alerts* and *update alert notification configurations*. -- For a full list of roles, see [Least privileged role by task](/entra/identity/role-based-access-control/delegate-by-task#monitoring-and-health---audit-and-sign-in-logs).+- The `HealthMonitoringAlert.Read.All` permission is required to *view the alerts using the Microsoft Graph API*.+- The `HealthMonitoringAlert.ReadWrite.All` permission is required to *view and modify the alerts using the Microsoft Graph API*. -- The [Global Secure Access Log Reader](/entra/identity/role-based-access-control/permissions-reference#global-secure-access-log-reader) role of viewing the traffic logs in Microsoft Entra Internet Access and Microsoft Entra Private Access.+- For a full list of roles, see [Least privileged role by task](/entra/identity/role-based-access-control/delegate-by-task#microsoft-entra-health-least-privileged-roles). -## Investigate the signals+- The [Global Secure Access Log Reader](/entra/identity/role-based-access-control/permissions-reference#global-secure-access-log-reader) role is required to view Microsoft Entra Private Access traffic logs. -To investigate a signal, gather the following data:+## Investigate the signal and alert -1. View the details of the alert.+Start your investigation by comparing the alert timeframe, signal trend, and affected entities. Then correlate the affected users and applications with connector status and logs. - - In the Microsoft Entra admin center, review the metrics and details of the affected entities. For more information, see [Investigate the alert and signals](/entra/identity/monitoring-health/howto-use-health-scenario-alerts#investigate-the-alert-and-signals).+1. View the details of the alert. - <!-- -->+ - In the Microsoft Entra admin center, review the signal graph, alert timeframe, and affected entities. For more information, see [Investigate the signals and alerts](howto-investigate-health-scenario-alerts.md#investigate-the-signals-and-alerts).+ - For Microsoft Graph guidance, see [Microsoft Graph health monitoring overview](/graph/api/resources/healthmonitoring-overview?view=graph-rest-beta&preserve-view=true). - - For Microsoft Graph guidance, see [Microsoft Graph health monitoring overview](/graph/api/resources/healthmonitoring-overview?view=graph-rest-beta&preserve-view=true).+1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com/) as at least a [Reports Reader](/entra/identity/role-based-access-control/permissions-reference#reports-reader). -2. Sign into the [Microsoft Entra admin center](https://entra.microsoft.com/) as at least a [Reports Reader](https://github.com/MicrosoftDocs/entra-docs/blob/c5d27bbda734933549480ccf46deffbeeed01bc7/docs/identity/role-based-access-control/permissions-reference.md#reports-reader).+1. Browse to **Entra ID** > **Monitoring & health** > **Health**. The page opens to the Service Level Agreement (SLA) Attainment page. - - Browse to **Entra ID** \> **Monitoring & health** \> **Health**. The page opens to the Service Level Agreement (SLA) Attainment page.+1. Select the **Health Monitoring** tab. - - Select the **Health Monitoring** tab.+1. Select the **Private application access requiring Microsoft Entra Private Access connector** scenario, and then select an active alert. - - Select the **Private application access requiring Microsoft Entra Private Access connector** scenario.+ :::image type="content" source="media/howto-investigate-private-access-connector-signals/private-access-alert.png" alt-text="Screenshot of the Private application access requiring Microsoft Entra Private Access connector scenario with one active alert." lightbox="media/howto-investigate-private-access-connector-signals/private-access-alert.png"::: -3. Review your Microsoft Entra Private Access connector status.- - See [Microsoft Entra private network connectors maintenance](/entra/global-secure-access/concept-connectors#maintenance)+1. Review your Microsoft Entra Private Access connector status. Confirm that the connector and updater services are running. For more information, see [Microsoft Entra private network connector maintenance](/entra/global-secure-access/concept-connectors#maintenance). -4. Review Microsoft Entra Private Access connector groups and its assignments to the applications.+1. Review the connector groups and their application assignments. Confirm that each affected application is assigned to a group with healthy connectors. For more information, see [Microsoft Entra private network connector groups](/entra/global-secure-access/concept-connector-groups). - - [Microsoft Entra Private Network Connector Groups - Global Secure Access \| Microsoft Learn](/entra/global-secure-access/concept-connector-groups)+1. Review the [sign-in logs](/entra/identity/monitoring-health/concept-sign-in-log-activity-details). Look for affected users who are blocked from signing in to the application. -5. Review sign-in logs.+1. Review the [Global Secure Access traffic logs](/entra/global-secure-access/how-to-view-traffic-logs). Filter the logs to the alert timeframe and affected user or application, and look for private application transaction failures. - - [Learn about the sign-in log activity details](/entra/identity/monitoring-health/concept-sign-in-log-activity-details)+1. Review the [Global Secure Access audit logs](/entra/global-secure-access/how-to-access-audit-logs) for recent connector group or application assignment changes. - - Look for users being blocked from signing in to the application.+ :::image type="content" source="media/howto-investigate-private-access-connector-signals/global-secure-access-audit-logs.png" alt-text="Screenshot of audit logs filtered to the Global Secure Access service." lightbox="media/howto-investigate-private-access-connector-signals/global-secure-access-audit-logs.png"::: -6. Review traffic logs.+## Understand the signal - - [Global Secure Access network traffic logs - Global Secure Access \| Microsoft Learn](/entra/global-secure-access/how-to-view-traffic-logs)+An alert can indicate a change in the number of users or private applications that fail to connect because a connector isn't available. - - Look for private application traffic transaction failures.+- A spike can indicate that one or more connectors became unavailable, a connector group lost capacity, or an application was assigned to the wrong connector group.+- A dip can indicate that connector availability recovered. It can also indicate that traffic or application assignments changed. -7. Review audit logs.+Compare the alert start time with connector status, connector event logs, audit logs, and planned maintenance before you change the configuration. - - [How to access Global Secure Access audit logs (preview) - Global Secure Access \| Microsoft Learn](/entra/global-secure-access/how-to-access-audit-logs)+## Mitigate common issues -Related content+The following common issues can cause this alert. This list isn't exhaustive, but it provides a starting point for your investigation. -- [Troubleshoot problems installing the Microsoft Entra private network connector - Global Secure Access \| Microsoft Learn](/entra/global-secure-access/troubleshoot-connectors)+### A connector is inactive or unavailable++A connector service might be stopped, its trust certificate might be expired, or the connector host might be unable to reach the Microsoft Entra service.++To investigate and mitigate the issue:++1. In the alert, identify the affected users and private applications and note the alert start time.+1. Browse to **Global Secure Access** > **Connect** > **Connectors**, and identify inactive connectors in the connector group that serves the affected applications.+1. On each affected connector server, confirm that the connector and updater services are running.+1. Run the Connector Diagnostics tool to check certificate validity, ports 80 and 443, outbound proxy configuration, certificate revocation list access, service state, and back-end endpoint access.+1. Review the connector **Admin** event log for service, trust certificate, registration, or connectivity errors.+1. Restore the connector service or connectivity. If the trust certificate expired, reregister or reinstall the connector by following [Troubleshoot private network connectors](/entra/global-secure-access/troubleshoot-connectors).+1. Confirm that the connector becomes active and that new traffic log entries no longer show connector-related transaction failures.++### An application is assigned to the wrong connector group++The assigned connector group might not contain a healthy connector that can reach the affected application's network.++To investigate and mitigate the issue:++1. In the alert, identify whether failures are concentrated on one or more applications.+1. Review each affected application's connector group assignment.+1. Confirm that the assigned group contains active connectors in a network that can reach the application's destination.+1. Review the audit logs for a connector group or application assignment change near the alert start time.+1. Restore the intended assignment, or add healthy connectors that can reach the application to the assigned group.+1. Test access and confirm recovery in the traffic logs and health signal.++### A connector group has insufficient capacity or resilience++A connector group with a single connector, sustained high utilization, or poor connectivity to the service or back-end applications can cause intermittent failures.++To investigate and mitigate the issue:++1. Check whether the connector group has at least two active connectors for high availability.+1. Review connector host CPU and network utilization. Keep sustained CPU and memory utilization below the documented thresholds.+1. From each connector server, test connectivity to the affected back-end application.+1. If a connector host is unavailable, remove it from active service and add a healthy or backup connector to the group.+1. If utilization is sustained, add connectors or increase host capacity. For sizing and performance guidance, see [Microsoft Entra private network connectors](/entra/global-secure-access/concept-connectors#performance-and-scalability).+1. Confirm that failures stop and the signal returns to its expected range.++## Related content++- [Troubleshoot private network connectors](/entra/global-secure-access/troubleshoot-connectors)+- [Microsoft Entra private network connectors](/entra/global-secure-access/concept-connectors)+- [Microsoft Entra private network connector groups](/entra/global-secure-access/concept-connector-groups) 