IPSentry - Information - Keywords
IPSentry uses a set of key words to represent
machine, server, device, and other information unique to a given event.
These variables are useful for email messages, alpha pager messages, Add-Ins, and
launching external commands by using some of these items in the command line.
Here is a list of all IPSentry key-words supported and a description of their translation. Most of
the keys have a long and short version. The long version is used for
compatibility with previous versions of IPSentry (and sometimes just simple
clarity).
*Date / Time Formats: The date formats show a long and short date /
time format. These are based on your system settings for displaying
dates and times. See "regional settings" for information on this
format.
Keyword |
Short Key |
Description |
%IPS_NAME% |
%MN% |
The device name |
%MD% |
The description |
|
%IPS_NAME_NUM% |
Only the numeric characters (0-9) found within the device name field. |
|
%IPS_DESC_NUM% |
Only the numeric characters (0-9) found within the device description field. |
|
%MT% |
The TYPE of monitoring entry reported as: NETWORK = Network device/server SERVICE = NT Service Monitoring DRIVE = Drive Space Monitoring ADDIN = Add-In Monitoring |
|
%IA% |
The IP Address |
|
%IPS_PORT% |
%PO% |
The TCP Port |
%SN% |
The network share or local drive being monitored |
|
%DM% |
The drive mapping for the share of a drive monitor |
|
%IPS_DRIVESPACE% |
|
The amount of drive space
reported during the last check on the Driver monitoring item. (not
available for
non Drive type monitoring entries) |
%RT% |
This is the amount of time (in Milliseconds) from
the start of |
|
%AT% |
The title of a monitoring Add-In |
|
%AL% |
The class / interface name of the monitoring Add-In |
|
%AA% |
The arguments passed to the monitoring Add-In |
|
The NT Service Machine Name |
||
%NN% |
The NT Service Name |
|
%ND% |
The NT Service Description |
|
%MS% |
Device Status ("UP" or "DOWN") |
|
%SD% |
The current date in short system format |
|
%ST% |
The current time in short system format |
|
%LD% |
The current date in long system format |
|
%LT% |
The current time in long system format |
|
Current number of concurrent failures up to this point. |
||
Total Attempt to Connect to remote or initiate monitoring item. |
||
Total Failed attempts to connect to remote, or initiate the monitoring item. |
||
Total attempts to send data to remote system. |
||
Total Failed attempt to send data to remote system. |
||
Total attempts to receive data from remote item. |
||
Total Failed attempts to receive data from remote system. |
||
|
Total Attempt to Connect to remote or initiate monitoring item. (same as %IPS_CONNATTEMPT%) |
|
Grand total of all failures CONN + SEND + RECV giving total failures on device. |
||
%IPS_RATE% |
|
IPSentry success rate
###.##%. |
Last date (short format) of last statistics clearing. |
||
Last time (short format) of last statistics clearing. |
||
Last date (long format) of last statistics clearing. |
||
Last time (long format) of last statistics clearing. |
||
Last date (short format) of last attempt to check device. |
||
Last time (short format) of last attempt to check device. |
||
Last date (long format) of last attempt to check device. |
||
Last time (long format) of last attempt to check device. |
||
Last date (short format) of last successful attempt to check device. |
||
Last time (short format) of last successful attempt to check device. |
||
Last date (long format) of last successful attempt to check device. |
||
Last time (long format) of last successful attempt to check device. |
||
Last date (short format) of last failed attempt to check device. |
||
Last time (short format) of last failed attempt to check device. |
||
Last date (long format) of last failed attempt to check device. |
||
Last time (long format) of last failed attempt to check device. |
||
The number of times this specific alert has actually been fired since the last success (i.e. since the "First After" threshold was reached). This is not valid for use in the .HTI files. |
||
Total attempts processing alert. |
||
Total failed attempts processing alert. |
||
Total attempts processing alert. |
||
Total failed attempts processing alert. |
||
Total attempts processing alert. |
||
Total failed attempts processing alert. |
||
Total attempts processing alert. |
||
Total failed attempts processing alert. |
||
Total attempts processing alert. |
||
Total failed attempts processing alert. |
||
Total attempts processing alert. |
||
Total failed attempts processing alert. |
||
Total attempts processing alert. |
||
Total failed attempts processing alert. |
||
%YY% |
Year ## |
|
%YYYY% |
Year #### |
|
%MM% |
Month Number ## |
|
%MMM% |
Month Abbreviation (i.e. Jan ) |
|
%MMMM% |
Month Full (i.e. January) |
|
%DD% |
Day Of Month ## |
|
%DDD% |
Day of Week Abbreviation (i.e. Mon) |
|
%DDDD% |
Day of Week Full (i.e. Monday) |
|
%h% |
Hour of day ## |
|
%m% |
Minute of Hour ## |
|
%s% |
Second of Minute ## |
|
Specifies the
"FIRST" (n) characters of the data received - or other
monitoring information. |
||
|
Specifies the
"LAST" (n) characters of the data received - or other
monitoring information. ie: %IPS_RECV_L20% would return the last 20 characters of the data received from the remote host. |
|
Keys specific to the .HTI report files. |
||
Keyword |
File |
Description |
(STAT_S.HTI) |
Date (long format) of report run. |
|
(STAT_S.HTI) |
Time (short format) of report run. |
|
(STAT_S.HTI) |
This is an internal variable used in this file only which is converted to one insertion of the (STATLINE.HTI) for each machine. |
|
(STATLINE.HTI) |
Converted to up.gif or down.gif based on state of monitored device. |
|
(STATLINE.HTI) |
Textual Up, Down, or Suspended |
|
(STATLINE.HTI) |
For down machines, this will be "red", for up machines, this will be "green" |
|
(STATLINE.HTI) |
Each entry has a TYPE image
and a TYPE_DOWN image associated to the monitored device type (Network,
Drive, Service, Add-In) This variable will be set to the
respective .gif |
|
(STATLINE.HTI) |
Converted to formated Machine Name and associated specifics based on type (i.e. Drive, ShareName, DriveMap for Drive Space monitoring) |
|
(STATLINE.HTI) |
Last Attempt Date |
|
(STATLINE.HTI) |
Last Attempt Time |
|
(STATLINE.HTI) |
Last Failure Date |
|
(STATLINE.HTI) |
Last Failure Time |
|
(STATLINE.HTI) |
Preformatted to |
|
%STAT_UPRATE4% |
(STATLINE.HTI) |
Preformatted to 4 decimal
places. |
|
||
Contact: support@ipsentry.com | https://ipsentry.com | © 2006 by RGE, Inc. - All Rights Reserved |