Administative tasks in the IIoT Core Services UI

Enable message persistence in the message queue

You can ensure the retention of all data messages in internal routes, even during full or partial system failure, by enabling message persistence in the message queue of AMQP.

With message persistence enabled, messages in internal routes are written to disk. In the event of a system failure, the messages are processed when service is restored. Without message persistence, messages are stored only in memory and can be lost. The message persistence feature is enabled by default.

NoteEnabling message persistence can adversely affect system performance because each message adds a write operation.

Procedure

In the IIoT Core Services UI, click the Administration tab, and then click Data Route Configuration.
The Data Route Configuration window opens.
Toggle on Enable internal routes - AMQP persistence to enable message persistence in the message queue of AMQP.
Click Apply.

Measure message latency

You can enable performance metrics to measure message latency, which is the average amount of time from when IIoT Core Services receives a message to when it writes the message to the final database. Measuring message latency can help you fine-tune system settings during maintenance. The performance metrics feature is disabled by default.

Performance metrics are stored in the couchdb database. Contant the system administrator for information about querying couchdb.

NoteHaving performance metrics enabled during production can cause performance degradation.

Procedure

In the IIoT Core Services UI, click the Administration tab, and then click Data Route Configuration.
Toggle on Enable performance metrics.
Enter a value in the Data per batch field to specify the number of messages that should be grouped together to create an average value. The default Data per batch value is 200.
Click Apply.

Count the number of messages received

You can record the number of messages received by IIoT Core Services, and then compare the number of messages received with the number of messages sent by the registered asset. The feature to record number of messages received is disabled by default.

Information about the number of messages sent is stored in the couchdb database. Contact the system administrator for information about querying couchdb.

Procedure

In the IIoT Core Services UI, click the Administration tab, and then click Data Route Configuration.
Toggle on Number of messages received.
To specify the time interval between message counter updates, in the Batch Time field, enter a number followed by one of the following letters:
- s = seconds
- m = minutes
- h = hours
- d = days
The default time interval is 5 seconds.
TipIncreasing the time interval between message counter updates minimizes the number of write operations.
Click Apply.

Configure log level

You can set the level for the types of messages that are logged.

The default log level is info. Each log level includes logging of the preceding levels. Minimize the number of messages that are logged to improve performance. Set a high level of logging for troubleshooting.

NoteUnless you are performing maintenance or are troubleshooting, set the log level to info. Consistent high levels of logging can cause the file system to become full with logs.

Procedure

In the IIoT Core Services UI, click the Administration tab, and then click Log Configuration.
The Log Configuration window opens.
Select one of the following log levels.
- debug Logs all messages.
- info Logs info, warn, and error messages.
- warn Logs only warn and error messages.
- error Log only error messages.
Click Apply.