- 3 minutes to read

How to monitor Nodinite diagnostic log files

This guide will teach you how to monitor the Nodinite diagnostic log files log files using the Nodinite Log File Parser Monitoring Agent.

This article assumes your you have installed all the Nodinite binaries in the default folders.

Before you begin

Ensure you comply with the prerequisites and install the Nodinite Log File Parser Monitoring Agent.

Step 1: Add a new monitoring configuration

To add a new monitoring entry, click the Add button from the Content File tab.
Content File tab

  1. Enable the configuration
  2. Name the configuration
  3. Provide an optional description
  4. Set the Application ID (You must have a matching entry in the Applications Tab)

General Tab

Step 2: Set the monitor path

Next, enter the root path to where the Nodinite binaries are located (the default is, C:\Program Files\Nodinite\).

  1. Enter the path
  2. Enter the RegEx-based filter ((^diagnostic.log.json|^diagnostic.log.json.[1-5])$)

Path tab

Step 3: Set the start match

Next, enter the start match configuration.

  1. 'Line contains' (what error states are we looking for? In this case Error and Fatal)
(ERROR|FATAL)

Match tab

  1. Leave the Clear Date Time field empty for now. This field is populated by the system when an end-user is clearing previous problems.
  2. Select the time option (Modified after Clear Date Time)
  3. Check the 'Lines have a DateTime' checkbox
  4. 'Match date' (the date, in this case, the format is 2023-09-21T10:48:22.9112818+02:00)
([0-9]{4}-[0-9]{2}-[0-9]{2}[T\s]?[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{7}(\+[0-9]{2}:[0-9]{2})?)

The date is required if you want to ignore previous errors. You can ignore previous errors by clicking the Clear menu item in the Actions button on the Resource.

Warning if previous lines in the text files are ignored
A RegEx for the Date time is required to understand how to parse the date time for rows in the text file.
5. 'Matched date groups': 1

Time options tab

Save

You must click 'Save' or 'Save and close' for changes to persist. The new settings/thresholds are evaluated on the next synchronization.
Save and Close buttons
Here's an example of the Save options.

Note

The delay in presenting the new evaluated state depends on the monitoring agent's synchronization interval

Save and close, save, and close the dialogue.
Cancel, closes the dialogue without saving any changes.

Step 5: Configure the Monitor View

Next, add the named Resource to a Monitor View.

Errors detected
Here's an example of a Nodinite Monitor View with errors detected in any Nodinite diagnostic log file

You can further review the details about the errors by clicking on the Actions button, and then clicking on the Error report menu item.
Error report Action menu item

This action opens a new modal with a list of all Nodinite diagnostic log files where a match exists (> last clear date-time).
Error report

Additional information is available if you expand the row.
Details

Tip

You can ignore old errors; by clicking on the Clear Errors menu item in the Actions button. The Resource is then in the OK state until an entry matching the configuration is later found.

Step 6: Manage Diagnostic Log Files

To view the set of diagnostics files included in the Monitoring, click the Actions button, and then, the Show Log file(s) menu item.
Show Log File(s) menu item

Next, a screen presents including a table with all the Nodinite diagnostics log files.
Log Files

You can perform the following Actions on the diagnostic files:

Next Step

Nodinite File Monitoring Agent