- 6 minutes to read

Prerequisites for the Nodinite Log File Parser Monitoring Agent

Unlock seamless, secure, and scalable log file monitoring with the Nodinite Log File Parser Monitoring Agent. On this page, you will:

  • ✅ Understand all system and network requirements for a smooth installation
  • ✅ Learn how to configure user rights and firewall settings for robust security
  • ✅ Discover best practices for deploying the agent on-premise or in the cloud
  • ✅ Ensure compliance and minimize troubleshooting with clear, actionable guidance

This page details everything you need to successfully install and run the Nodinite Log File Parser Monitoring Agent.

graph LR subgraph "Nodinite" roNI(fa:fa-code-commit Log File Parser) --- roMonitor[fa:fa-monitor-waveform Monitoring] end subgraph "SMB Share B" roMonitor --- | Firewall/Security | roF2(fa:fa-folder Folder Y) roF2 --- ro2(fab:fa-java .log) roMonitor --- | Firewall/Security | roF3(fa:fa-folder Folder Z) roF3 --- ro3("fa:fa-file-csv .csv") end subgraph "SMB Share A" roMonitor --- | Firewall/Security | roF1(fa:fa-folder Folder X) roF1 --- ro1(fa:fa-file-alt .txt) end

Architecture: The Log File Parser Monitoring Agent connects securely to multiple SMB shares and folders, enabling end-to-end monitoring of diverse log file formats.

Please use RegEx101 or a similar tool to test your RegEx expressions. You must practice RegEx to use this agent effectively.

You can install instances of this agent on-premise using TCP/IP for local network access, or in the cloud/off-site using Service Bus Relaying.

We recommend that you keep this agent close to the installation of Nodinite Core Services. This documentation covers local network setup (usually on the Nodinite application server)

Verified Topic
Software Requirements
What Windows User Rights does the Log File Parser Monitoring agent require?
What Firewall settings are required for the Log File Parser Monitoring agent?

Software Requirements

Versions 7.0.4 and later require .NET 10 Hosting Bundle.

Product Comment
Windows Server Windows 2025
Windows 2022
Windows 2019
Windows 2016
Windows 2012 R2
Windows 2012
.NET 10 Hosting Bundle New 7.0.4 Required for v7.0.4 and later. Download from Microsoft
.NET Framework .NET Framework 4.8 or later New 6.0
Our recommendation is .NET Framework 4.8.1 or later

Versions 7.0.4 and later require .NET 10 Hosting Bundle.
.NET 10 minimum OS: Windows Server 2012 / 2012 R2.
Versions 6.0 and later require .NET Framework 4.8 or later.
Versions 5.4 and later require .NET Framework 4.6.2 or later.
Versions before 5.4 require .NET Framework 4.5.2 or later.

What Windows User Rights does the Log File Parser Monitoring agent require?

You install the agent as a Windows Service, typically on the Nodinite application server. Virtual machines are fully supported.

Service Account Options New 7.0.4:

Least privileges (basic usage)

  • Grant read permission to the folder where you want to check for files (and all its child folders if the 'Include child folders' option is checked)

What Firewall settings are required for the Log File Parser Monitoring agent?

Where you install the Nodinite Log File Parser Monitoring Agent in relation to the Nodinite Monitoring Service and the file shares with your log files determines your firewall configuration. The diagram shows every host involved, with the agent on its own server; each arrow starts at the side that opens the connection.

graph LR subgraph "Nodinite Core Services Server" roMonitoringService(fa:fa-watch-fitness Monitoring Service) end subgraph "Nodinite Agent Server" roAgent(fa:fa-code-commit Log File Parser Monitoring Agent) end subgraph "Target: File Server (SMB)" roF1(fa:fa-folder Log file folders) end subgraph "Domain Controller" roDC(fa:fa-building Active Directory) end subgraph "DNS Server" roDNS(fa:fa-signs-post DNS) end subgraph "Azure Service Bus Relay (optional)" roRelay(fa:fa-cloud Relay namespace) end roMonitoringService --> |"Agent site port (v7) / 8000 (v6)"| roAgent roAgent --> |"445 (135-139 legacy)"| roF1 roAgent -.-> |"88, 389, 636"| roDC roAgent --> |"53"| roDNS roMonitoringService -.-> |"443, 5671-5672, 9350-9354"| roRelay roAgent -.-> |"443, 5671-5672, 9350-9354"| roRelay

Network diagram: the Monitoring Service calls the agent, and the agent reads the log files on the SMB shares. Dashed arrows are optional hops.

Note

When the agent runs on the Core Services Server (the typical installation), you need no firewall rule between the Monitoring Service and the agent. Log files on local disks of the Agent Server need no firewall rule at all.

Between the Monitoring Service and the Log File Parser Monitoring Agent

The Monitoring Service opens every connection; the agent never calls it. On Windows Server, Nodinite v7 hosts the agent as its own IIS web site, on a port you set per environment in the Nodinite Portal (Servers step).

Direction Source Destination Protocol Port(s) Purpose Notes
Inbound Core Services Server Agent Server TCP (HTTPS/HTTP) Agent site port Poll the agent, send configuration, run Remote Actions v7. No fixed default; use the port set in the Portal. Only when the agent is on a remote server
Inbound Core Services Server Agent Server TCP 8000 Same, for Windows Service agents ⚠️ v6 and earlier only (legacy MSI installer on remote servers)

Option: Service Bus Relaying (cloud or hybrid)

Use Service Bus Relayed connections when Nodinite and the agent are on different networks. Both sides connect outbound to the Azure Relay namespace, so neither server needs an inbound rule. Nodinite uses the same principle as the on-premises data gateway; see 'Adjust communication settings for the on-premises data gateway' and the 'Azure Relay FAQs'.

Direction Source Destination Protocol Port(s) Purpose Notes
Outbound Agent Server Azure Relay (*.servicebus.windows.net) TCP 443 HTTPS All versions
Outbound Agent Server Azure Relay (*.servicebus.windows.net) TCP 5671, 5672 Secure AMQP All versions
Outbound Agent Server Azure Relay (*.servicebus.windows.net) TCP 9350 - 9354 Net.TCP All versions
Outbound Core Services Server Azure Relay (*.servicebus.windows.net) TCP 443, 5671, 5672, 9350 - 9354 Monitoring Service side of the relay Same ports as the Agent Server

Between the Log File Parser Monitoring Agent and the log file folders

Required when the log files are on a Windows file share or a Samba share.

Direction Source Destination Protocol Port(s) Purpose Notes
Outbound Agent Server Target (File Server) TCP 445 Direct-hosted SMB (SMB 2/3) Recommended
Outbound Agent Server Target (File Server) TCP/UDP 135-139 Microsoft file sharing (NetBIOS) Legacy SMB 1.0/CIFS only; consider disabling SMB 1.0
Inbound Target (File Server) Agent Server TCP/UDP 135-139, 445 Response traffic Automatically allowed by stateful firewall inspection

Tip

Log File Locations: Grant the agent service account Read permissions on all target folders and their child folders (if the 'Include child folders' option is enabled).

Between the Log File Parser Monitoring Agent and the Domain Controller

Required when the agent's service account is a domain account or gMSA that accesses the SMB shares.

Direction Source Destination Protocol Port(s) Purpose Notes
Outbound Agent Server Domain Controller TCP/UDP 88 Kerberos authentication Required for domain authentication
Outbound Agent Server Domain Controller TCP/UDP 389 LDAP Standard LDAP queries
Outbound Agent Server Domain Controller TCP 636 LDAPS (Secure LDAP) Required for LDAPS authentication
Inbound Domain Controller Agent Server TCP/UDP Same as outbound Response to Kerberos / LDAP Usually allowed by stateful firewall inspection

Between the servers and DNS

Direction Source Destination Protocol Port(s) Purpose Notes
Outbound Agent Server DNS Server TCP/UDP 53 Name resolution Resolve the file servers, the Domain Controller, the Core Services Server, and (with relaying) *.servicebus.windows.net. A local hosts file can replace DNS
Outbound Core Services Server DNS Server TCP/UDP 53 Name resolution Resolve the Agent Server

Important

Stateful Firewalls: Most Windows Firewall implementations are stateful, so response traffic for established outbound connections is allowed automatically. The inbound response rules above are for reference and troubleshooting.


Next Steps

Install Log File Parser Monitoring Agent

Add or manage a Monitoring Agent Configuration
Monitoring
Administration