Server Diagnostics

JasperReports Server provides comprehensive diagnostics so administrators can monitor the health and performance of the running server. The following tools can help you troubleshoot issues and analyze performance:

• System logs capture any errors in the code running the server, but can be configured to capture more information for debugging. If you suspect a problem or cannot pinpoint an error, you can turn log collectors on and off to capture logs while you test your issue.
• Auditing stores key events of interest to system administrators, such as login time, log out time, user, report generated, report details, and object sizes. The audited events can be saved and moved to an archive automatically after a specified number of days.
• Monitoring is based on audit events and provides a multi-dimensional Domain to create Ad Hoc views. This helps you generate reports that contain key metrics such as which reports use the most resources. It allows you to find places to optimize your data sources and your reports.
• Diagnostics provide run-time data that shows the overall health of your server instance. For example, it includes values such as logged in users, currently running reports, scheduled reports, and memory use and performance in the Ad Hoc cache. The diagnostic data is exposed in a custom data source and can be easily viewed in a report or integrated with industry standard management consoles.

This chapter contains the following sections:

• Configuring System Logs
• Using Log Collectors
• Auditing and Monitoring Events
• Configuring Auditing and Monitoring
• Using the Audit Data
• Using the Monitoring Data
• Importing and Exporting Event Data
• Real-Time Diagnostics
• Exposing Diagnostics Through Jaspersoft's JMX Agent
• Using the Diagnostic Data in Reports
• Excluding Diagnostic Attributes
• Disabling Real-Time Diagnostics
• Server Monitoring