What is this?

This knowledgebase contains questions and answers about PRTG Network Monitor and network monitoring in general.

Learn more

PRTG Network Monitor

Intuitive to Use. Easy to manage.
More than 500,000 users rely on Paessler PRTG every day. Find out how you can reduce cost, increase QoS and ease planning, as well.

Free Download

Top Tags


View all Tags

Self-configuration of PRTG with its APIs

Votes:

1

Some of our customers need to go very far in the finesse of monitoring their servers. And although PRTG already has many configuration options, they do not cover every need.

One of these needs is particularly problematic.

Use cases:

Some servers manage processes that more or less saturate their CPUs for the time that these processes must last. If a threshold is conventionally positioned, as soon as it is crossed, the sensor is in error. As outlined above, this is not necessarily a problem as long as the situation does not last beyond "usual" time.

Solution:

In this case, it is necessary to start by positioning at least one threshold for the channel of the CPU concerned and then to deactivate the limits. Two notifications are then created. One which will activate the limits according to the criteria that will be defined in the threshold trigger. Another one will deactivate them as soon as the threshold is crossed in the opposite direction.

Example: SetLimits_ON Notification

  • Execute HTTP Action checked
URL:https://dash01.domain.tld/api/setobjectproperty.htm
POST:id=%sensorid&subtype=channel&subid=0&name=limitmode&value=1&username=<username>&passhash=<hash>

Example: SetLimits_OFF Notification

  • Execute HTTP Action checked
URL:https://dash01.domain.tld/api/setobjectproperty.htm
POST:id=%sensorid&subtype=channel&subid=0&name=limitmode&value=0&username=<username>&passhash=<hash>

Threshold Trigger on CPU sensor

When Total (%) channel is Above 50 for at least 3600 seconds perform SetLimits_ON
When condition clears after a notification was triggered perform SetLimits_OFF
Points of Attention:

It is of course necessary that the account used has the right to modify the sensor concerned. It is also important to ensure that the internal URL is used so that the API call is made live and does not go through external components.

Feature Request:

This solution works but remains very manual and requires a configuration effort which makes it unserviceable in time. It would be preferable that it be integrated into PRTG notification management to ensure stability and make its configuration easy.

api http-action notifications prtg self-configuration

Created on May 31, 2017 8:15:37 AM

Last change on Jun 16, 2017 12:58:43 PM by Luciano Lingnau [Paessler]



3 Replies

Votes:

0

Hello Matthieu,

Thank you very much for sharing this.

A few remarks from my point of view:

  • If you don't require the sensor to go into down/error state, you can work with the threshold trigger alone and you would receive the email about the threshold being (b)reached, however the sensor will remain in OK state. But I assume this is what you want, when the threshold has been reached, to switch then the sensor into error state, which then activates a state trigger in place.
  • You don't necessarily need to create a POST action in the HTTP notification, you could enter the link like this: https://dash01.domain.tld/api/setobjectproperty.htm?id=%sensorid&subtype=channel&subid=0&name=limitmode&value=0&username=<username>&passhash=<hash>
  • When you do this, it must be ensured that limits existed beforehand in the sensor, otherwise it could happen that limits are being enabled, but the fields are empty, so you end up with non-effective limits. On a side-note for other readers of this thread: subid=0 inside the link reflects the numeric id of the channel in question you want to perform this action for. So when you do this, make sure to pick the correct id shown in the channel table for example on "Overview" tab of a sensor.
  • You need to keep in mind that once the HTTP action was perfomed, the error limits will remain enabled until you switch them back/disable them again.

Kind regards,

Erhard

Created on Jun 1, 2017 10:07:25 AM by Erhard Mikulik [Paessler Support]

Last change on Jun 16, 2017 12:59:12 PM by Luciano Lingnau [Paessler]



Votes:

0

Hello Erhard,

Thanks for your reply !

To complete your remark:

  • You are right. The changeover to error state is what is needed so that the calculation of SLA for example can take account of the incident and also simply so that this one appears on the dashboard of the administrators.
  • Thanks for the tip, I tought that the POST action was mandatory to use placeolders.
  • This is the whole subject of my feature request! It's a bit tedious to have to preconfigure thresholds. Additional request: it could be nice in threshold trigger to work on the mean value in the period in addition to the total value or primary channel.

Sincerely yours,

Matthieu

Created on Jun 16, 2017 12:28:04 PM

Last change on Jun 16, 2017 12:54:33 PM by Luciano Lingnau [Paessler]



Votes:

0

Hello Matthieu,

Does PRTG's unusual detection not detect when average values are being "violated" in this particular sensor? OK, it might take a few weeks until unusual detection starts to detect "anomalies" in a sensor, because it establishes a baseline over several weeks to notice when traffic is unusually high or low for a particular time of day for example.

Regarding this whole "Go into error with thresholds/go into error when limit was (b)reached for x times" is not something that we will see anytime soon I'm afraid. Demand is there indeed for this feature, however it was not high enough so far to put efforts into it, so for now I won't expect this to change in the near future.

Kind regards,

Erhard

Created on Jun 19, 2017 2:08:45 PM by Erhard Mikulik [Paessler Support]




Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.