Class Hierarchy
Class Attributes
Class Qualifiers
Properties
Methods
Associations in which the class can participate
Sub Profiling Summary
CIM_DiscreteMetricDefinition --> CIM_BaseMetricDefinition --> CIM_ManagedElement --> [top]
Class Declaration Attributes Name Value SUPERCLASS CIM_BaseMetricDefinition NAME CIM_DiscreteMetricDefinition
Class CIM_DiscreteMetricDefinition Qualifiers Name Type Value From Class Experimental boolean true CIM_DiscreteMetricDefinition Version string 2.13.0 CIM_DiscreteMetricDefinition UMLPackagePath string CIM::Metrics::BaseMetric CIM_DiscreteMetricDefinition Description string Specialization of BaseMetricDefinition that represents a discrete metric type. This class is does not have instances. Instead, it is used to define derived classes that override the Values and ValueMap qualifiers of the DiscreteValues array property, in order to define the predefined set of discrete values to be used. The remainder of this description defines the discrete metric concept: Discrete metrics are metrics (as defined in BaseMetricDefinition), that have an additional discrete value, which is from a set of predefined values. In order to contrast this to the general metrics that have a continuous value range, we call those 'analog metrics' in this description. The transformation of analog values into discrete values is defined by analog thresholds that represent the transition boundary from one discrete value to the next. There are independent thresholds for each direction, so that a hysteresis can be defined. There is a mandatory set of instances for each discrete value: Using the concepts of the dynamic metrics model, there is a DiscreteMetricValue instance representing the discrete metric value and a DiscreteMetricDefinition instance representing its according definition (associated through MetricInstance). In addition, there is a similar couple for the analog metric the discrete metric is derived from, consisting of a BaseMetricValue instance and according BaseMetricDefinition instance (again associated via MetricInstance). These two pairs of instances are connected through the DiscreteMetricDefinitionDependency association between the two metric definition classes, defining that the discrete metric definition and all its values are derived from this analog metric definition and all its values. The existence of the DiscreteMetricDefinitionDependency association mandates that there shall be one DiscreteMetricValue instance for each analog BaseMetricValue instance in the mandatory set of instances described above. Furthermore, it mandates that there are DiscreteMetricValueDependency association instances between the discrete and analog value instances. A recipe for creating a discrete metric type on existing analog metric type is to create a DiscreteMetricDefinition instance, and then to connect that to the analog BaseMetricDefinition by means of creating an instance of DiscreteMetricDefinitionDependency. This results in the DiscreteMetricValue and DiscreteMetricValueDependency instances coming into existence. Please note that hysteresis is implicitly defined as the difference between the trigger value and the reset value. CIM_DiscreteMetricDefinition UMLPackagePath string CIM::Metrics::BaseMetric CIM_BaseMetricDefinition Description string CIM_BaseMetricDefinition represents the definitional aspects of a metric, i.e., a definition template containing meta data about a new metric. Since CIM_BaseMetricDefinition does not capture metric instance information, it does not contain the value of the metric. The associated class CIM_BaseMetricValue holds the metric value and encapsulates its runtime behavior. The purpose of CIM_BaseMetricDefinition is to provide a convenient mechanism for introducing a new metric definition at runtime and capturing its instance values in a separate class. This mechanism is targeted specifically at CIM users who would like to enhance existing CIM schemas by introducing domain-specific metrics that are not captured in the existing CIM schemas. In addition, vendors of managed resources may make use of this mechanism if a small subset of a potentially large and heterogeneous amount of performance-related data needs to be exposed, based on the context in which the data is captured. Additional meta data for a metric can be provided by subclassing from CIM_BaseMetricDefinition. The CIM_BaseMetricDefinition should be associated with the CIM_ManagedElement(s) to which it applies. CIM_BaseMetricDefinition UMLPackagePath string CIM::Core::CoreElements CIM_ManagedElement Description string ManagedElement is an abstract class that provides a common superclass (or top of the inheritance tree) for the non-association classes in the CIM Schema. CIM_ManagedElement
Property Qualifiers
Property DiscreteValues Qualifiers Name Type Value From Class Required boolean true CIM_DiscreteMetricDefinition Description string Array defining the mapping between analog and discrete values. Each array entry is the discrete value assigned to a range on the analog scale. Adjacent array entries represent adjacent ranges on the analog scale. The boundaries of the analog ranges are defined in the AnalogTriggerValues and AnalogResetValues array properties. The possible discrete values are defined using the Values and ValueMap qualifiers. Any derived class of this class shall define the set of possible discrete values in overridden Values and ValueMap qualifiers. The Values qualifiers are string representations of the discrete values and are interpreted as a datatype and unit defined in the Datatype and Unit properties of this instance. An according derived class of DiscreteMetricValue shall define the same set of possible discrete values in overridden qualifiers of its DiscreteValue property. CIM_DiscreteMetricDefinition ValueMap string [See below.] CIM_DiscreteMetricDefinition Values string DMTF Reserved
Vendor ReservedCIM_DiscreteMetricDefinition ModelCorrespondence string CIM_DiscreteMetricValue.DiscreteValue CIM_DiscreteMetricDefinition
Name Value .. DMTF Reserved 0x8000..0xFFFF Vendor Reserved
Property BaseIndex Qualifiers Name Type Value From Class Description string This property is an index into the DiscreteValues array, and is called the 'base index'. The value of the corresponding array entry is called the 'base value'. The base value is the reference point for the AnalogTriggerValues and AnalogResetValues arrays. Moving away from the base value is controlled by the AnalogTriggerValues array, and moving back towards the base value is controlled by the AnalogResetValues array. CIM_DiscreteMetricDefinition
Property AnalogTriggerValues Qualifiers Name Type Value From Class Description string Array defining the analog values used as thresholds when the discrete value moves away from the base value. These thresholds are called 'trigger values'. The array entries are string representations of the analog values and are interpreted as a datatype and unit defined in the Datatype and Unit properties of the associated analog BaseMetricDefinition instance. If this property is not NULL, the number of array entries shall be one less than the entries in the DiscreteValues array. Array entries in this array at indexes above or equal to the base index control the transition to higher indexes in the DiscreteValues array. Array entries in this array at indexes below the base index control the transition to lower indexes in the DiscreteValues array. If this property is NULL, trigger values may still be in effect but are not externalized at the CIM level. CIM_DiscreteMetricDefinition
Property AnalogResetValues Qualifiers Name Type Value From Class Description string Array defining the analog values used as thresholds when the discrete value moves towards the base value. These thresholds are called 'reset values'. The array entries are string representations of the analog values and are interpreted as a datatype and unit defined in the Datatype and Unit properties of the associated analog BaseMetricDefinition instance. If this property is not NULL, the number of array entries shall be one less than the entries in the DiscreteValues array. Array entries in this array at indexes abover or equal to the base index control the transition to lower indexes in the DiscreteValues array. Array entries in this array at indexes below the base index control the transition to higher indexes in the DiscreteValues array. If this property is NULL, reset values may still be in effect but are not externalized at the CIM level. CIM_DiscreteMetricDefinition
Property Id Qualifiers Name Type Value From Class Key boolean true CIM_BaseMetricDefinition Description string A string that uniquely identifies the metric definition. The use of OSF UUID/GUIDs is recommended. CIM_BaseMetricDefinition
Property Name Qualifiers Name Type Value From Class Description string The name of the metric. This name does not have to be unique, but should be descriptive and may contain blanks. CIM_BaseMetricDefinition
Property DataType Qualifiers Name Type Value From Class Description string The data type of the metric. For example, "boolean" (value=1) or "datetime" (=3) may be specified. These types represent the datatypes defined for CIM. CIM_BaseMetricDefinition ValueMap string [See below.] CIM_BaseMetricDefinition Values string boolean
char16
datetime
real32
real64
sint16
sint32
sint64
sint8
string
uint16
uint32
uint64
uint8CIM_BaseMetricDefinition
Name Value 1 boolean 2 char16 3 datetime 4 real32 5 real64 6 sint16 7 sint32 8 sint64 9 sint8 10 string 11 uint16 12 uint32 13 uint64 14 uint8
Property Calculable Qualifiers Name Type Value From Class Description string An enumerated value that describes the characteristics of the metric, for purposes of performing calculations. The property can take one of the following values: 1="Non-calculable" -> a string. Arithmetic makes no sense. 2="Summable" -> It is reasonable to sum this value over many instances of e.g., UnitOfWork, such as the number of files processed in a backup job. For example, if each backup job is a UnitOfWork, and each job backs up 27,000 files on average, then it makes sense to say that 100 backup jobs processed 2,700,000 files. 3="Non-summable" -> It does not make sense to sum this value over many instances of UnitOfWork. An example would be a metric that measures the queue length when a job arrives at a server. If each job is a UnitOfWork, and the average queue length when each job arrives is 33, it does not make sense to say that the queue length for 100 jobs is 3300. It does make sense to say that the mean is 33. CIM_BaseMetricDefinition ValueMap string [See below.] CIM_BaseMetricDefinition Values string Non-calculable
Summable
Non-summableCIM_BaseMetricDefinition
Name Value 1 Non-calculable 2 Summable 3 Non-summable
Property Units Qualifiers Name Type Value From Class Description string Identifies the specific units of a value. Examples are Bytes, Packets, Jobs, Files, Milliseconds, and Amps. CIM_BaseMetricDefinition
Property ProgrammaticUnits Qualifiers Name Type Value From Class Description string Identifies the specific units of a value. The value of this property shall be a legal value of the Programmatic Units qualifier as defined in Appendix C.1 of DSP0004 V2.4 or later. CIM_BaseMetricDefinition
Property BreakdownDimensions Qualifiers Name Type Value From Class Description string Defines one or more strings that can be used to refine (break down) queries against the BaseMetricValues along a certain dimension. An example is a transaction name, allowing the break down of the total value for all transactions into a set of values, one for each transaction name. Other examples might be application system or user group name. The strings are free format and should be meaningful to the end users of the metric data. The strings indicate which break down dimensions are supported for this metric definition, by the underlying instrumentation. CIM_BaseMetricDefinition
Property IsContinuous Qualifiers Name Type Value From Class Description string IsContinuous indicates whether or not the metric value is continuous or scalar. Performance metrics are an example of a linear metric. Examples of non-linear metrics include error codes or operational states. Continuous metrics can be compared using the "greater than" relation. CIM_BaseMetricDefinition
Property ChangeType Qualifiers Name Type Value From Class Description string ChangeType indicates how the metric value changes, in the form of typical combinations of finer grain attributes such as direction change, minimum and maximum values, and wrapping semantics. 0="Unknown": The metric designer did not qualify the ChangeType. 2="N/A": If the "IsContinuous" property is "false", ChangeType does not make sense and MUST be is set to "N/A". 3="Counter": The metric is a counter metric. These have non-negative integer values which increase monotonically until reaching the maximum representable number and then wrap around and start increasing from 0. Such counters, also known as rollover counters, can be used for instance to count the number of network errors or the number of transactions processed. The only way for a client application to keep track of wrap arounds is to retrieve the value of the counter in appropriately short intervals. 4="Gauge": The metric is a gauge metric. These have integer or float values that can increase and decrease arbitrarily. A gauge MUST NOT wrap when reaching the minimum or maximum representable number, instead, the value "sticks" at that number. Minimum or maximum values inside of the representable value range at which the metric value "sticks", may or may not be defined. Vendors may extend this property in the vendor reserved range. CIM_BaseMetricDefinition ValueMap string [See below.] CIM_BaseMetricDefinition Values string Unknown
N/A
Counter
Gauge
DMTF Reserved
Vendor ReservedCIM_BaseMetricDefinition ModelCorrespondence string CIM_BaseMetricDefinition.IsContinuous CIM_BaseMetricDefinition
Name Value 0 Unknown 2 N/A 3 Counter 4 Gauge 5..32767 DMTF Reserved 32768..65535 Vendor Reserved
Property TimeScope Qualifiers Name Type Value From Class Description string TimeScope indicates the time scope to which the metric value applies. 0="Unknown" indicates the time scope was not qualified by the metric designer, or is unknown to the provider. 2="Point" indicates that the metric applies to a point in time. On the corresponding BaseMetricValue instances, TimeStamp specifies the point in time and Duration is always 0. 3="Interval" indicates that the metric applies to a time interval. On the corresponding BaseMetricValue instances, TimeStamp specifies the end of the time interval and Duration specifies its duration. 4="StartupInterval" indicates that the metric applies to a time interval that began at the startup of the measured resource (i.e. the ManagedElement associated by MetricDefForMe). On the corresponding BaseMetricValue instances, TimeStamp specifies the end of the time interval. If Duration is 0, this indicates that the startup time of the measured resource is unknown. Else, Duration specifies the duration between startup of the resource and TimeStamp. CIM_BaseMetricDefinition ValueMap string [See below.] CIM_BaseMetricDefinition Values string Unknown
Point
Interval
StartupInterval
DMTF Reserved
Vendor ReservedCIM_BaseMetricDefinition ModelCorrespondence string CIM_BaseMetricValue.TimeStamp
CIM_BaseMetricValue.DurationCIM_BaseMetricDefinition
Name Value 0 Unknown 2 Point 3 Interval 4 StartupInterval 5..32767 DMTF Reserved 32768..65535 Vendor Reserved
Property GatheringType Qualifiers Name Type Value From Class Description string GatheringType indicates how the metric values are gathered by the underlying instrumentation. This allows the client application to choose the right metric for the purpose. 0="Unknown": Indicates that the GatheringType is not known. 2="OnChange": Indicates that the CIM metric values get updated immediately when the values inside of the measured resource change. The values of OnChange metrics truly reflect the current situation within the resource at any time. An example is the number of logged on users that gets updated immediately as users log on and off. 3="Periodic": Indicates that the CIM metric values get updated periodically. For instance, to a client application, a metric value applying to the current time will appear constant during each gathering interval, and then jumps to the new value at the end of each gathering interval. 4="OnRequest": Indicates that the CIM metric value is determined each time a client application reads it. The values of OnRequest metrics truly return the current situation within the resource if somebody asks for it. However, they do not change "unobserved", and therefore subscribing for value changes of OnRequest metrics is NOT RECOMMENDED. CIM_BaseMetricDefinition ValueMap string [See below.] CIM_BaseMetricDefinition Values string Unknown
OnChange
Periodic
OnRequest
DMTF Reserved
Vendor ReservedCIM_BaseMetricDefinition
Name Value 0 Unknown 2 OnChange 3 Periodic 4 OnRequest 5..32767 DMTF Reserved 32768..65535 Vendor Reserved
Property Caption Qualifiers Name Type Value From Class Description string The Caption property is a short textual description (one- line string) of the object. CIM_ManagedElement MaxLen uint32 64 CIM_ManagedElement
Property Description Qualifiers Name Type Value From Class Description string The Description property provides a textual description of the object. CIM_ManagedElement
Property ElementName Qualifiers Name Type Value From Class Description string A user-friendly name for the object. This property allows each instance to define a user-friendly name in addition to its key properties, identity data, and description information. Note that the Name property of ManagedSystemElement is also defined as a user-friendly name. But, it is often subclassed to be a Key. It is not reasonable that the same property can convey both identity and a user-friendly name, without inconsistencies. Where Name exists and is not a Key (such as for instances of LogicalDevice), the same information can be present in both the Name and ElementName properties. CIM_ManagedElement
Method Qualifiers
Parameters
Parameter Qualifiers