How To - Use IPSentry keywords effectively
* KEYWORDS are Case Sensitive - use all lower case for keywords.
When making use of text alert messaging, IPSentry provides a large set of keywords
that are converted to their associated values before the alert is actually triggered.
range from machine specific information such as name, description, IP Address to date/time information.
By making use of these keywords
, you avoid many of the pitfalls associated with alerts containing highly specific information that must be changed from machine to machine. When you change the name of a machine for example, the message being sent should also contain the new name without you having to load the alert configurations and edit the name in each location.
Keep this in mind, especially with Email
and Alpha Pager
Yes, you could setup email alerts with the subject of ThisMachine is DOWN, but what if you changed the machine name from "ThisMachine" to "ThatMachine" AND you wanted to send a success alert?
A better entry would be %%mach.name% is %%mach.state%%. Now, when the alert is triggered, the %%mach.name%% will be replaced with the current machine name, and the %%mach.state%% will be replaced with the current state of the machine "OK" or "CRITICAL". So, when the machine is down, %%mach.state%% will say DOWN, and when it is up, it would be "OK". If you changed the machine name to BALLARD, then %%mach.name%% would be changed to BALLARD.
Once you begin using keywords
, keep in mind some limitation that may exists especially with Alpha pagers. Some servers have message length limitations of 80 or less characters. In this case, the remaining portion of the message will be truncated. You should put the most important and identifiable information at the beginning of messages to avoid potential loss of critical information such as NAME and STATE. You can then follow that up with Date, Time, an other available keywords
based on the type of entry.
Also keep in mind what values can be represented by the type of entry being monitored. Drive space monitors do not have IP Address or Port fields, so using the %%mach.net.port%% would be useless for a drive monitor.
These are just a couple things to keep in mind when using IPSentry keywords