Monitoring Apps

Administrators can effectively monitor and manage the state of all processes within Joget. This includes tracking performance, auditing user actions, checking process completion statuses, and analyzing system health. Key monitoring tools include the Audit Trail, Governance Health Check, and log viewers.

Monitor menu

The Monitor menu provides access to tools and logs that help administrators oversee and manage Joget processes and system performance.

1. To access it, click Monitor in the Admin Bar below.
2. On the sidebar to the left, you will see the following options:
   • Running Processes / Completed Processes: This option shows lists of running and completed processes, respectively. 
   • Audit Trail: Displays audit trail information, including user authentication. 
   • Tomcat Logs: Allows administrators to download Tomcat log files to their local storage. This menu is not available for users of Joget Cloud On-Demand. 
   • System Logs: Allows administrators to view the latest Tomcat logs (up to 200 KB) for troubleshooting. Click the Download button to download the logs as a text file. For more information, see Web App Log Viewer.
   • Governance Health Check: Allows administrators to view the status of performance, quality assurance, and Joget's security for the last week. 

Audit trail

The Audit Trail logs actions performed by users across the system. This feature is important for tracking user activities, ensuring compliance, and auditing changes within the system. Connected apps in Joget DX 9 create logs based on network events, capturing a sequence of activities or specific events.

Log of action includes:

• Timestamp: Specific time of the performed scenario.
• Username: Individual username of the task.
• Method: Methodology used, such as updating, modifying, etc.
• Message: Specific ID, version, status, etc.
• Class: Defines the Java class mentioned in the backend code.
• App ID: Defines the application context under which a user activity is recorded. The App ID is captured during user login (via App Center or direct app access), remains consistent across multiple login attempts, applies to all user types, and is not recorded during logout. When users authenticate via the App Center, the App ID is stored as the App Center rather than the accessed app.

Web app log viewer

The Web App Log Viewer lets administrators view system and app-specific logs directly on the web console. This feature is essential for identifying and troubleshooting errors in real time.

Types of logs:

• System Logs: Displays system-wide log information and errors in all apps.
• App-specific Logs: Displays log information and errors related to the selected app.

How do you view system logs in the web console?

To view system logs in the web console, follow these steps:

1. Log in as an administrator.
2. Open the Administrator Bar.
3. Click Monitor.
4. Click System Logs.
   

How do you view app-specific logs?

To view app-specific logs, follow these steps:

1. Log in as an administrator.
2. Hover over an app until a pencil icon is displayed.
3. Click the pencil icon to access the App Composer.
4. Click Logs.
   

Web app log viewer properties

• Search: Provides search options and filters, allowing the ability to scan through logs using specific keywords and filter logs by log level, such as error, warning, info, and debug.
  New Feature
  The search feature is available in Joget DX 9.1 and above.
  
• Download: Download the log file.
• Follow: Displays all newly added lines from a log file in real-time on the web console.
  

BeanShell Exception Handling

Available in Joget DX 8.1 onwards:

• Logs error line numbers for easier debugging and tracing.
  

Tomcat logs

The Tomcat Logs feature allows administrators to retrieve relevant logs for inspection directly from the web browser.

For more information, see Troubleshooting - Common Errors.