Troubleshooting: Control 3.2 - Usage Analytics and Activity Monitoring

Last Updated: January 2026

Common Issues

Issue	Cause	Resolution
Missing usage data	Managed Environment not enabled or data latency	Enable Managed Environment; wait 24-48 hours for initial data
Alerts not triggering	Recipients not configured or email filtering	Verify alert is enabled; check notification settings
Incorrect success rates	Metric includes all session types	Filter by interaction type for customer-facing metrics
Audit log gaps	Log latency or search scope issues	Audit logs may take 24 hours; expand search date range
Dashboard timeout	Large data volume	Apply environment filters; reduce date range

Detailed Troubleshooting

Issue: Missing Usage Data on Dashboard

Symptoms: Dashboard shows no metrics or incomplete data for agents.

Diagnostic Steps:

Verify Managed Environment is enabled:

Get-AdminPowerAppEnvironment -EnvironmentName "env-id" |
    Select-Object DisplayName, @{N='IsManaged';E={$_.Properties.isManaged}}

Check data freshness - look for "Last Updated" timestamp on dashboard
Verify you have appropriate permissions to view the environment
Confirm agents have recent activity (no data if agents are inactive)

Resolution: - Enable Managed Environments for usage insights - Wait 24-48 hours for initial data population - Verify Power Platform Admin role assignment

Issue: Alerts Not Triggering

Symptoms: Conditions are met but no notifications are received.

Diagnostic Steps:

Navigate to PPAC > Monitor > Alerts
Verify the alert rule is in "Enabled" state
Check notification recipient configuration
Review the alert condition logic
Test email delivery:
Check spam/junk folders
Add PPAC sender to safe list
Verify email addresses are correct

Resolution: - Enable the alert rule if disabled - Configure valid notification recipients - Add noreply@microsoft.com to safe senders - Test with a simple alert that triggers easily

Issue: Incorrect Success Rates Reported

Symptoms: Reported success rates do not match observed agent behavior.

Diagnostic Steps:

Understand the metric calculation:
Success rate includes ALL session types
Failed handoffs count as failures
Abandoned sessions may affect rate
Review session definitions in documentation
Compare with Copilot Studio built-in analytics
Check for environment or agent filter issues

Resolution: - Filter by specific interaction types for accurate metrics - Use Copilot Studio analytics for agent-specific details - Document calculation methodology for auditors

Issue: Audit Log Gaps

Symptoms: Missing entries for specific time periods in audit logs.

Diagnostic Steps:

Check audit log ingestion latency:
Logs may take up to 24 hours to appear
Peak times may cause additional delays

Verify search parameters:

# Expand date range to verify data exists
Search-UnifiedAuditLog `
    -StartDate (Get-Date).AddDays(-7) `
    -EndDate (Get-Date) `
    -RecordType PowerApps `
    -ResultSize 100

Check RecordType filter is correct for your search
Verify your role has audit log search permissions

Resolution: - Wait 24-48 hours for recent events to appear - Expand search date range - Use correct RecordType (PowerApps, CopilotStudio) - Request Purview Compliance Admin role if needed

Issue: Performance Dashboard Timeout

Symptoms: Dashboard fails to load or times out when accessing metrics.

Diagnostic Steps:

Check the scope of your query:
Number of environments selected
Date range specified
Number of agents included
Try with a narrower scope:
Single environment
Shorter date range (7 days vs 30 days)
Check browser performance and network connectivity

Resolution: - Apply environment filters to reduce data volume - Reduce date range for initial load - Schedule reports instead of real-time queries - Use PowerShell for large data exports

Issue: Usage Insights Email Not Received

Symptoms: Weekly digest email not arriving despite configuration.

Diagnostic Steps:

Verify Managed Environment has usage insights enabled:
Navigate to Environment > Edit Managed Environment
Check "Include insights for this environment in the weekly email digest"
Verify recipient email addresses are correct
Check spam/junk email folders
Confirm the environment has activity to report

Resolution: - Enable usage insights in Managed Environment settings - Add correct recipient email addresses - Add Microsoft sender to safe list - Wait for next weekly digest cycle

How to Confirm Configuration is Active

Via Portal (PPAC)

Navigate to Monitor > Overview
Verify summary cards show current data
Check Alerts for enabled rules
Review Copilot Studio for agent metrics

Via Portal (Purview)

Navigate to Microsoft Purview > Audit
Search for recent Power Platform activities
Verify entries are appearing for current date

Via PowerShell

# Quick validation check
Write-Host "Checking Control 3.2 Configuration..." -ForegroundColor Cyan

# Check environment access
$envCount = (Get-AdminPowerAppEnvironment).Count
Write-Host "Accessible environments: $envCount"

# Check managed environments
$managedCount = (Get-AdminPowerAppEnvironment |
    Where-Object { $_.Properties.isManaged -eq $true }).Count
Write-Host "Managed environments: $managedCount"

# Check app visibility
$appCount = (Get-AdminPowerApp).Count
Write-Host "Visible Power Apps: $appCount"

# Check recent audit logs
try {
    $recentLogs = Search-UnifiedAuditLog `
        -StartDate (Get-Date).AddDays(-1) `
        -EndDate (Get-Date) `
        -RecordType PowerApps `
        -ResultSize 10
    Write-Host "Recent audit log entries: $($recentLogs.Count)"
} catch {
    Write-Host "Audit log access issue" -ForegroundColor Yellow
}

Escalation Path

If issues persist after troubleshooting:

Power Platform Admin Team - For PPAC access and monitoring configuration
Purview Admin Team - For audit log access and retention issues
Microsoft Support - For platform bugs or feature issues
AI Governance Lead - For policy and process questions
Compliance Officer - For regulatory implications of monitoring gaps

Back to Control 3.2 | Portal Walkthrough | PowerShell Setup | Verification Testing