Skip to main content
Skip table of contents

PowerSchool Diagnostics

Using the PowerSchool Diagnostics page, you can enable performance-profiling tools useful for diagnosing where processing time is spent in PowerSchool.

Set Up PowerSchool Diagnostics

  1. Navigate to the PowerSchool Diagnostics page. 
  2. Use the following table to enter information in the fields:

    Field

    Description

    PerfCapture enabled? (overrides below settings if off)

    Select the checkbox to enable the PerfCapture performance-profiling tool. If enabled, PerfCapture will increase the size of the PowerSchool log files, which places additional load on the system.

    Enabling this option will take immediate effect on this server. On other servers in the array, there may be some delay based on server activity.

    Output Transcript logs at level (lower increases impact)

    If enabled, PerfCapture will include transcript log information in the PowerSchool log files, which places further load (greatest impact on log file size) on the system.

    To enable, indicate the level detail you want included in the transcript logs by choosing one of the following

    • EntryPoint (least details)
    • Tier
    • Critical
    • Major
    • Minor (most details)

    To disable, select Off. This is the default setting.

    Output Aggregated logs at level (lower increases impact)

    If enabled, PerfCapture will include aggregated log information in the PowerSchool log files, which places further load (minimal impact on log file size) on the system.

    To enable, indicate the level detail you want included in the aggregated logs by choosing one of the following:

    • EntryPoint (least details)
    • Tier
    • Critical
    • Major
    • Minor (most details)

    To disable, select Off. This is the default setting.

    Output Aggregated logging every (minutes)

    If Output Aggregated logs at level is enabled, enter the frequency (lower impact on log file size) you want a PerfCapture message added to the aggregated logs.

    Thread dumps enabled?

    Select the checkbox to enable the thread dumps performance-profiling tool. If enabled, periodic thread dumps will be written to the folder <installation-base>/temp/powerschool/threaddumps. These thread dumps provide valuable data for PowerSchool software engineers. Thread dumps will place additional load on the system and consume disk space.

    Enabling this option will take immediate effect on this server. On other servers in the array, there may be some delay based on server activity.

    Disable PerfCapture logging and Thread Dumps at startup?

    If PerfCapture and/or Thread Dumps is enabled, select the checkbox to automatically suspend PerfCapture logging and thread dumps when restarting PowerSchool. If disabled, you can avoid unnecessary logging, which takes up space on the server.

  3. Click Submit
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.