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.
The following log files are available for viewing:
|Log type||Log name||Log file name||Description|
|Tomcat||catalina-logs-*||catalina.out||Contains Tomcat server system information, including:
|Pega||prpc-application-logs-*||PegaRULES.log||Contains Pega system information, including:
This log includes Pega activity-related messages, as well as standard rules-generated messages.
|Performance alerts||prpc-alert-logs-*||PegaRULES-ALERT-YYYY-MMM-DD.log||Contains diagnostic messages for system events that exceed
performance thresholds or for failures. Each message includes the
following type of details:
|Security alerts||prpc-security-logs-*||PegaRULES-ALERTSECURITY-YYYY-MMM-DD.log||Contains messages about alerts that are generated when security
of a Pega web node server is at risk.
The security alert message name format is SECUnnnn, where nnnn is the message ID of the security event which generated the alert.
|Memory||prpc-memory-logs-*||prpc-memory-logs-YYYY-MM-DD.log||Contains diagnostic server memory information, including:
Contains messages about security events that are generated by the Pega web node server. Each message includes:
Specific events may contain additional information (such as “message” or “failedOperator”).
Contains messages from DataFlow logs. Each log event includes:
|Gateway||prpc-gateway-logs-*||PRPCGateway-*.log||Contains messages from PRPC Gateway.|
Contains messages for Pega application access. Each log event includes:
Contains messages for SMA access. Each event includes:
After you find the log file information that you need, you can represent the data graphically. The following pre-configured visualizations work best in the Pega Cloud environment:
- App – Top 10 Exceptions - Displays a pie chart of the top exceptions in the log file. If you point to a portion of the chart, the information that is represented by that portion is displayed.
- Log Levels - Displays a list of the top five message types in the log file and the number logged for the specified reporting time period.
- On the screen toolbar, click Visualize.
- In the Open a saved visualization section, type the name of the visualization that you want to use in the search bar and press Enter. The visualization with your log data is displayed.
For more information about options for saving and exporting visualizations, see the Kibana User Guide on the Elastic website.Creating a dashboard
You can display your visualizations on a dashboard for easier viewing.
- On the screen toolbar, click Dashboard.
- Add a visualization to the dashboard by clicking Add.
- Enter the name of your visualization into the search bar at the top of the screen. A list of visualizations that you have created is displayed.
- From the list, select the visualizations that you want to include in the dashboard. You can expand or rearrange the visualizations on the dashboard, as necessary.
- On the toolbar next to the search field, click Save Dashboard.