Configuring a Remote Data Processor

A Remote Data Processor (RDP) is a service that is used to connect to data sources that require integrations from a Windows environment and/or run from behind a firewall that sits in between Metric Insights and the data source.

NOTE: Beginning in v6.4.1, Java 17 must be installed on the RDP server.

Beginning in v6.4.2, RDP installer includes OpenJDK.

Overview

RDP Architecture Diagram.pdf

Port 32550 must be opened on Local DP for Metric Insights application and RDP to work correctly.

The main functions of the cluster are:

  • Collecting data with plugins
  • Saving the collected data to a storage

The cluster consists of two node types which communicate with each other via TLS protocol:

  • Local DP (Main node) - a docker container
  • RDP - a Windows service

Local DP performs the following functions:

  • Communicates with the UI part of the MI application (it contains a REST API which is used for communication with the web container)
  • Communicates with the databases: MySQL Dashboard Database (contains metadata) and MSSQL/MySQL Storage
  • Has a local data collector

RDP communicates with Data Sources behind firewall and Data Sources that use Windows API.

Configure a Remote Data Processor in MI

1. Create a New Remote Data Processor Profile

Access Admin > Collection & Storage > Remote Data Processors

NOTE: The UI and some fields might be displayed differently if you are using an older version of Metric Insights. Please ignore any configuration details for fields not present in your version of the application.

  1. [+ New Remote Data Processor]
  2. Enter a Name for your RDP
  3. RDP Host/IP: enter the hostname or the IP address of the machine where the RDP is installed
  4. [Save]

2. Open the Editor of New Remote Data Processor

3. Download and Run RDP Installer on Your Server

  1. [Download RDP Installer] and install RDP on your server
    • See the article regarding RDP installation on Windows.
  2. You can [Download config file] dp-<hostname>.json separately without downloading the whole installation package, if your configuration needs to be updated or if you are running multiple RDP services
  3. Click [Get Logs] to view the log file, or alternatively access log files manually:
    1. Access dataprocessor container
    2. cd /opt/mi/logs/:
      • application.log - data processor log file
      • insight.log - data collector log file
    3. cd /opt/mi/logs/container/:
      • tomcat-access.log - a list of REST API queries

4. Add Source Databases and Plugin Connection Profiles

You can add source Databases and Plugin Connection Profiles that will use the RDP by clicking [+ New Source Database] or [+ New Plugin Connection Profile].