Enable and use debug upgrade

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 1 minute to read

    • Enable Debug Upgrade to analyze post-upgrade issues that may require follow up, then disable it when finished with the upgrade debugging session.

    Before you begin

    Role required: admin

    Procedure

    1. Navigate to All > System Diagnostics > Session Debug.
    2. Select Debug Upgrade to enable the upgrade debugger.
    3. Process a transaction (for example, load a form).
    4. Click the Skipped During Last Upgrade, Customer Customized, or ServiceNow Modified During Last Upgrade header to view the appropriate list.
      Table 1. Upgrade Transaction List
      Field Description
      Name Name of record processed during the last upgrade session.
      Type Type of record processed during the upgrade.
      Business rule
      Server-side script that runs when a record is displayed, inserted, updated, or deleted, or when a table is queried. See Classic Business rules.
      Client script
      Client JavaScript run when client-based events occur. See Client scripts.
      Data policy
      Policies that enforce data consistency. See Data policy.
      Script include
      Script includes that store JavaScript run on the server. See Script includes.
      UI action
      Buttons, links, and context menu items on forms and lists. See UI actions.
      UI macro
      Discrete scripted components added to the user interface. See UI macros.
      UI page
      Pages used to create and display forms, dialogs, lists, and other UI components. See UI pages.
      UI policy
      Policies that change the behavior of information on a form and control custom process flows for tasks. See UI policies.
      Note:
      These are the only types of artifacts logged by the Upgrade Debugger.
      Last Modified Date and time the record was last modified.
    5. Click Show more to view all artifacts.
    6. Click the name of a listed artifact to view the underlying artifact record.
      For example, if you click a Script Include artifact, the underlying Script Include record appears.
    7. To turn off Debug Upgrade and all session debugging after completing your session:
      1. Navigate to System Diagnostics > Session Debug.
      2. Select Disable All to disable the upgrade debugger.