Definition file for JP1/SLM-linkage custom monitoring items (monitoringitems.cfg)
- Organization of this page
Function
A custom monitoring item is a record field specified and defined by the user when a value not present in the default monitoring items needs to be analyzed in JP1/SLM. You can define a maximum of 54 custom monitoring items for each PFM - Agent and PFM - RM type and data model.
Name of file
monitoringitems.cfg (Definition file for JP1/SLM-linkage custom monitoring items)
Location
- In Windows:
-
-
On physical hosts:
installation-folder\ITSLM\
-
On logical hosts:
environment-directory\jp1pc\ITSLM\
-
- In UNIX:
-
-
On physical hosts:
/opt/jp1pc/ITSLM/
-
On logical hosts:
environment-directory/jp1pc/ITSLM/
-
Notes
The following rules apply to the definition file for JP1/SLM-linkage custom monitoring items (monitoringitems.cfg):
-
Specify setting values in the format label-name=setting-value.
-
All blank characters (spaces, tabs, vertical tabs, or form feed characters) before or after the label name or setting value are ignored.
-
Character strings beginning with a hash mark (#), excluding leading blank characters, are treated as comments.
-
CR, LF, or CRLF are accepted as line feed codes, but you must use the same line feed code consistently within the file. If you use more than one type of line feed code, errors might occur in items that are actually correct. Also, the line number indicating the location of an error in an error message might differ from the line number displayed in an editor.
-
Lines consisting only of a line feed code, or of a line feed code preceded by a blank character, are ignored.
-
The value of an optional label is assumed to be unspecified if you omit the entire label or if you write the label name without writing the value. In the latter case, the label name must be followed by an equals sign (=).
-
If something does not follow the input rules, such as a [[Monitoring Item]] subsection without an [Agent] section, the entire definition file for JP1/SLM-linkage custom monitoring items is invalid.
-
If the Product label is missing or if a value is unspecified in an [Agent] section, the [Agent] section itself and all [[Monitoring Item]] subsections under it are invalid.
-
If a label is written more than once in a [[Monitoring Item]] subsection, the [[Monitoring Item]] subsection is invalid.
-
If a mandatory label is missing or if a value is incorrectly specified in a [[Monitoring Item]] subsection, the [[Monitoring Item]] subsection is invalid.
-
Labels can be written in any order within a [[Monitoring Item]] subsection. Changing their order has no effect on operation.
-
If the values set for a PFM - Agent or PFM - RM type, data model version, record, and field match the definition of a default monitoring item, the default monitoring item is ignored and only the values set for the custom monitoring item are valid.
-
If the same definition is set multiple times for a PFM - Agent or PFM - RM type, data model version, record, and field, only the first definition closest to the top of the file is valid.
How to modify
Setting items
Item |
Description |
||
---|---|---|---|
Section |
Subsection |
Label name |
|
-- |
-- |
ITSLM Monitoring Items Definition File Version |
Syntax version of the monitoring items definition file.
|
ITSLM Monitoring Items Definition File Code#1 |
Character encoding in which the monitoring items definition file is written.
|
||
[Agent] |
-- |
-- |
Represents the section name and cannot be changed. Write a separate section for each PFM - Agent and PFM - RM product ID and data model version. |
Product |
PFM - Agent or PFM - RM type or data model version
|
||
[[Monitoring Item]] |
-- |
Represents the subsection name and cannot be changed. Write a separate subsection for each monitoring item you are defining. A maximum of 54 monitoring items can be defined for each product ID and data model version. If you specify more than 54 valid monitoring items, the 55th and subsequent definitions will be ignored. |
|
Record |
The record to be monitored
|
||
Field#4 |
The record field to be monitored. If the same record and field is specified more than once, the definition closest to the top of the file will be used.
|
||
Key Field#4 |
Information that uniquely identifies the collected records. You can specify key fields only for multi-instance records. If specified for a single-instance record, the value will be ignored.
|
||
Display Name.ja |
Monitoring item name (Japanese) to be displayed in JP1/SLM
|
||
Display Name.en |
Monitoring item name (English) to be displayed in JP1/SLM
|
||
Display Unit.ja |
Monitoring item unit (Japanese) to be used in JP1/SLM
|
||
Display Unit.en |
Monitoring item unit (English) to be used in JP1/SLM
|
||
Threshold |
Threshold type
|
Data type |
Size |
JP1/SLM linkage |
Remarks |
||
---|---|---|---|---|---|
Field |
C and C++ |
Field |
Key Field |
||
char |
char |
1 |
Y |
Y |
-- |
char(n)# |
char[ ] |
n |
N |
Y |
A non-numeric cannot be specified as a monitoring item. |
double |
double |
8 |
Y |
N |
A floating point number cannot be specified as an exact-match key. |
float |
float |
4 |
Y |
N |
A floating point number cannot be specified as an exact-match key. |
long |
long |
4 |
Y |
Y |
-- |
short |
short |
2 |
Y |
Y |
-- |
string |
char |
1 |
Y |
Y |
Not intended as numeric type, but can be used as numeric type when one byte in length. |
string(n)# |
char[ ] |
n |
N |
Y |
A non-numeric cannot be specified as a monitoring item. |
time_t |
unsigned long |
4 |
Y |
N |
Elapsed time in milliseconds cannot be specified as an exact-match key. |
ulong |
unsigned long |
4 |
Y |
Y |
-- |
utime |
utime (structure) |
8 |
N |
N |
A structure cannot be specified as a monitoring item or key field. |
word |
unsigned short |
2 |
Y |
Y |
-- |
(Not applicable) |
unsigned char |
1 |
Y |
Y |
-- |
Definition example
The following is an example of how to write a definition file for JP1/SLM-linkage custom monitoring items.
ITSLM Monitoring Items Definition File Version=0001 ITSLM Monitoring Items Definition File Code=Shift_JIS [Agent] Product=T8.0 --- Agent for Platform (Windows) 8.0 [[Monitoring Item]] Record=PI --- System Overview record Field=PCT_PHYSICAL_MEMORY --- % Physical Mem field Key Field= --- Single instance records can be omitted Display Name.ja=Physical memory usage Display Name.en=Physical Mem Usage Display Unit.ja= --- When unspecified, the value of Display Unit.en is used. Display Unit.en=% Threshold=High [[Monitoring Item]] --- Write multiple monitoring items as required Record=PI_LOGD Field=PCT_DISK_USAGE Key Field=INSTANCE --- Mandatory for multi-instance record : [Agent] --- Write the product ID and data model version of the next Agent Product=U7.8 [[Monitoring Item]] Record=PI Field=PCT_PHYSICAL_MEMORY
: