Troubleshooting
Scan Shows “Partial” Status
Section titled “Scan Shows “Partial” Status”Cause: One or more discovery providers encountered an error, but the scan continued with the remaining providers.
Resolution: Check the Error Summary field on the Scan Run record for details. Common causes:
- Insufficient API permissions (assign OrgGuard Admin permission set)
- Scan query timeout (retry the scan — transient issue)
- Governor limit approached (scan will chain automatically on next run)
No Assets Discovered
Section titled “No Assets Discovered”Possible causes:
- The OrgGuard Admin permission set is not assigned to the running user — go to Setup > Permission Sets > OrgGuard Admin > Manage Assignments
- The running user’s profile does not have “API Enabled” — contact your Salesforce administrator to enable the “API Enabled” profile permission
- The org genuinely has no auth assets of the types OrgGuard scans
Resolution: Run the Permissions Check (Step 2 of Setup Wizard) to verify access.
Notifications Not Received
Section titled “Notifications Not Received”Check:
- Email Deliverability — Setup > Email > Deliverability must be set to “All Email”
- Policy Notification Settings — Ensure Notify Asset Owner or Notify Admin Group is enabled on the policy
- Deduplication — The same finding won’t re-notify within the deduplication window
- Notification Records — Check the Notifications tab for “Failed” status with error details
- Spam Folder — Check the recipient’s spam/junk folder
Setup Wizard Not Appearing
Section titled “Setup Wizard Not Appearing”Cause: The wizard only appears automatically on first launch or if setup is incomplete.
Resolution: Check the OrgGuard_Setup__c custom setting:
- If
Is_Complete__cis true, the wizard won’t show again - To re-run the wizard, set
Is_Complete__cto false via Setup > Custom Settings > OrgGuard Setup > Manage
Dashboard Shows Stale Data
Section titled “Dashboard Shows Stale Data”Resolution: Click the Refresh button on the dashboard. Data auto-refreshes every 5 minutes. If counts seem wrong, trigger a new scan from Scan Run History.
Diagnostic Logging Shows No Logs
Section titled “Diagnostic Logging Shows No Logs”Who can do this: OrgGuard Admin only. If you don’t see the Diagnostics tab, ask your admin to assign OrgGuard Admin (see Permission Sets).
Cause: Persistent logging defaults to ERROR level. INFO/DEBUG messages are only captured when Support Mode or Debug Mode is active.
Resolution: Click Enable Support Mode from the Diagnostic Log Viewer, then reproduce the issue.
Still stuck? Email support@orgguard.com. If you have OrgGuard Admin access, attach a diagnostic bundle export — this helps us troubleshoot faster. If you have OrgGuard User or OrgGuard Auditor access, ask your Salesforce admin to export the bundle on your behalf.