Add troubleshooting documentation for AI Credits Usage sync issues

[Copilot]

AI Credits Usage data in Power BI reports stops updating when the Admin | Sync Template v4 (AI Usage) flow is OFF or fails to run. Users had no documentation identifying which flow was responsible or how to resolve the issue.

Changes

Added troubleshooting documentation

• docs/TROUBLESHOOTING-AI-CREDITS-USAGE.md: Comprehensive guide identifying the AI Usage sync flow, its 1-day data retrieval limitation, and step-by-step resolution
• docs/README.md: Troubleshooting index for common CoE Starter Kit sync issues
• README.md: Added link to troubleshooting documentation

Key Technical Details Documented

• Flow: Admin | Sync Template v4 (AI Usage)
• Source: msdyn_aievents (per-environment) → Target: admin_aicreditsusages (CoE)
• Trigger: Dataverse webhook on admin_environment table changes
• Critical limitation: LastXDays(PropertyName='msdyn_processingdate',PropertyValue=1) filter retrieves only last 1 day of data

Impact: If flow is OFF for N days, N-1 days of historical data is permanently lost.

Changes

• Added docs/TROUBLESHOOTING-AI-CREDITS-USAGE.md - Diagnostic guide for AI Credits sync flow

  • Identifies Admin | Sync Template v4 (AI Usage) as responsible flow
  • Documents msdyn_aievents → admin_aicreditsusages sync pipeline
  • Explains LastXDays(1) filter limitation that causes data loss
  • 6-step troubleshooting procedure with manual trigger options

• Added docs/README.md - Troubleshooting index covering common sync flow failures across all CoE data types

• Updated main README.md with link to troubleshooting documentation

Key Technical Details

Flow: Admin | Sync Template v4 (AI Usage)
Limitation: Filter LastXDays(PropertyName='msdyn_processingdate',PropertyValue=1) retrieves only last 1 day of data
Impact: Flow OFF → permanent data loss for missed periods
Fix: Ensure flow stays ON, run Driver flow to backfill current data

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[CoE Starter Kit - QUESTION] AI Credits Usage not updated</issue_title>
<issue_description>### Does this question already exist in our backlog?

• I have checked and confirm this is a new question.

What is your question?

I have set up COE in August/Sep 2025. The AI credit usage data is showing from August 20205. It has not been updated after that. However I see the App usage and Flow usage data being synched regularly. I have attached the screen shots from Command center and AI credits usage.

.

Please help me fix this issue. I see this same issue that data not being updated in many other section of the Power Bi report.

What solution are you experiencing the issue with?

Audit Log

What solution version are you using?

4.50.6

What app or flow are you having the issue with?

No idea which flow is responsible for thsi data.

What method are you using to get inventory and telemetry?

Cloud flows</issue_description>

<agent_instructions>Analyze why AI credit usage data in the CoE (Audit Logs, v4.50.6) stopped updating after August 2025. Identify which flow is responsible for collecting AI usage (msdyn_aievents), determine why it is not running or updating, and provide the steps needed to fix the issue so that the Power BI report refreshes correctly.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@harini-2-y Hi @amarnathpoosala , Thanks for the details. Since you’re using CoE version 4.50.6, all usage and inventory data in the CoE Power BI report is populated through the CoE sync pipeline (Audit Logs + Sync Template v4 flows). If multiple sections of the report—including AI usage—stopped updating after August 2025, it indicates that the sync flows responsible for writing this data into Dataverse have not been running or have not received new data.

To fix the issue, please follow the steps below:

1. Check whether new data exists in Dataverse
   Please verify if the following Dataverse tables contain rows newer than August 2025:
   msdyn_aievents (AI usage)
   admin_auditlogs (audit data)
   admin_apps, admin_flows, admin_connectors, admin_environments (inventory data)
   If these tables contain no new rows, Power BI will not be able to show updated information until the sync flows successfully run again.

2. Ensure all required CoE sync flows are ON
   Go to:
   Power Automate → Solutions → Audit Logs / Core Components
   Make sure the following flows are turned ON:
   Audit Log Flows (affect AI usage, maker activity, audit data)
   Admin | Audit Logs | Office 365 Management API Subscription
   Admin | Audit Logs | Sync Audit Logs (V2)
   Admin | Audit Logs | Update Data (V2)
   Inventory Sync Flows (affect Apps, Flows, Connectors, Environments, etc.)
   All Admin | Sync Template v4 flows, including:
   Sync Template v4 (Apps)
   Sync Template v4 (Flows)
   Sync Template v4 (Connectors)
   Sync Template v4 (Environments)
   Sync Template v4 (PowerApps)
   If any of these flows were OFF for a period of time, the related sections of the report will stop updating.

3. Manually run the complete sync pipeline once
   From the same solution, manually run the flows:
   Audit Logs — run in this order
   Office 365 Management API Subscription
   Sync Audit Logs (V2)
   Update Data (V2)
   Inventory — run all Sync Template v4 flows once
   This will refresh all underlying Dataverse tables used by Power BI.

4. Refresh the Power BI report after new Dataverse rows appear
   Once Dataverse starts receiving updated data from the flows, refresh the Power BI report.
   All sections—including AI usage, app usage, flow usage, connector usage, environment data, and audit logs—will update automatically.</comment_new>

Custom agent used: CoE Custom Agent
Specialized agent for triaging and fixing issues in the CoE Starter Kit. Always consult the official CoE docs and the team’s SharePoint notes first, then mine prior GitHub issues and the CoE Common Responses playbook.

• Fixes [CoE Starter Kit - QUESTION] AI Credits Usage not updated #10690

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[harini-2-y]

@copilot ,
The user verified that:
admin_apps / admin_flows tables are updating
Other tables are NOT updating
msdyn_aievents (AI usage) has no new records after Aug‑2025
All CoE flows are ON and show Succeeded daily
Manual reruns do not change anything
Power BI also shows no AI usage after Aug‑2025

Please analyze why msdyn_aievents has no new records and provide the correct root cause and next steps:
Is this because no AI usage was logged by the platform after Aug‑2025, or
Is the CoE connection identity missing permissions to read AI Events in some environments?
Provide precise validation steps for the user to check ONE environment where AI Builder/Copilot usage definitely happened after Aug‑2025, and the exact fix for each scenario.
Do NOT repeat general troubleshooting. Provide a targeted diagnosis for this case only and what the user should do next.

[muditagarwal2308]

Approved

[harini-2-y]

Approved