System Monitor

Form ID: (SM201530)

You can use this form to monitor and maintain running processes, active users, and resource usage in MYOB Acumatica. On this form, an administrator can interrupt the session of any user, find the processes that are opening a lot of sessions, and manually stop the processes, when needed. Also, the form can be helpful as a part of system monitoring if performance issues arise.

Running Processes Tab

This tab can be used for the monitoring and maintenance of running processes. The tab displays only currently running processes, so if a process is complete, it will not be displayed on this tab.

Table 1. Summary AreaIn this area, you can review and edit the setting that affect which running processes are displayed in the table.
Element Description
Show All Users A check box that you can select to display the processes run by all users. The check box is cleared by default, and the table displays only the processes of the current user.
Table 2. Table Toolbar

The table toolbar includes standard buttons and buttons that are specific to this table. For the list of standard buttons, see Table Toolbar. The table-specific buttons are listed below.

Button Description
Abort Aborts the selected process.
View Screen Opens the process-related screen.
Active Threads Opens the Active Threads dialog box. If there is at least one active thread, the dialog box contains information about the threads that are currently running. MYOB Acumatica runs threads for long operations only. You use this dialog box to discover and analyze the threads that are currently frozen or no longer responding.
Table 3. Table ColumnsFor each running process that is listed, the table columns display the general information that is shown to a user who has launched the process in the Processing pop-up window. For details, see Processing Pop-Up Window.
Element Description
User The name of the user running the process, such as admin.
Screen The form ID of the form running the process, such as GL504500.
Title The form name of the form running the process, such as Run Allocations.
Processed The number of successfully processed records.
Total The total number of processed records.
Errors The number of records that were processed with errors.
Time The current duration of the process.
Key The internal unique ID of the running process.

Active Users Tab

This tab displays a table that lists active users and displays settings that reflect their activities in the system.

Table 4. Summary AreaIn this area, you can review and edit the setting that affect which user types are displayed in the table.
Element Description
Login Type
The way the users to be listed have accessed the system, which is one of the following:
  • All: The table lists users that have signed in by using either of the available methods.
  • User Interface: The table lists only users that have signed in by using their username and password on the MYOB Acumatica Sign-In page, through the mobile application, or through the single sign-on page if SSO with Google or Microsoft Account has been set up.
  • API: The table lists only users that are client applications that have signed in by using the OAuth 2.0 mechanism of authorization for applications, or by using the sign-in method of the contract-based SOAP API, contract-based REST API, or screen-based SOAP API.

The table displays only the records that satisfy the value specified in this box.

For details about login types, see License Restrictions for the Number of MYOB Acumatica Users.

Table 5. Table Toolbar

The table toolbar includes standard buttons and buttons that are specific to this table. For the list of standard buttons, see Table Toolbar. The table-specific buttons are listed below.

Button Description
View User Opens the Users (SM201010) form to display information about the currently selected user.
Table 6. Table Columns
Column Description
User The user's login name as defined on the Users (SM201010) form.
Company

The tenant name, as specified on the Tenants (SM203520) form, to which the user signed in.

This column is displayed if the system has a multitenant configuration. For details, see Managing Tenants by Using the Web Interface.

Login Type

The way the user accessed the system, which is one of the following:

  • User Interface: The table lists only users that have signed in by using their username and password on the MYOB Acumatica Sign-In page, through the mobile application, or through the single sign-on page if SSO with Google or Microsoft Account has been set up.
  • API: The table lists only users that are client applications that have signed in by using the OAuth 2.0 mechanism of authorization for applications, or by using the sign-in method of the contract-based SOAP API, contract-based REST API, or screen-based SOAP API.

For details, see License Restrictions for the Number of MYOB Acumatica Users.

Time from Last Activity The amount of time that has elapsed since the last active action of the selected user.
Time from Last Login The amount of time that has elapsed since the selected user last signed in.

Resource Usage Tab

This tab gives you the ability to monitor resource usage and can be helpful as a part of system monitoring when there are performance issues. At the bottom of the form, you can view charts that illustrate the current CPU and memory usage of the application server for the MYOB Acumatica instance.

Table 7. Memory Usage SectionThe section contains read-only elements that display the memory usage of MYOB Acumatica. To update these values, click Collect Memory.
Element Description
Managed Memory, Mb The volume of managed memory currently used by MYOB Acumatica.
Working Set, Mb The memory volume currently used by MYOB Acumatica.
GC Collections An element that displays three values separated by slashes: the number of objects in garbage collections of generation 0, generation 1, and generation 2 in the heap of MYOB Acumatica.
Collect Memory A button that you click to update values for the elements in the Memory Usage section.
Table 8. CPU Usage SectionThe section contains read-only elements the display the CPU usage of MYOB Acumatica.
Element Description
Current Utilization The percent of current CPU utilization of the application server for the MYOB Acumatica instance.
Up Time The operating time of the MYOB Acumatica instance since the last restart.
Active Requests The count of currently active requests on the server.
Requests for Last Minute The total count of requests (from API and UI) during the last minute.

System Events Tab

The tab lists the log records of system events; a system administrator can explore the log for errors, warnings, and operations that consume excessive resources.

To view the details of an event, a system administrator clicks the row with the event in the table; the system displays these details in the bottom pane of the form.

Table 9. Selection Area
Element Description
Source

A source that triggered logging of the events listed in the table. The following options are available:

  • All
  • Active Directory
  • Business Events
  • Commerce
  • Customization
  • Data Consistency
  • Email
  • License
  • Push Notifications
  • Resource Governor
  • Scheduler
  • System

You can narrow the list of events by selecting one source or multiple sources. By default, the All option is selected.

Level

The severity level of the events to be listed in the table. The box contains the following options, which are listed from the least to most severe:

  • Information (default): Events of all levels are shown in the table; this is the least severe level.
  • Warning: The table displays events with the selected severity and with the higher levels, which are Error and Fatal.
  • Error: Events of only the Error and Fatal levels are listed in the table.
  • Fatal: The table shows only events with the Fatal level.
From The start date of the date range for which logged events will be listed; you can use this element to narrow the list of the events by date.
To The end date of the date range for which logged events will be listed; you can use this element to narrow the list of the events by date.
Table 10. Table Columns
Column Description
Level

The severity level of the event, which can be one of the following:

  • Warning
  • Error
  • Fatal
Source

The source that triggered the event logging, which can be one of the following:

  • Active Directory
  • Business Events
  • Commerce
  • Customization
  • Data Consistency
  • Email
  • License
  • Push Notifications
  • Resource Governor
  • Scheduler
  • System
Event

The event description, as defined in the source code.

Screen ID The identifier of the form for which the event was configured, if any.
Link to Screen A link to the form for which an event was configured, if any. If you click the link, the system opens the form in a new tab with the relevant elements populated with the details of the event.
Date and Time (Local) Date and time of when an event occurred in local time of the user currently signed in.
Tenant

The tenant name, as specified on the Tenants (SM203520) form, for which the event occurred.

The column displays a value if the system has a multitenant configuration. For details, see Managing Tenants by Using the Web Interface.

User The user that triggered the event, if any.
Message A message with the details of the event.

Requests in Progress Tab

The tab contains the list of URL requests that are currently executing.

Table 11. Table Toolbar

The table toolbar includes standard buttons and buttons that are specific to this table. For the list of standard buttons, see Table Toolbar. The table-specific buttons are listed below.

Button Description
View SQL Opens the View SQL dialog box, which displays detailed information about the SQL queries within the particular URL request that is currently selected in the table.
View Event Log Opens the View Event Log dialog box, where you can review detailed information about the events that occurred within the particular URL request that is currently selected in the table.
Open URL Opens the MYOB Acumatica form specified in the URL column of the selected request.
Table 12. Table Columns
Column Description
Request Start Time The date and time of the start of the URL request.
Username The username of the user who performed the URL request.
URL The URL of the request. Click this URL to open the MYOB Acumatica form specified in the URL.
Screen The MYOB Acumatica form where the request was executed.
Request Type The type of the request, which can be one of the following:
  • LongRun-Report
  • LongRun
  • Screen
  • Mobile
  • ODATA
  • UI-Reports
  • UI-GI
  • API-CB
  • SOAP
  • API
  • API-ML
  • API-SignalR
  • UI
  • Unknown
Command Target The identifier of the control that created the URL request.
Command Name The type of the command that created the URL request.
Server Time, ms The aggregate duration of the URL request execution on the server (in milliseconds).
SQL Time, ms The aggregate duration of the execution of all the SQL queries in the URL request (in milliseconds).
Server CPU, ms The aggregate duration of CPU usage during the URL request (in milliseconds).
SQL Count The count of the SQL queries to the database in the URL request. This count is the difference between the total number of the SQL queries in the URL request and the number of requests to the cache.
Logged SQL Count The count of the logged SQL queries in the URL request. If you click a link in this column, the system opens the View SQL dialog box with details on the logged SQL queries.
SQL Rows The number of records processed in the SQL query.
Exceptions Count The number of exceptions that occurred during the URL request.
Events Count The number of events that occurred during the URL request.
Managed Memory The memory volume used by MYOB Acumatica at the start time of the URL request (in MB).
Table 13. View SQL Dialog Box

The View SQL dialog box displays a list of records that contain the performance data of SQL queries that occurred during the currently selected URL request. To view the text of the currently selected SQL query, click Switch Between Grid and Form on the table toolbar. In form view, the dialog box displays the application stack trace when the SQL query executed.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Column Description
Order The order number of the statement execution within the URL request.
Statement ID The ID of the SQL query.
Tables The database tables used in the SQL query.
Row Count The number of records processed in the SQL query.
Start Time The time that has passed from the start time of the URL request to the start time of the SQL query (in milliseconds).
SQL Time, ms The duration of the SQL query (in milliseconds).
Parameters The parameters of the SQL query, if available.
From Cache A check box that indicates (if selected) that the SQL query processed data from the query cache, rather than from the database.
Table 14. View Event Log Dialog Box

The View Event Log dialog box displays the list of events that occurred while the currently selected URL request was executed. To get more information about a particular event, click Switch Between Grid and Form on the table toolbar.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

Column Description
Start Time The time that has passed from the start time of the URL request to the start time of the event (in milliseconds).
Source The source of the event.
Event Type The type of the event.
Message The text of the message assigned to the event.