System Monitor

Form ID: (SM201530)

You can use this form to monitor and maintain running processes, active users, API requests, and resource usage in Acumatica ERP. On this form, an administrator can review 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 Area. In this area, you can review and edit the setting that affects 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 the buttons described 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. Acumatica ERP 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 Columns. For 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.
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 Area. In this area, you can review and edit the setting that affects 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 Acumatica ERP 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 Instance Deployment: Feature Activation and Licensing.

Table 5. Table Toolbar.
The table toolbar includes the buttons described 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 Acumatica ERP 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 Instance Deployment: Feature Activation and Licensing.
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.

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 7. 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 8. 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 9. Table Toolbar.
The table toolbar includes the buttons described 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 Acumatica ERP form specified in the URL column of the selected request.

Table 10. 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 Acumatica ERP form specified in the URL.
Screen	The Acumatica ERP 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 Acumatica ERP at the start time of the URL request (in MB).

Table 11. 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 has only standard buttons.
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 12. 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 has only standard buttons.
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.

Resource Monitoring Tab

On the Resource Monitoring tab, you can view the current status of system resource usage, along with recent resource usage trends.

Table 13. Table Toolbar.
The table toolbar includes the buttons described below.
Button	Description
License Monitoring Console	Opens the License Monitoring Console (SM604000) form, where you can review the details of your license and the recommended consumption limits for your license tier.

Calendar Widget

The calendar widget provides an overview of resource consumption for the last 30 days or the selected month. Days with normal resource consumption are highlighted in green. Days with excessive resource consumption are highlighted in yellow.

To display metrics for a particular date in the other widgets, click that date in the calendar. To display data for a different month, use the arrow buttons in the widget’s upper right corner. The widget’s title then will change fromLast 30 Days to the selected month and year.

Table 14. Consumption Status, <Selected_Date> Widget. This widget contains a summary of key resource consumption metrics showing consumption for the selected date. Each metric is represented by a scorecard widget that you can click to view a chart with more information.
Scorecard Name	Description
ACU, Max.	The maximum cumulative ACU consumption for the chosen date, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the Application Compute Units (ACU) Consumption chart opens in a pop-up window.
ACU, Last 30 Days	The maximum cumulative ACU consumption for the last 30 days, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the Application Compute Units (ACU), Cumulative 30 Days meter opens in a pop-up window.
DCU, Max.	The maximum cumulative DCU consumption for the chosen date, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the Data Compute Units (DCU) Consumption chart opens in a pop-up window.
DCU, Last 30 Days	The maximum cumulative DCU consumption for the last 30 days, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the Data Compute Units (DCU), Cumulative 30 Days meter opens in a pop-up window.
Memory, Max.	The maximum average memory consumption for the chosen date, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the Memory Consumption chart opens in a pop-up window.
Memory, Last 30 Days	The maximum average memory consumption for the last 30 days, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the Memory, Average 30 Days meter opens in a pop-up window.
CTV, Last 30 Days	The cumulative consumption of commercial transaction volume (CTV) for the last 30 days, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the CTV, Cumulative 30 Days meter opens in a pop-up window.
ETV, Last 30 Days	The cumulative consumption of ERP transaction volume (ETV) for the last 30 days, expressed as a percentage of the recommended consumption of your current license tier. When you click this scorecard widget, the ETV, Cumulative 30 Days meter opens in a pop-up window.

Table 15. Additional Widgets. The remaining widgets on the tab show charts and meters illustrating some aspect of resource usage. You can hover over a measurement to see its details in a tooltip. For most charts, you can click anywhere to zoom in on the data.
When you click a widget, a more detailed chart opens in a pop-up window. In some cases, you can click option buttons to view the data overall (the default setting) or break it down by tenant, screen (form), request type, or user. For cumulative data, the chart also displays the trend line of the cumulative value.
Widget Name	Description
Requests Count	A chart that displays the number of requests during the selected date.
Slow Requests Count (>10 seconds)	A chart that displays the number of requests that took longer than 10 seconds to complete during the selected date.
Application Compute Units (ACU) Consumption	A chart that displays the computing time used to process resource requests and tasks during the selected date.
Application Compute Units (ACU), Cumulative 30 Days	A meter that indicates the cumulative ACU usage for the last 30 days. In the meter widget, the needle points to the value; green shading shows normal levels, and yellow shading shows warning levels.
Data Compute Units (DCU) Consumption	A chart that displays the total SQL processing time during the selected date.
Data Compute Units (DCU), Cumulative 30 Days	A meter that indicates the cumulative SQL usage for the last 30 days. In the meter widget, the needle points to the value; green shading shows normal levels, and yellow shading shows warning levels.
Memory Consumption	A chart that displays the amount of memory consumed during the selected date.
Memory, Average 30 Days	A meter that indicates the system’s average memory consumption for the last 30 days. In the meter widget, the needle points to the value; green shading shows normal levels, and yellow shading shows warning levels.
CTV, Cumulative 30 Days	A meter that displays the cumulative volume of commercial transactions for the last 30 days. In the meter widget, the needle points to the value; green shading shows normal levels, and yellow shading shows warning levels.
ETV, Cumulative 30 Days	A meter that displays the cumulative number of times Acumatica ERP objects were created or modified during the last 30 days. In the meter widget, the needle points to the value; green shading shows normal levels, and yellow shading shows warning levels.

API Monitoring Tab

On this tab, you can analyze API activity, resource consumption, errors, throttling, duration, and request size. The tab includes requests whose paths begin with:

/api/: API routes, such as the generic inquiry-based and DAC-based OData interfaces (/api/odata/gi and /api/odata/dac)
/soap/: The screen-based SOAP API
/entity/: The contract-based REST API
/Webhooks/: Requests received by registered webhook handlers
/odata: The legacy generic inquiry-based OData interface
/identity/: The OAuth 2.0 and OpenID Connect endpoints for authorization, token issuance, and user information

Table 16. Widgets.
When you click a date in the calendar widget, the monitoring widgets show data for that day in 10-minute intervals. Widgets with breakdown options display up to 10 values in the legend and combine the remaining values as *Other*. You can click a widget to open a larger view and click a legend item to show or hide its data.
Widget	Description
Calendar Widget	Controls the date displayed in all other widgets on this tab. The current date is selected by default. Normal days are green, days with excessive API consumption are yellow, and days on which at least 20 percent of API requests were throttled are violet. Future days are unavailable.
Consumption Status	Shows the number of API sessions and the number of API requests per minute as a percentage of the applicable license limits.
API Request Count	Shows API request volume in 10-minute intervals. You can view the data overall or by tenant, screen, user, IP address, endpoint, session, HTTP method, or target action.
API Resource Consumption	Shows CPU time, SQL time, throttled time, and server time for API requests.
API Request Error Count	Shows unsuccessful requests overall or by tenant, screen, endpoint, or HTTP status code.
API Resource Shortage	Shows the percentage of API demand that could not immediately use the available processing capacity.
API Requests by Time	Groups requests by duration: less than 500 milliseconds, 500 milliseconds to 5 seconds, 5 to 30 seconds, 30 to 100 seconds, and more than 100 seconds.
API Request Duration	Shows server time overall or by tenant, screen, user, or endpoint.
API Requests by Size	Groups requests as small, medium, or large based on request length.

Runtime Metrics Tab

This tab gives you the ability to monitor runtime metrics and can be helpful as a part of system monitoring when there are performance issues.

Table 17. Memory Usage Section. The section contains read-only elements that display the memory usage of Acumatica ERP. To update these values, click Collect Memory.
Element	Description
Managed Memory, Mb	The volume of managed memory currently used by Acumatica ERP.
Working Set, Mb	The memory volume currently used by Acumatica ERP.
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 Acumatica ERP.
Collect Memory	A button that you click to update values for the elements in the Memory Usage section.

Table 18. CPU Usage Section. The section contains read-only elements that display the CPU usage of Acumatica ERP.
Element	Description
Current Utilization	The percent of current CPU utilization of the application server for the Acumatica ERP instance.
Up Time	The operating time of the Acumatica ERP 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.