NetXMS Wiki

Difference between revisions of "UM:Basic Concepts"

UM:Basic Concepts (view source)

Revision as of 01:37, 8 April 2012

65 bytes added ,  01:37, 8 April 2012
m
→‎DCI (Data Collection Items)
m
Line 50: Line 50:


= DCI (Data Collection Items) =
= DCI (Data Collection Items) =


Every node can have many parameters, like CPU utilization or amount of free memory, which can be collected by management server, checked for threshold violations, and stored in the database. In NetXMS, parameters configured for collection are called Data Collection Items or DCI for short. One DCI represents one node's parameter, and unlimited number of DCIs can be configured for any node.  
Every node can have many parameters, like CPU utilization or amount of free memory, which can be collected by management server, checked for threshold violations, and stored in the database. In NetXMS, parameters configured for collection are called Data Collection Items or DCI for short. One DCI represents one node's parameter, and unlimited number of DCIs can be configured for any node.  
Each data collection item has various attributes controlling its handling:
Each data collection item has various attributes controlling its handling:
Description — a free-form text string describing DCI. It is not used by the server and is intended for better information understanding by operators.
{| class="wikitable"
Origin — origin of data (or method of obtaining data). Possible origins are NetXMS agent, SNMP agent, CheckPoint SNMP agent, or Internal (data generated inside NetXMS server process).
|-
Name — name of the parameter of interest, used for making a request to target node. For NetXMS agent it will be parameter name, and for SNMP agent it will be an SNMP OID.
| Description || A free-form text string describing DCI. It is not used by the server and is intended for better information understanding by operators.
Data Type — data type for a parameter. Can be one of the following: Integer, Unsigned Integer, 64-bit Integer, 64-bit Unsigned Integer, Float (floating point number), or String. Selected data type affects processing of collected data — for example, you cannot use operations like ”less than” or ”greater than” on strings.
|-
Retention Time — this attribute specifies how long collected data should be kept in database, in days. Minimum retention time is 1 day, and maximum is not limited. However, keeping too many collected values for too long will lead to significant increase of your database size and possible performance degradation.
| Origin || Origin of data (or method of obtaining data). Possible origins are NetXMS agent, SNMP agent, CheckPoint SNMP agent, or Internal (data generated inside NetXMS server process).
Schedule Type — type of the collection schedule used; can be either simple or advanced. In a simple mode, values are taken from target at fixed intervals. In an advanced mode, cron-like scheduling table can be used to specify the exact time for polling. This can be useful if, for example, you wish to check the file size every Monday and Friday at 7:00.
|-
Polling Interval — interval in seconds between two polls. Applicable only if simple schedule type is selected.
| Name || Name of the parameter of interest, used for making a request to target node. For NetXMS agent it will be parameter name, and for SNMP agent it will be an SNMP OID.
Scheduling Table — cron-like scheduling table for data collection polls. Applicable only if advanced schedule type is selected.
|-
Threshold List — list of defined thresholds.
| Data Type || Data type for a parameter. Can be one of the following: Integer, Unsigned Integer, 64-bit Integer, 64-bit Unsigned Integer, Float (floating point number), or String. Selected data type affects processing of collected data — for example, you cannot use operations like ”less than” or ”greater than” on strings.
Instance — a free-form text string, passed as 6th parameter to events associated with thresholds. You can use this parameter to distinguish similar events related to different instances of the same entity – for example, if you have an event generated when file system is low on free space, you can set instance attribute to file system mount point.
|-
| Retention Time || This attribute specifies how long collected data should be kept in database, in days. Minimum retention time is 1 day, and maximum is not limited. However, keeping too many collected values for too long will lead to significant increase of your database size and possible performance degradation.
|-
| Schedule Type || Type of the collection schedule used; can be either simple or advanced. In a simple mode, values are taken from target at fixed intervals. In an advanced mode, cron-like scheduling table can be used to specify the exact time for polling. This can be useful if, for example, you wish to check the file size every Monday and Friday at 7:00.
|-
| Polling Interval || Interval in seconds between two polls. Applicable only if simple schedule type is selected.
|-
| Scheduling Table || Cron-like scheduling table for data collection polls. Applicable only if advanced schedule type is selected.
|-
| Threshold List || List of defined thresholds.
|-
| Instance || A free-form text string, passed as 6th parameter to events associated with thresholds. You can use this parameter to distinguish similar events related to different instances of the same entity – for example, if you have an event generated when file system is low on free space, you can set instance attribute to file system mount point.
|}


= Thresholds =
= Thresholds =
Retrieved from "https://wiki.netxms.org/wiki/Special:MobileDiff/164"