EMS Console UI

From RAD Studio
Jump to: navigation, search

Go Up to EMS Console Server


You can access the EMS Console using your regular browser.

  • For a stand-alone application:
    • http://<ip_address>:<port_number>
  • For a Microsoft IIS Server:
    • http://<ip_address>:<port_number>/<site_name>/emsconsole.dll

Main Menu

You can access all the pages of the console using the main menu.

EMSConsoleMainMenu.png

Home Page

This page is a summary of the console information that provides the key counters.

  • Total Users: Users with activity within the last 90 days. Click this field to redirect to Users Analytics.
  • API calls last 24 hours: API calls registered on the EMS Server within the last 24 hours.
  • Total Installations: Devices registered in the EMS Server that can receive EMS Push Notifications.
Note: Refresh the page to see the latest statistics.

Users Page

This page shows the Users table. All the columns of the table are displayed by default.

EMSUsersTable.png

If you hover over the userid field, the list of EMS Groups the user belongs to is displayed.

Groups Page

This page shows the Groups table.

EMSGroupsTable.png

If you click in a groupname field, a new table displays the list of EMS users that belong to that group.

Installations Page

This page shows the Installations table.

EMSInstallationsTable.png

EdgeModule Page

This page shows the modules table.

EMSEdgeModuleTable.png

Resources Page

This page shows the resources table.

EMSResourcesTable.png

Customizing the Appearance of the Tables

On the main menu you have access to the different pages that display table information: Users, Groups, and Installations.

Table functionality:

Item Description

Show search box EMsSearch.png

Allows filtering the information using a valid JSON object.

Refresh table EMSUpdate.png

Updates the content of the table with the latest information.

Click to hide column / Click to show column HideColumn.png

Hides or shows one or more columns. When a column is hidden, it appears above the table. Click the link to show it again.

Order Des / Order Asc DesAsc.png

Sorts ascending/descending on any visible column.

Move a column

To move and replace a column, place the mouse cursor on the column name, drag the column and drop it on the new location.

Analytics Summary

Select the analytic you want to display from the drop-down menu. The charts display the information using bars or lines.

Analytics functionality:

Analytics functionality.png

Item Description

Export to CSV file

You can export the displayed statistics data to a .csv file and save it in your system.

Date Picker

Allows you to select a different date.

Note: You can not select future dates. The EMS Console shows a warning message.

Refresh

Updates the charts with the latest information from the database.

Resource drop-down menu

Select the resource from which you want to display statistics. Select All Resources to view all the information at the same time.

Users drop-down menu

Select the user name from which you want to display statistics. Use the user filter to quickly find a user in the drop-down list.

Daily / Monthly / Yearly tabs

Select the appropriate tab to show daily, monthly or yearly information:

  • Daily: use the date picker to select a particular day.
  • Monthly: use the date picker to select a particular month. The chart only takes into account the month starting from day one of the month.
  • Yearly: use the date picker to select a particular year. The chart only takes into account the year starting from January.

Below the analytics charts, you can see a list that displays the total number of calls to each EMS endpoint method.

Total Clients Page

This chart shows the following:

  • Total Users: The total number of users from the EMS database.
  • Active Users: The users that have connected to the EMS Server API within the last 90 days.

Select the time bases to display the information: daily, monthly or yearly.

API Calls Page

This chart shows the calls to the EMS Server API.

The information is displayed only using bars. Place the mouse on a bar to get the number of different types of calls.

Select the time bases to display the information: daily, monthly or yearly.

API Calls EndPoint Page

This chart shows the calls to the EMS Server API separated by type of call.

From the drop-down menu, select a particular resource to display its statistics data.

Select the time bases to display the information: daily, monthly or yearly.

Users Analytics

This section shows the total number of EMS Resource endpoints that a particular EMS user or group of EMS users call.

User API Calls Page

This chart shows the calls to the EMS Resources by a particular EMS User.

You can either filter or select a particular EMS User from the drop-down menu (that displays all EMS Users from the EMS database).

From the drop-down menu, select a particular a resource to display its statistics data.

Select the time bases to display the information: daily, monthly or yearly.

User Total Calls Page

This chart shows the total calls make to the EMS Server API by an EMS User.

The information is displayed only using bars. Each color corresponds to a particular EMS User. Place the mouse on a bar to get the number of different types of calls.

From the drop-down menu, select a particular resource to display its statistics data. You can also filter or click a user to add and display its data in the chart, or remove its data from the displayed chart.

Select the time bases to display the information: daily, monthly or yearly.

Using Filters

On the Users, Groups and Installation tables, you can filter the information provided by the console using certain criteria.

  1. Go to one of the two tables: Users or Groups.
  2. Click Show search box to open the search box.
    EMS Search box.png
  3. Enter a valid JSON object. For example:
    {"Username": "<name>"} //shows all the users with username = <name>

    {"Username" : {"$like" : "<string>%"}}  //shows all the users with usernames that start with some <string>. It uses % as a wildcard.
Note: When you start typing, the field shows hints to help you complete the filter. You also have a query sample above the search box.

Exporting Analytics Data

You can export the analytics data displayed in the EMS Console. You can see the total amount of calls to the EMS Resource endpoints retrieved from the EMS database and post-process this information.

The EMS data is saved to a .csv file. The format of this file is as follows (depending on the chart that is displayed in that moment):

  • Columns correspond to the EMS Resource endpoints or the EMS Users.
  • Rows correspond to the time used to display the information (hours, days or months).

See Also