Skip to main content

Downloading log files for troubleshooting

Suggest edit Updated on June 2, 2022

As a Pega Cloud client, you can download log files from the My Pega Cloud portal for internal analysis or to share with Pegasystems Global Client Support (GCS). Being able to download logs is an enhancement to the functionality of Pega Predictive Diagnostic Cloud, which offers you the self-service ability to review alerts and exceptions.

Before you begin:

To use the My Pega Cloud portal, have the following:

  • Cookies enabled in your browser settings.
  • Cloud-admin role or Cloud-change role access privileges. Contact your Pega Cloud administrator to secure those. For more information, see Support user roles.

From the My Pega Cloud tab, you can download a bundle of specified log files for up to seven full days of logs created from your environment during the last 365 days. Each download you complete using the My Pega Cloud portal supports up to seven days of logs; to download more additional logs, you must initiate a separate request for the additional day's logs.

Pega Cloud services supports downloading logs created up to one year ago
Pega Cloud services supports downloading up to seven consecutive days of logs
Download up to seven consecutive days of logs

The log bundle is a compressed TAR file you can download to your local computer.

Pega periodically performs standard maintenance on Pega Cloud systems to update your system to the latest system infrastructure. The system automatically enables this setting after your infrastructure is updated. For more information about standard maintenance policies, see Pega Cloud maintenance and types of system updates.

The following figures shows the screen and dialog where you make your selections for downloading log files:

The Download Logs option is available from your Environments view
Select the Download Logs option

Choose up to seven days and specify the types of logs to download
Specify a date range and log types

  1. Log in to your My Pega Cloud account.
  2. Navigate to the My cloud setup tab.
  3. In the row containing the environment from which you want the log files, click the More icon.
    • To download logs from a specific tier and file type, select Download logs (tier & file type).
      1. Modify the range of dates and time in the From and To fields using the embedded calendar function. Pega supports downloading log files created during the last 365 days.
      2. In the Time Zone field, specify the time zone applicable to your application. For example, if you want to download logs from 1 pm. to 5 pm. IST, select the IST timezone.
      3. Select a Tier Type for which you want to see available log files. You can select one or more available tiers for which you want to download a log bundle; you only see Tier Types for tiers with available log files generated within your selected date and time range.
      4. Select the File Types for which you want to see available log files. You only see File Types for log files that have been generated within your selected date and time range.
      5. Enter the reason you are downloading these log files. Pega uses this information to guide future improvements to this log download functionality.
      6. Click Generate log bundle. The Action center banner displays below the navigation pane to confirm that your log bungle is being generated.

        If no logs are available that match your filter, the Generate log bundle button is not enabled.

      7. When your log bundle successfully completes generating, in the top navigation panel, select the notification icon, and then select Download log bundle.
      8. Your log bundle downloads to your local system.
    • To download all logs from a single point in time, select Download logs (bundle).
      1. In the Download Logs dialog window, enter the date and time range and associated timezone to download the log files from that environment for that period.
      2. Enter the reason for downloading your log files for Pega to improve its client experience with log bundle downloads.
      3. Click Generate log bundle. The Action center banner is displayed below the navigation pane to confirm that your log bungle is being generated.
      4. When your log bundle successfully completes generating, in the top navigation panel, select the notification icon, and then select Download log bundle.
      5. Your log bundle downloads to your local system.
  4. Go to the Activity Center to view the status and availability of your downloaded logs.
    Activity Center notifications for a downloaded log bundle
    Notification for available log bundle
  • Previous topic Understanding and obtaining Pega log files
  • Next topic Streaming Pega logs to an external Amazon S3 bucket
Did you find this content helpful? YesNo

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us