System Monitoring

NoahFace provides comprehensive capabilities to allow you to monitor the status of the NoahFace platform, the integration with your HR / Payroll System, and your individual NoahFace Access Points.

Monitoring NoahFace Using the NoahFace Dashboard

You can monitor the status of NoahFace from the NoahFace Dashboard. On the main screen you will see high level status icons which show the status of:

• Access Points. If any access points are offline or not yet enabled, this icon will be red.
• User Syncs. If your user sync has failed to connect or complete, this icon will be red.
• Notifications. If there were events that could not be sent to your HR / payroll Platform, this icon will be red.

As well as the high level status icons, you will see Access Point and Notification status icons against each individual site, which is useful for larger organizations with many sites and/or system administrators for individual sites.

Clicking on these icons will take you to pages containing further details.

‍

Monitoring Access Points

You can monitor your Access Points from the Access Points page in the NoahFace Dashboard. Each Access Point will have a status of either:

• Ready. This means it is ready for activation.
• OK. This means it has been activated. If the status time is less than 5 minutes ago then it is healthy, and if it is more than 5 minutes ago then it is unhealthy (eg: the network connection is down).
• Deactivated. This means that it was previously activated but it has been manually deactivated.

For iPads, you can see the iOS version and the NoahFace App version in the list, so you can easily identify any iPads that need upgrading. The iOS version will have an asterisk next to it if guided access (or single App mode) is not enabled.

You can use the Filter options to display iPads that need attention or do not have Guided Access (or Single App mode) enabled.

The example below shows the list of iPads that need attention - as they have not recorded a status for more than 5 minutes.

‍

Monitoring NoahFace Using an IT Management System

Larger organizations typically use IT Management Systems to monitor all of their IT infrastructure and applications in one place, providing a consistent status dashboard and proactive alerts via SMS, Email, and other channels. NoahFace can be included in your IT Management System through the use of its System Monitoring API.

‍

To use the System Monitoring API, you need to generate an API Key. To do this, login to the NoahFace Dashboard as an administrator, select View Profile, and then select Generate and copy an API Key for system monitoring:

The API Key can be passed to the System Monitoring API endpoint (https://data.noahface.com/monitor) either as a standard BEARER token or via the "key" query parameter. While the System Monitoring API does not return any sensitive information (eg: user information, IP addresses, etc), and does not enable any other access to the NoahFace Dashboard, your API Key should still be kept confidential.

‍

The information returned by the system monitoring API is as follows:

• Organization Name.
• Plan Information.
• User Sync Type.
• Number of Users.
• Number of Sites.
• Number of Access Points.
• User Sync Status. Whether the synchronization of users from your HR platform is operational.
• Access Point Status. Whether your access points are online or offline.
• Notification Status. Whether there have been any issues sending events to your HR platform.

‍

The data is returned in JSON format by default, however, you can specify the "format=xml" query parameter to return the data as XML. For example:

{
	"organisations": [
	{
		"id":100,
		"name":"Acme Corporation",
		"plantype":"Advanced",
		"planusers":3000,
		"users":2935,
		"sites":52,
		"accesspoints":185,
		"synctype":"Workday",
		"userstatus":"OK",
		"accesspointstatus":"OK",
		"notificationstatus":"OK"
	}]
}

If you have access to multiple organizations, the API will return status information for all of them.