Release Notes

Prerequisites for the Pickup LogEvents Service Logging Agent

This page describes the prerequisites to successfully install and run the Nodinite Pickup LogEvents Service Logging Agent.

Instances of this agent can be installed on-premise using TCP/IP for local network access and/or in the cloud/off-site using Service Bus Relaying (see also the external link for additional information MicrosoftServiceBusRelayingLink) as long as the Log API can be accessed on the configured port. For high performance installations where Log Events are sent directly to the database the Pickup LogEvents Service Logging Agent should be installed near the database (i.e. on the same network as Nodinite).

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

Software Requirements

Versions 6.0 and later make use of the .NET Framework 4.8 or later.
Versions 5.4 and subsequently make use of the .NET Framework 4.6.2 or later.
Versions before 5.4 make use of the .NET Framework 4.5.2 or later.

What AnypointMQ User rights does the Pickup LogEvents Service Logging Agent require?

• The agent uses either basic authentication or connected apps, and you must have configured an account with Admin* rights

  • User name

  • Password

  • Client Id ^{New 6.0.2.0}

  • Client Secret^{New 6.0.2.0}

Read more about Security for AnypointMQ here

What ActiveMQ User rights does the Pickup LogEvents Service Logging Agent require?

• The agent uses basic authentication and you must have configured an account with Admin rights
  • User name
  • Password

Read more about Security for ActiveMQ here

What Azure Event Hub User rights does the Pickup LogEvents Service Logging Agent require?

• The Pickup LogEvents Service Logging Agent uses a Service Bus Connection string with SAS token credentials The claims must be set as
  • Manage
  • Listen

For RBAC control: Assign an Azure role for access to blob data

• Storage Blob Data Reader or Storage Blob Data Contributor
• The Azure Resource Manager Reader role, at a minimum

What Azure Service Bus User rights does the Pickup LogEvents Service Logging Agent require?

• The Pickup LogEvents Service Logging Agent uses a Service Bus Connection string with SAS token credentials The claims must be set as
  • Manage
  • Listen

What MSMQ User rights does the Pickup LogEvents Service Logging Agent require?

• The agent uses integrated security hence the Windows service account used for the Pickup LogEvents Service Logging Agent must have appropriate user rights on target queues
  • Peek
  • Read
  • Delete

What File User rights does the Pickup LogEvents Service Logging Agent require?

• The agent uses integrated security hence the Windows service account used for the Pickup LogEvents Service Logging Agent must have appropriate user rights on file shares
  • Read
  • Write
  • Delete

What PostgreSQL database User Rights does the Pickup LogEvents Service Logging Agent require?

• The Pickup LogEvents Service Logging Agent uses credentials provided by the Configuration. The account being used to logon must have logon, read and write access to the table with the JSON Log Events

What SQL Server database User Rights does the Pickup LogEvents Service Logging Agent require?

• The Pickup LogEvents Service Logging Agent uses credentials provided by the Configuration. The account being used to logon must have logon, read and write access to the table with the JSON Log Events
• public - right to logon
• db_datareader - right to read
• db_datawriter - right to write
• db_ddladmin - better performance

Supported Versions

Cloud technologies are evolving fast and Microsoft deprecates older versions of their API's every now and then. Nodinite will always support the API's supported by Microsoft. This means you need to update Nodinite and our Pickup LogEvents Service Logging Agent from time to time.

What Windows User Rights does the Pickup LogEvents Service Logging Agent require?

The agent is installed as a Windows Service usually on the Nodinite application server. Virtual machines are supported.

• Local named account or domain account (preferred).
• Access and run-time rights
  • Follow the 'How to set logon as a Windows service right' user guide for detailed instructions.

What Nodinite SQL user rights does the Pickup LogEvents Service Logging Agent require?

IF you are bypassing the Log API for performance reasons (only valid reason) then the account running the Pickup LogEvents Service Logging Agent must have the following rights assigned

db_ddladmin is required for the service account to have proper rights to read statistics. Without this permission, performance may be degraded, especially true for remote servers (linked servers). Read more here. Contact our support if you have any questions about this.

All Nodinite specific databases

• Configuration Database

  • db_datareader
  • db_datawriter
  • db_ddladmin
  • Grant Execute rights on all existing and future stored procedures:

  GRANT EXECUTE TO [Domain\user]
  

  Replace [Domain\user] with the Windows account being used for the Pickup LogEvents Service Logging Agent

• Log Databases (can be multiple )

  • db_datareader
  • db_datawriter
  • db_ddladmin

What Firewall settings are required for the Pickup LogEvents Service Logging Agent?

Regardless of Source for Log Events the Pickup LogEvents Service Logging Agent uses DNS.

• DNS - Windows needs to know where your servers are (can of course also be solved using hosts)
  • 53 both TCP/UDP

The Pickup LogEvents Service Logging Agent has both inbound and outbound communication:

1. Between the Pickup LogEvents Service Logging Agent and the ActiveMQ broker(s)
2. Between the Pickup LogEvents Service Logging Agent and the Anypoint MQ service
3. Between the Pickup LogEvents Service Logging Agent and the Azure Event Hub and Storage
4. Between the Pickup LogEvents Service Logging Agent and Azure Management API (Service Bus)
5. Between the Pickup LogEvents Service Logging Agent and the File share(s)
6. Between the Pickup LogEvents Service Logging Agent and the MSMQ Server(s)
7. Between the Pickup LogEvents Service Logging Agent and the PostgreSQL database instances
8. Between the Pickup LogEvents Service Logging Agent and the SQL Server database instances
9. Between the Pickup LogEvents Service Logging Agent and the Configuration Database
10. Between the Pickup LogEvents Service Logging Agent and the Log API

• ActiveMQs
• AnypointMQs
• EventHubs
• Service Bus Queues
• Folders
• MSMQs
• PostgreSQLs
• SQLServers

1. Between the Pickup LogEvents Service Logging Agent and the ActiveMQ broker(s)

If you use SSL or custom ports then additional ports needs to be opened

2. Between the Pickup LogEvents Service Logging Agent and the Anypoint MQ service

3. Between the Pickup LogEvents Service Logging Agent and the Event Hub service

The following ports must be open for outbound communication with '*.servicebus.windows.net' from both on-premise and off-site Windows Servers where Agent is installed:

Event Hub

Troubleshooting guide: https://learn.microsoft.com/en-us/azure/event-hubs/troubleshooting-guide

Storage

The Administrator may have one or more rules in place in any of the following locations:

• Virtual Machine
• Storage Account
• Virtual Network

If you have enabled rules, you may need to tune these to allow communication.

Troubleshooting guide: Configure Azure Storage firewalls and virtual networks

4. Between the Pickup LogEvents Service Logging Agent and Service Bus

Used for Event Hub and Azure Storage, review the Event Hubs frequently asked questions

Please review the Microsoft Azure Management API for additional information.

If you have secured your Azure Storage you may need to allow the IP address facing Internet from where the Pickup LogEvents Service Logging Agent, please review the following user guide: Configure Azure Storage firewalls and virtual networks

5. Between the Pickup LogEvents Service Logging Agent and the File share(s)

If you write Log Events to file (a remote file share) then you the Pickup LogEvents Service Logging Agent will use the SMB protocol to access the remote file share. The following TCP ports must be open

For the full documentation, please visit the Microsoft SMB: File and printer sharing ports should be open page and Internet firewalls can prevent browsing and file sharing

6. Between the Pickup LogEvents Service Logging Agent and the MSMQ Server(s)

´*´ Review the Microsoft guide here

7. Between the Pickup LogEvents Service Logging Agent and PostgreSQL instance

PostgreSQL is by default using TCP port 5432 to listen for incoming calls.

8. Between the Pickup LogEvents Service Logging Agent and SQL Server instance

Any SQL Server instance with the [LogEvents] table.

9. Between the Pickup LogEvents Service Logging Agent and the Log API

• When Logging is enabled the Pickup LogEvents Service Logging Agent requires one of the following outbound TCP ports to be open for access the Log Api (configurable)

If the Pickup LogEvents Service Logging Agent and the Log API is on the same server you should stick with http for performance since information is not visible outside the server

10. Between the Pickup LogEvents Service Logging Agent and the Configuration Database

In this paragraph you will learn about communcation between the Nodinite Pickup LogEvents Service Logging Agent and the Nodinite Configuration Database.

Frequently asked questions

Additional solutions to common problems and the FAQ for the Nodinite Pickup LogEvents Service Logging Agent exist in the Troubleshooting user guide.

Make sure to subscribe to our Release Notes

Next Step

Install the Pickup LogEvents Service Logging Agent

Related

Administration