LinkedIn
Copied!

Table of Contents

My cloud setup

Use the My cloud setup tile to access all your Pega Cloud Services environments, download your Pega Platform log bundles, and perform restarts on each environment.

You can perform the following tasks through the My cloud setup tab:

  • Access your log files for troubleshooting
  • Analyze logs by using Kibana
  • Restart the web AppTier of your environments
  • Wake up your hibernated environment
  • Monitor your environment in PDC
  • View the activity logs for self-service actions on your Pega Cloud environments

Accessing log files for troubleshooting

Generate a bundle of specified log files that have been created from your environment during the last 30 days for internal analysis or to share with Pega Global Customer Support (GCS). The log bundle is a compressed TAR file that you can download to your local computer. If no logs are available that match your filter, the Generate log bundle button is not enabled.

For more information about downloading your logs, see Accessing your log files for troubleshooting.

  1. In the Environments section, in the row that contains the environment for which you want the log files, click the More icon, and then select Download logs.
  2. In the Download Logs dialog box, choose the tier type and file type to bundle in your logs:

    Enter the following information:

    1. In the From and To fields, modify the range of dates and time by using the embedded calendar function. Pega supports downloading log files created during the last 30 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. In the Select Tier Type section, choose the tiers 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 that have been generated within your selected date and time range.

    4. In the Select File Types section, choose 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 why you want to download these log files.

      Pega uses this information to guide future improvements to this log download functionality.

    6. Click Generate log bundle.
    7. When your log bundle successfully completes generating, in the top navigation panel, select the Notification icon, and then click Download log bundle.

      Your log bundle is downloaded to your local system.

  3. Optional: To download all logs from a single point in time, select Download Logs Beta.
    1. In the Download Logs dialog box, enter the date and time range and associated timezone for the log files that you want to download.
    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.
    4. When your log bundle successfully completes generating, in the top navigation panel, select the Notification icon, and then select Download log bundle.

      Your log bundle is downloaded to your local system.

Analyze your logs using Kibana

Visualize your log data and view indexed Elasticsearch log data for analysis and tracking purposes by using Kibana.

For more information, see Accessing your log files by using Kibana.

  1. In the Environments section, click the environment name.
  2. In the Environment Details tab, analyze your logs with Kibana by clicking Analyze logs.
  3. Enter the credentials that were provided by Pegasystems.

    Pega Platform displays the raw log data.

  4. In the left navigation pane, click the Log type menu, and then select the log that you want to view.
  5. On the toolbar, set the time reporting range for the log file:
    • To choose a predefined time range, select Quick, and then select an option.
    • To choose a relative start time, select Relative, and then select an option.
    • To choose an absolute time range, select Absolute, and then enter the start date in the From field and the end date in the To field.
  6. In the search bar at the top of the window, search for specific data within the log file by entering search terms.

    All log entries that match that term are displayed.

    • Use a wild card search, such as *error* or *warning*, to find all entries that match those terms.
    • Use exact terms, such as "heap", to search for entries that contain those terms.
  7. View additional details by clicking the arrow next to a log entry.

Restarting the web AppTier of your environments

Restart the Pega web AppTier in your development, test, and staging environments by using the My Pega Cloud self-service portal. When you restart the Pega web AppTier by using the self-service portal, the average time for the nodes in your tier to restart is about 30 minutes, while the maximum time is about 60 minutes.

For more information about restarts in your My Pega Cloud environment, see Restarts in your My Pega Cloud environment.

When you use the restart self-service, you do not impact your background processing tiers or the Search availability.
You cannot restart the following environment types or environments with these statuses:
  • Production environment types
  • Environments in a hibernating, hibernated, or waking-up status
  • Environments undergoing maintenance activities.

    Maintenance activities might temporarily disable your ability to restart the Web tier in an environment. For more information, see Pega Cloud Services maintenance and types of system updates.

  1. In the Environments section, in the row for the environment that contains the web AppTier that you want to restart, click the More icon, and then select Restart.
  2. In the Restart PegaAppTier dialog box, select the reason category that best describes the reason why you want to restart your environment. Pega uses this information to guide future improvements to this functionality.
    If a restart fails, a new request is automatically generated with your environment details. Do not attempt a second restart; instead, work with your support team to complete the restart.
  3. Optional: To add additional details for Pega Cloud Services as to why you want to restart your environment, in the Additional details field, enter your supporting information.
  4. Click Restart.
  5. In the top navigation panel, select the Notification icon to view the status of the restart process.

    After a successful restart, you receive a notification with details about the restart.

Wake up your hibernated environment

After a period of no-activity usage, your environment begins a hibernating phase before entering a hibernated state that pauses usage of system resources.

For more information about waking up a hibernated environment, see Managing a hibernated environment.

Wake up your hibernated environments using the following steps:

  1. In the Environments section, in the row with your hibernated environment, click the More icon, and then select Wake up.

    The Environments tab

  2. Select Wake up.
  3. In the Wake Up Environment dialog box, click Wake Up, as in the following example:

    Wake Up Environment dialog box

Your environment enters the Waking Up status, and then enters a Running state in approximately 15 minutes.

Environment status change to Waking Up
The status of a hibernated environment that is waking up changes to Waking Up.

Monitoring your application by using Pega Predictive Diagnostic Cloud

Find the PDC URL for any environment to which your credentials provide access. PDC offers a performance management service that supports management and development teams by monitoring your Pega application performance and notifying you about system health issues so you can minimize their impact on your business.

For more information, see Monitoring your application using Pega Predictive Diagnostic Cloud.

  1. In the Environments section, click the environment name.
  2. In the Environment Details tab, click Monitor on PDC.
  3. On the PDC login view for the environment, enter your credentials.

Viewing the activity logs for self-service actions on your Pega Cloud environments

  1. In the Environments section, click the environment name.
  2. In the Environment Details section, view the activity log of self-service actions performed on your environment, their status, and the user who performed the action by clicking Activity Log.
  • Environment Details

    Access a single view of your environment version, type, and production level, as well as an activity log of actions performed on the environment through Pega Cloud.

  • Accessing your log files for troubleshooting

    Pega Cloud customers can download log files from the My Pega Cloud for internal analysis or to share with Pega Global Customer Support (GCS). This ability to download logs is an enhancement to the Pega Predictive Diagnostic Cloud which offers the self-service capability to review alerts and exceptions.

  • Accessing server logs by using Kibana

    Pega Cloud Services gives you the capability to view your server logs for analysis and tracking purposes. This service is built on the Kibana platform, which provides tools for searching and organizing the data. By default, the log retention duration is 30 days.

  • Monitoring your application using Pega Predictive Diagnostic Cloud

    Pega provides Pega Predictive Diagnostic Cloud (PDC), a performance management service that supports management and development teams by monitoring your Pega application performance and notifying you about system health issues so you can minimize their impact on your business.

  • Restarts in Pega Cloud environments

    Restarts in Pega Cloud® Services are required in certain scenarios to complete configuration changes.

  • Managing a hibernated environment

    Pega Cloud Services is taking action to reduce the energy consumption and carbon footprint of its client environment portfolio by implementing an auto-hibernation process. Pega Cloud Services uses this process to pause the cloud resources for your non-Production environments during periods of no-activity usage. Pega Cloud Services provides a simple process with which you can un-pause a hibernated environment using self-service controls available in the My Pega Cloud portal. Learn more about the auto-hibernation and wake-up process for your

Suggest Edit

Have a question? Get answers now.

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