Microsoft Entra Agent ID
Authentication

Investigate Agent ID interactive sign-ins

In brief

A new how-to explains how to interpret Health Monitoring signals, correlate agent properties with sign-in and audit logs, and mitigate common failures. It also identifies the relevant non-interactive sign-in logs and documents licensing and role prerequisites.

What Entra admins need to know

Administrators can use the guidance to investigate affected agents and applications more accurately. No action is required.

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.

new file mode 100644

title: Investigate Agent ID interactive sign-ins description: Learn how to investigate Microsoft Entra Health Monitoring signals and alerts for Agent ID interactive sign-ins, correlate agent activity, and mitigate sign-in failures. ms.topic: how-to ms.date: 10/08/2026 ai-usage: ai-assisted

Customer intent: As an IT admin, I want to investigate agent sign-in health alerts and identify affected applications and users so that I can restore agent access without weakening security controls.


How to investigate Agent ID interactive sign-ins

Microsoft Entra Health Monitoring provides tenant-level health signals and alerts when it detects a significant change in your tenant's activity. The Agent ID interactive sign-ins scenario helps you investigate failures in agent sign-ins with user-delegated context.

This article explains how to interpret the scenario, correlate an alert with sign-in and audit logs, and mitigate common issues. For the shared investigation workflow, see Investigate Microsoft Entra Health monitoring alerts.

Understand what interactive means

In Health Monitoring, interactive describes the agent's user-delegated context. It doesn't mean that a human enters a password or completes an MFA prompt for every agent token request. An interactive agent can act on behalf of a human user with delegated permissions to access resources for that user. For that authentication flow, see Authenticate users and acquire tokens for interactive agents.

To investigate this health scenario, distinguish the calling identity from the token subject. The agent sign-in properties provide both dimensions:

PropertyQuestion it answersHow to use it
agent.agentTypeWho signed in?Identify the calling identity, such as an agent identity instance (agenticAppInstance).
agent.agentSubjectTypeOn whose behalf was the token requested?Identify the token subject. The interactive health scenario selects agentIDuser subjects.
agent.agentSubjectParentIdWhich parent identity is associated with the subject?Correlate an agent's user account with its parent identity when this value is available.
agent.parentAppIdWhich parent application is associated with the calling agent?Correlate the calling agent with its blueprint when this value is available.

Agent ID autonomous sign-ins is a separate health scenario for agents signing in and acting as themselves, rather than with the user-delegated context monitored here. Agent identities and designated service principals can represent these agents. For the application-permission flow, see Authenticate and acquire tokens for autonomous agents.

Health scenarios aren't sign-in log categories

The four sign-in log types describe how authentication occurs:

Sign-in log typeAuthentication activity
Interactive user sign-inA user provides an authentication factor, such as a password or an MFA response.
Non-interactive user sign-inAn application or operating system component authenticates on behalf of a user without prompting them.
Service principal sign-inAn application identity authenticates.
Managed identity sign-inA managed identity authenticates.

Agent activity can appear across these log types. In particular, the Agent ID interactive sign-ins health scenario uses agent-user activity in the User sign-ins (non-interactive) logs. Filtering only User sign-ins (interactive) or isInteractive = true can miss the failures relevant to this scenario. For more information, see Microsoft Entra Agent ID logs.

Prerequisites

Use the least privileged role for each investigation task. Viewing an alert doesn't grant permission to change an agent's credentials, consent, or Conditional Access policies.

  • A tenant with a Microsoft Entra P1 or P2 license is required to view health scenario signals.
  • A tenant with 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.
  • Reports Reader is the least privileged role to view health signals, alerts, alert configurations, and sign-in logs.
  • Helpdesk Administrator is the least privileged role to update alerts and alert notification configurations.
  • For Microsoft Graph, use HealthMonitoringAlert.Read.All to read alerts, or HealthMonitoringAlert.ReadWrite.All to read and update them. These permissions don't grant access to sign-in logs.
  • Use AuditLog.Read.All to read sign-in logs with Microsoft Graph. Reading applied Conditional Access policies requires additional permissions and a supported role. See List signIns permissions.

For the complete health role requirements, see Microsoft Entra Health least privileged roles.

Investigate the signals and alert

Start with the alert's timeframe and affected entities, then use the logs to determine whether a configuration change or token acquisition problem caused the failures.

  1. Sign in to the Microsoft Entra admin center as at least a Reports Reader.

  2. Browse to Entra ID > Monitoring & health > Health, and select Health Monitoring.

  3. Select Agent ID interactive sign-ins. If the scenario isn't listed among active alerts, select All scenarios to view its signals.

    :::image type="content" source="media/scenario-health-agent-id-interactive-sign-ins/agent-id-interactive-alert-summary.png" alt-text="Screenshot of Health Monitoring with the Agent ID interactive sign-ins scenario highlighted." lightbox="media/scenario-health-agent-id-interactive-sign-ins/agent-id-interactive-alert-summary.png":::

  4. Review the Agent ID interactive sign-ins completion volume and Agent ID interactive sign-ins failure volume graphs. Compare the change with the agent's expected usage and recent deployments.

  5. From the scenario overview, select an active Large increase in Agent ID interactive sign-in failures alert. Record the anomaly timeframe and review the Signals and Affected entities sections.

    :::image type="content" source="media/scenario-health-agent-id-interactive-sign-ins/agent-id-interactive-alert-overview.png" alt-text="Screenshot of the Agent ID interactive sign-ins scenario overview showing completion and failure signals and an active failure alert." lightbox="media/scenario-health-agent-id-interactive-sign-ins/agent-id-interactive-alert-overview.png":::

  6. Under Affected entities, select View for applications and users. Use those identities to narrow your log investigation. The lists are samples of affected entities, not a list of every failed request.

  7. Browse to Entra ID > Agents, and select Sign-in logs in the Agents blade. Select User sign-ins (non-interactive), set the date range to the anomaly timeframe, and filter Status to Failure.

    :::image type="content" source="media/scenario-health-agent-id-interactive-sign-ins/agent-id-sign-in-failures.png" alt-text="Screenshot of sign-in logs opened from Agents, with Entra ID and Agents highlighted, the non-interactive user sign-ins tab selected, and Status set to Failure." lightbox="media/scenario-health-agent-id-interactive-sign-ins/agent-id-sign-in-failures.png":::

  8. Correlate the affected application and user with individual events. Review the agent details described in Microsoft Entra Agent ID logs. If a calling-identity filter excludes the events, inspect the agentSubjectType through Microsoft Graph instead of assuming there are no matching failures.

  9. Open a failed event and review its error code, failure reason, application, resource, and Conditional Access result. Record the request ID, correlation ID, and timestamp if you need to escalate the issue. See Sign-in log activity details.

  10. Review the audit logs for changes to the agent identity, blueprint, agent's user account, delegated permission grants, and relevant policies shortly before the failures started.

An increase in failure volume isn't, by itself, proof of an outage or an attack. Compare the failure and completion trends with rollout activity, and confirm the cause in individual sign-in events before changing access.

Correlate the alert with Microsoft Graph

Use the health monitoring API to retrieve the selected alert and its enrichment. Review the impact summary and any supporting queries supplied with the alert. Replace {alertId} with the selected alert's ID. The expansion retrieves a sample of affected resources, which isn't returned by default. See Get a health monitoring alert.

GET https://graph.microsoft.com/beta/reports/healthMonitoring/alerts/{alertId}?$expand=enrichment/impacts/microsoft.graph.healthmonitoring.directoryobjectimpactsummary/resourceSampling
Prefer: include-unknown-enum-members

For aggregated non-interactive user activity, use getSummarizedNonInteractiveSignIns. The following request uses the documented application filter to narrow the results to an affected application. Replace {application-client-id} with the application's appId, not its service principal object ID.

GET https://graph.microsoft.com/beta/auditLogs/getSummarizedNonInteractiveSignIns(aggregationWindow='h1')?$filter=appId eq '{application-client-id}'
Prefer: include-unknown-enum-members

Include the Prefer header to receive agentIDuser from the evolvable enumeration. Follow any @odata.nextLink returned in the response. In the returned data, select rows where agent.agentSubjectType is agentIDuser and status.errorCode is nonzero. Review the appId, userPrincipalName, agent, and signInCount properties. Don't require agent.agentType to have one particular value when selecting the interactive scenario's subjects.

The summarizedSignIn resource aggregates events across multiple dimensions. Use signInCount to understand request volume; don't count response rows as individual sign-ins or unique affected users. Aggregation and log availability can differ from the health graphs, so don't expect the totals to match exactly.

For individual events, explicitly include the non-interactive event type and replace the example UTC timestamps with your investigation interval. Without an event-type filter, the List signIns API returns only interactive user sign-ins by default.

GET https://graph.microsoft.com/beta/auditLogs/signIns?$filter=createdDateTime ge 2026-10-05T10:00:00Z and createdDateTime lt 2026-10-05T11:00:00Z and signInEventTypes/any(t: t eq 'nonInteractiveUser')
Prefer: include-unknown-enum-members

In the returned events, correlate agent.agentSubjectType = agentIDuser with the affected application, user, and nonzero error code. Use the individual event's failure reason and additional details to choose a mitigation.

Mitigate common issues

Use the error code from a matching sign-in event, not only the alert title. The following examples are starting points, not an exhaustive list. Error meanings are defined in the Microsoft identity platform error reference.

Delegated permission consent is missing

AADSTS65001 indicates that the user or administrator hasn't consented to the application. Check the affected application, resource, and requested scopes. A permission granted to a different agent identity or for a different resource doesn't establish the intended access.

  1. Confirm the delegated permissions the agent needs and whether it uses explicit grants or permissions inherited from its blueprint.
  2. Ask an authorized administrator or the appropriate consenting user to grant only the required permissions, according to your tenant's consent policies.
  3. Retry the token request and confirm that new matching sign-in events succeed.

For configuration guidance, see Grant agent access to Microsoft 365 and Configure inheritable permissions for agent identity blueprints.

Token assertions are expired or invalid

AADSTS500133 indicates that an assertion isn't within its valid time range. AADSTS50013 indicates an invalid assertion and can have multiple causes, including an expired or malformed token. Don't assume that every assertion error has the same cause.

  1. Review the failure reason and identify the token exchange stage that failed.
  2. Ask the agent developer to check assertion validity, expiration, and audience, and acquire a fresh token through the appropriate flow instead of repeatedly submitting the same invalid assertion.
  3. For human-user OBO, verify that the incoming user token targets the agent identity blueprint, not the downstream resource. See On-behalf-of flow in agents.
  4. For an agent's user account, verify the parent identity and token chain against the agent's user account impersonation protocol. Don't instruct the agent's user account to sign in with a password; it doesn't support human-user credentials.

Conditional Access blocks token issuance

AADSTS53003 indicates that Conditional Access blocked token issuance. A block might be intentional, so don't disable a policy solely to reduce failure volume.

  1. Review the failed event's Conditional Access details, including the target resource and policy result.
  2. Compare the policy's intended scope with the affected identities. Review the audit logs for recent policy or assignment changes.
  3. If the block is intended, maintain the security control. If the scope is unintended, ask the policy owner to correct only the affected assignment or configuration.

See Troubleshoot Conditional Access sign-in problems and Investigate Conditional Access policy changes.

Blueprint credentials are invalid or expired

AADSTS7000215 indicates an invalid client secret. AADSTS7000222 indicates expired client secret keys. A failure in the blueprint's credential chain can prevent downstream token acquisition.

  1. Ask the agent developer to identify the credential and client ID used by the failing request. Verify that the request uses the expected tenant and blueprint.
  2. Correct the invalid credential or rotate an expired credential using the approved deployment process. Credentials belong on the blueprint, not on the agent identity or agent's user account.
  3. Validate a new token request before removing the old credential from the deployment.

For the credential model and supported authentication options, see Agent identity blueprints and Microsoft agent identity platform error codes.

Confirm recovery

After you correct the cause, confirm that new sign-in events for the affected application and subject succeed, and that failure volume returns toward its expected pattern. Account for processing delay before comparing new logs with the health graph.

Mark the alert as Dismissed only after you investigate it. Dismissing an alert doesn't fix the underlying sign-in problem. For alert status and notification guidance, see Investigate Microsoft Entra Health monitoring alerts and Configure health alert notifications.

Related content

Daily Entra.News

Get daily email updates

Get a concise summary of the latest Microsoft Entra updates delivered straight to your inbox.

Loading the secure signup form…