PRTG is a powerful monitoring solution that analyzes your entire IT infrastructure, monitors your network, performance, hardware, cloud, databases, applications, etc.
This document provides information about the PRTG connector, which facilitates automated interactions, with a PRTG server using FortiSOAR™ playbooks. Add the PRTG connector as a step in FortiSOAR™ playbooks and perform automated operations, such as retrieving details for a specific object type such as device or sensor, or scanning a sensor based on the sensor ID you have specified.
Connector Version: 1.0.0
FortiSOAR™ Version Tested on: 4.11.0-1161
Authored By:Fortinet
Certified: Yes
All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:
yum install cyops-connector-prtg
For the detailed procedure to install a connector, click here
For the procedure to configure a connector, click here
In FortiSOAR™ , on the connectors page, select the PRTG connector and click Configure to configure the following parameters:
Parameter | Description |
---|---|
Server URL | URL of the PRTG server to which you will connect and perform the automated operations. |
Username | Username to access the PRTG server to which you will connect and perform the automated operations. |
Authentication Type | Select the authentication type that you want to use to access the PRTG server to which you will connect and perform the automated operations. You can choose between Password or Passhash. |
Value | Value of the Password or Passhash, depending on the Authentication Type that you have selected, that is used to access the PRTG server to which you will connect and perform the automated operations. |
Verify SSL | Specifies whether the SSL certificate for the server is to be verified or not. By default, this option is set as True. |
The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 and onwards:
Function | Description | Annotation and Category |
---|---|---|
List Object Details | Retrieves detailed information for a selected content type such as device or sensor from PRTG, based on the input parameters you have specified. | list_object_details Investigation |
Get Sensors Status | Retrieves the status of a sensor from PRTG, based on the sensor ID you have specified. | get_sensors_status Investigation |
Pause Sensor | Pauses a sensor on PRTG based on the sensor ID and other input parameters you have specified. | pause_sensor Investigation |
Resume Sensor | Resumes a sensor on PRTG based on the sensor ID you have specified. | resume_sensor Investigation |
Acknowledge Alarm | Marks a sensor as acknowledged on PRTG based on the sensor ID and message you have specified. | acknowledge_alarm Investigation |
Scan Sensor | Scans a sensor on PRTG based on the sensor ID you have specified. | scan_sensor Investigation |
Run Auto Discovery | Runs auto discovery on an existing object in PRTG based on the Device ID or Group ID you have specified. | run_auto_discovery Investigation |
Parameter | Description |
---|---|
Content Type | Choose the content type from one of the following: Channels, Devices, Messages, Reports, Sensors, Sys Info, Stored Reports, Tickets, or Top Lists. |
Filter Status | (Optional) Filters out sensors based on the sensor status you have selected. For example, if you select Up, then information for only those sensors whose status is up will be retrieved from PRTG. Note: This field is visible only when you have selected the Content Type as Sensor. |
Filter Tags | (Optional) Filters out sensors based on the sensor tags you have listed. You can provide a csv list of tags based on which sensor will be filtered out while retrieving information from PRTG. Note: This field is visible only when you have selected the Content Type as Sensor. |
Last Seen | (Optional) Filters out messages or tickets based on the time frame you have selected. For example, if you select Yesterday, then information for only those messages or tickets that were last seen yesterday will be retrieved from PRTG. Note: This field is visible only when you have selected the Content Type as Messages or Tickets. |
Response Fields | (Optional) Fields (can select multiple fields) that you want to include in the response of this operation. |
Open Filter | (Optional) Open query to filter out data that you want to retrieve from PRTG. |
Start Index | (Optional) Start Index from where you want to retrieve results from PRTG. You can use this parameter with the Count parameter to request the data page by page. |
Count | (Optional) Maximum number of results that this operation should return. By default it is set at 500. |
Sort By | (Optional) Sort the results retrieved from PRTG server based on the specified column name. For example, name, lastvalue, uptime, priority, etc. |
The output contains a non-dictionary value.
Parameter | Description |
---|---|
Sensor ID | ID of the sensor whose status you want to retrieve from PRTG. |
The output contains the following populated JSON schema:
{
"result": {
"sensordata": {
"updowntotal": "",
"lastup": "",
"lastcheck": "",
"lastmessage": "",
"lastvalue": "-",
"parentdeviceid": "",
"name": "",
"parentgroupname": "",
"probename": "",
"statusid": "",
"uptime": "",
"uptimetime": "",
"info": "",
"favorite": "",
"updownsince": "",
"downtime": "",
"sensortype": "",
"parentdevicename": "",
"downtimetime": "",
"lastdown": "",
"interval": "",
"statustext": ""
},
"prtgversion": ""
},
"status": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to pause on PRTG. |
Duration | (Optional) Duration in minutes, for which you want to pause a sensor on PRTG. By default, this is set to "Indefinite". |
Message | (Optional) Message that you want to display when the user wants to pause the sensor. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to resume on PRTG. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to mark as acknowledged on PRTG. |
Message | (Optional) Message that you want to display when the user wants to mark the sensor as acknowledged. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to scan on PRTG. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Object ID | ID of an existing object (device or group) based on which you want to run auto discovery on PRTG. You can use the List Object Detail operation to get the Object ID. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
The Sample - PRTG - 1.0.0
playbook collection comes bundled with the PRTG connector. These playbooks contain steps using which you can perform all supported actions. You can see bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the PRTG connector.
Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during connector upgrade and delete.
PRTG is a powerful monitoring solution that analyzes your entire IT infrastructure, monitors your network, performance, hardware, cloud, databases, applications, etc.
This document provides information about the PRTG connector, which facilitates automated interactions, with a PRTG server using FortiSOAR™ playbooks. Add the PRTG connector as a step in FortiSOAR™ playbooks and perform automated operations, such as retrieving details for a specific object type such as device or sensor, or scanning a sensor based on the sensor ID you have specified.
Connector Version: 1.0.0
FortiSOAR™ Version Tested on: 4.11.0-1161
Authored By:Fortinet
Certified: Yes
All connectors provided by FortiSOAR™ are delivered using a FortiSOAR™ repository. Therefore, you must set up your FortiSOAR™ repository and use the yum command to install connectors:
yum install cyops-connector-prtg
For the detailed procedure to install a connector, click here
For the procedure to configure a connector, click here
In FortiSOAR™ , on the connectors page, select the PRTG connector and click Configure to configure the following parameters:
Parameter | Description |
---|---|
Server URL | URL of the PRTG server to which you will connect and perform the automated operations. |
Username | Username to access the PRTG server to which you will connect and perform the automated operations. |
Authentication Type | Select the authentication type that you want to use to access the PRTG server to which you will connect and perform the automated operations. You can choose between Password or Passhash. |
Value | Value of the Password or Passhash, depending on the Authentication Type that you have selected, that is used to access the PRTG server to which you will connect and perform the automated operations. |
Verify SSL | Specifies whether the SSL certificate for the server is to be verified or not. By default, this option is set as True. |
The following automated operations can be included in playbooks, and you can also use the annotations to access operations from FortiSOAR™ release 4.10.0 and onwards:
Function | Description | Annotation and Category |
---|---|---|
List Object Details | Retrieves detailed information for a selected content type such as device or sensor from PRTG, based on the input parameters you have specified. | list_object_details Investigation |
Get Sensors Status | Retrieves the status of a sensor from PRTG, based on the sensor ID you have specified. | get_sensors_status Investigation |
Pause Sensor | Pauses a sensor on PRTG based on the sensor ID and other input parameters you have specified. | pause_sensor Investigation |
Resume Sensor | Resumes a sensor on PRTG based on the sensor ID you have specified. | resume_sensor Investigation |
Acknowledge Alarm | Marks a sensor as acknowledged on PRTG based on the sensor ID and message you have specified. | acknowledge_alarm Investigation |
Scan Sensor | Scans a sensor on PRTG based on the sensor ID you have specified. | scan_sensor Investigation |
Run Auto Discovery | Runs auto discovery on an existing object in PRTG based on the Device ID or Group ID you have specified. | run_auto_discovery Investigation |
Parameter | Description |
---|---|
Content Type | Choose the content type from one of the following: Channels, Devices, Messages, Reports, Sensors, Sys Info, Stored Reports, Tickets, or Top Lists. |
Filter Status | (Optional) Filters out sensors based on the sensor status you have selected. For example, if you select Up, then information for only those sensors whose status is up will be retrieved from PRTG. Note: This field is visible only when you have selected the Content Type as Sensor. |
Filter Tags | (Optional) Filters out sensors based on the sensor tags you have listed. You can provide a csv list of tags based on which sensor will be filtered out while retrieving information from PRTG. Note: This field is visible only when you have selected the Content Type as Sensor. |
Last Seen | (Optional) Filters out messages or tickets based on the time frame you have selected. For example, if you select Yesterday, then information for only those messages or tickets that were last seen yesterday will be retrieved from PRTG. Note: This field is visible only when you have selected the Content Type as Messages or Tickets. |
Response Fields | (Optional) Fields (can select multiple fields) that you want to include in the response of this operation. |
Open Filter | (Optional) Open query to filter out data that you want to retrieve from PRTG. |
Start Index | (Optional) Start Index from where you want to retrieve results from PRTG. You can use this parameter with the Count parameter to request the data page by page. |
Count | (Optional) Maximum number of results that this operation should return. By default it is set at 500. |
Sort By | (Optional) Sort the results retrieved from PRTG server based on the specified column name. For example, name, lastvalue, uptime, priority, etc. |
The output contains a non-dictionary value.
Parameter | Description |
---|---|
Sensor ID | ID of the sensor whose status you want to retrieve from PRTG. |
The output contains the following populated JSON schema:
{
"result": {
"sensordata": {
"updowntotal": "",
"lastup": "",
"lastcheck": "",
"lastmessage": "",
"lastvalue": "-",
"parentdeviceid": "",
"name": "",
"parentgroupname": "",
"probename": "",
"statusid": "",
"uptime": "",
"uptimetime": "",
"info": "",
"favorite": "",
"updownsince": "",
"downtime": "",
"sensortype": "",
"parentdevicename": "",
"downtimetime": "",
"lastdown": "",
"interval": "",
"statustext": ""
},
"prtgversion": ""
},
"status": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to pause on PRTG. |
Duration | (Optional) Duration in minutes, for which you want to pause a sensor on PRTG. By default, this is set to "Indefinite". |
Message | (Optional) Message that you want to display when the user wants to pause the sensor. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to resume on PRTG. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to mark as acknowledged on PRTG. |
Message | (Optional) Message that you want to display when the user wants to mark the sensor as acknowledged. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Sensor ID | ID of the sensor that you want to scan on PRTG. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
Parameter | Description |
---|---|
Object ID | ID of an existing object (device or group) based on which you want to run auto discovery on PRTG. You can use the List Object Detail operation to get the Object ID. |
The output contains the following populated JSON schema:
{
"status": "",
"message": ""
}
The Sample - PRTG - 1.0.0
playbook collection comes bundled with the PRTG connector. These playbooks contain steps using which you can perform all supported actions. You can see bundled playbooks in the Automation > Playbooks section in FortiSOAR™ after importing the PRTG connector.
Note: If you are planning to use any of the sample playbooks in your environment, ensure that you clone those playbooks and move them to a different collection since the sample playbook collection gets deleted during connector upgrade and delete.