Use Project Diagnostics to detect corrupt project data

  • Release version: Xanadu
  • Updated June 16, 2026
  • 1 minute to read
  • Project Diagnostics uses the Application Diagnostics Tool to detect corrupt data in a project, such as tasks with invalid parents, tasks without top tasks, and invalid or cyclic relations in a project.

    Before you begin

    Role required: it_pps_admin

    About this task

    Project Diagnostics can also detect whether date calculations in a project appear to be incorrect, the planning console does not open for a project, or a few tasks or relationships do not appear in the planning console.

    Procedure

    1. Determine whether you want to run a diagnostic scan on a single project or multiple projects.
      ScopeSteps
      All Projects

      Navigate to Project Administration > Project Diagnostics.

      Single Project
      1. Navigate to Project > Projects > All.
      2. Select the project.
      3. On the Project form, click the Project Diagnostics related link.
    2. On the Application Diagnostics Tool page, select a diagnostic feature.
    3. Use the Feature Inputs fields to specify filter conditions.
    4. From the Diagnostics section, run a single diagnostic scan or multiple scans on the projects matching the filter criteria.
      TaskSteps
      Run multiple diagnostic scans
      1. Select the diagnostic scans that you want to run on the filtered projects.
      2. Click Run Diagnostics at the top-right corner of the page.
      Run a specific diagnostic scan
      1. Select the single diagnostic scan that you want to run on the filtered projects.
      2. Click Run Diagnosis.
    5. View the results of the scans.

    What to do next

    Add your own diagnostic scans and fix scripts.