PRTG Network Monitor

The PRTG Network Monitor connector allows you to retrieve network monitoring data from your PRTG instance.

Overview

The PRTG Network Monitor connector enables you to collect the following information:

• Monitored equipment inventory
• Sensor status
• Network alerts

Prerequisites

• Access to a PRTG Network Monitor instance
• PRTG API token OR user credentials/password
• Network access to PRTG server

Information to provide in OverSOC

Note: You must provide either an API Token or a Username/Password combination, but not both.

Procedure

Option 1: Use Username with Passhash (recommended)

1. Log in to your PRTG console.
2. Navigate to Setup > Account Settings > My Account.
3. Click Show passhash to reveal your Passhash value.
4. Alternatively, retrieve the passhash programmatically using:

   https://yourserver/api/getpasshash.htm?username=myuser&password=mypassword
   

Option 2: Use API Token

1. Log in to your PRTG console.
2. Navigate to Setup > Notification > API Token.
3. Click Create new token.
4. Name the token (e.g., OverSOC Connector).
5. Configure access rights:
   • Objects: Read
   • Reports: Read
6. Click Save and note the token value.

Configure the connector in OverSOC

1. In OverSOC, go to Data Sources Settings > Sources.
2. Select PRTG Network Monitor and click Configure.
3. Fill in the required fields:
   • Server URL: https://yourserver (e.g., https://prtg.example.com)
   • Username: Your PRTG username
   • Passhash: Your passhash (preferred over password)
   • API Token (optional): If using token-based authentication instead
4. Click Save Configuration.

Note: API calls use the format: https://yourserver/api/[endpoint].json?username=myuser&passhash=hash

Reference: PRTG HTTP API Documentation

Required Permissions

The authentication method used must have the following minimum permissions:

• Read access to object inventory
• Access to sensor statuses
• Access to alerts and notifications