IT CanvassTalk to an advisor
Troubleshooting · LessonBy , SailPoint Architect · Published · IdentityIQ 8.4 · intermediate

Troubleshooting hub

Diagnose the common IdentityIQ failures: aggregation errors, provisioning failures, orphan accounts and stuck workflows.

Quick answer

Most IdentityIQ issues fall into a few buckets: connection and IQService failures, correlation gaps producing orphans, provisioning errors from bad plans or target rules, and workflows stuck on approvals. Read the task result, then the application and workflow logs, and work from the error, not a guess.

Key takeaways
  • Start from the task result and logs, not guesses
  • Connection/IQService issues stop aggregation and provisioning
  • Correlation gaps create orphan accounts
  • Provisioning fails on bad plans or target constraints
  • Stuck workflows are usually pending approvals

The troubleshooting module is where enterprise search traffic and real operational value meet: it documents the specific failures teams actually hit in production, provisioning failures, connector timeouts, aggregation and refresh errors, stuck workflows, failed tasks and certifications, and performance problems, with methodical diagnosis and fixes.

What this module covers

Each page follows the same discipline: read the evidence (task or transaction result), work through the likely causes in order, apply the fix, and prevent recurrence. This reflects how experienced practitioners actually debug SailPoint.

What you will find here

  • Provisioning failed and connector timeout.
  • Aggregation failed and identity refresh failed.
  • Workflow stuck, task failed, certification failed.
  • Performance issues.

How to use it

When something breaks, go to the page for that symptom, start with the evidence it points you to, and work down the ordered list of causes rather than guessing. Fix the root cause, not just the symptom.

Common pitfalls

  • Guessing instead of reading the task/transaction result.
  • Fixing symptoms rather than root causes.
  • Changing several things at once so you cannot tell what worked.

Practice challenge

+0 XPStreak ×0
Question 1 of 3
The first place to look for a failure is the?

Frequently asked questions

What does the term troubleshooting refer to in SailPoint?
The troubleshooting module is where enterprise search traffic and real operational value meet: it documents the specific failures teams actually hit in production, provisioning failures, connector timeouts, aggregation and refresh errors, stuck workflows, failed tasks and certifications, and performance problems, with methodical diagnosis and fixes.
What is the practical takeaway on troubleshooting?
When something breaks, go to the page for that symptom, start with the evidence it points you to, and work down the ordered list of causes rather than guessing.
What tends to go wrong with troubleshooting?
Guessing instead of reading the task/transaction result. Fixing symptoms rather than root causes. Changing several things at once so you cannot tell what worked.
Want this with a live instructor and a lab tenant?
SailPoint Architect training →
Already working on SailPoint and stuck on a live ticket?Get an expert SailPoint developer on screen-share to finish your daily tasks with you. Deliver on time, protect your reputation and your job. Monthly support only, no task-wise plans.Task assigned · no idea where to startStill stuck · your job on the lineExpert joins your screenDelivered on timeExplore On Job Support