CIM_BaseMetricDefinition class
Represents a metric definition that contains the meta data for a CIM_MetricInstance object. This definition provides a convenient mechanism for introducing a new metric definition at runtime and then capturing its instance values in a separate class.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.
Syntax
[Abstract, Version("2.22.0"), UMLPackagePath("CIM::Metrics::BaseMetric")]
class CIM_BaseMetricDefinition : CIM_ManagedElement
{
string InstanceID;
string Caption;
string Description;
string ElementName;
string Id;
string Name;
uint16 DataType;
uint16 Calculable;
string Units;
string BreakdownDimensions[];
boolean IsContinuous;
uint16 ChangeType;
uint16 TimeScope;
uint16 GatheringType;
string ProgrammaticUnits;
};
Members
The CIM_BaseMetricDefinition class has these types of members:
Properties
The CIM_BaseMetricDefinition class has these properties.
-
BreakdownDimensions
-
-
Data type: string array
-
Access type: Read-only
An array that contains free format strings that can be used to break down queries of CIM_BaseMetricValue objects along a certain dimension. The strings should be meaningful to the end users of the metric data. In addition, the strings should indicate which break down dimensions are supported for the metric definition, by the underlying instrumentation.
An example is a transaction name that allows the break down of the total value for all transactions into a set of values, one for each transaction name. Other examples are an application system, or a user group name.
-
-
Calculable
-
-
Data type: uint16
-
Access type: Read-only
The characteristics of the metric used to perform calculations.
-
-
Non-calculable (1)
-
The value can not be used to create a sum of values.
-
Summable (2)
-
The value can be used to create a sum of values.
-
Non-summable (3)
-
The value should not be used to create a sum of values.
Caption
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
A short textual description of the object.
This property is inherited from CIM_ManagedElement.
ChangeType
-
Data type: uint16
-
Access type: Read-only
-
Qualifiers: ModelCorrespondence ("CIM_BaseMetricDefinition.IsContinuous")
Indicates how the metric value changes using common attributes such as direction change, minimum and maximum values, and wrapping semantics.
Unknown (0)
The metric designer did not qualify the ChangeType property.
N/A (2)
The IsContinuous property is false, so the ChangeType property is not used.
Counter (3)
The metric is a counter metic.
Gauge (4)
The metric is a gauge metic.
DMTF Reserved
Reserved.
Vendor Reserved
Reserved.
DataType
-
Data type: uint16
-
Access type: Read-only
The data type of the metric.
boolean (1)
char16 (2)
datetime (3)
real32 (4)
real64 (5)
sint16 (6)
sint32 (7)
sint64 (8)
sint8 (9)
string (10)
uint16 (11)
uint32 (12)
uint64 (13)
uint8 (14)
Description
-
Data type: string
-
Access type: Read-only
A textual description of the object.
This property is inherited from CIM_ManagedElement.
ElementName
-
Data type: string
-
Access type: Read-only
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.
This property is inherited from CIM_ManagedElement.
GatheringType
-
Data type: uint16
-
Access type: Read-only
Indicates how the metric values are gathered by the underlying instrumentation.
Unknown (0)
The gathering type is not known.
OnChange (2)
CIM metric values get updated immediately when the values inside measured resource change. Metric of this gathering type reflect the data of a resource at any time. An example is the number of logged on users that gets updated immediately as users log on and off of a system.
Periodic (3)
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.
OnRequest (4)
The CIM metric value is determined each time a client application reads it. Metrics of this gathering type retrieve data that might only be accurate during the request.
DMTF Reserved
Reserved.
Vendor Reserved
Reserved.
Id
-
Data type: string
-
Access type: Read-only
-
Qualifiers: Key
The unique ID of the metric definition. Open Software Foundation (OSF) UUID/GUIDs are recommended.
InstanceID
-
Data type: string
-
Access type: Read-only
Uniquely and opaquely identifies an instance of this class within the scope of the containing namespace.
[!Important]
In order to ensure uniqueness within the namespace, the value of the InstanceID property should be constructed in the following pattern: OrgID:LocalID
OrgID must include a copyrighted, trademarked or otherwise unique name that is owned by the business entity that defines the InstanceID, or be a registered ID that is assigned by a recognized global authority. This pattern is similar to the structure of schema class names. In addition, to ensure uniqueness, the first colon in InstanceID must be between the OrgID andLocalID. Therefore the OrgID must not contain a colon (':').
LocalID is chosen by the business entity and should not be re-used to identify different underlying real-world elements.
If the above pattern is not used, the defining entity must assure that the resultant InstanceID value is not re-used across any InstanceID properties that are produced by this provider or other providers for this namespace.
For Distributed Management Task Force (DMTF) defined instances, the pattern must be used with the OrgID set to CIM.
This property is inherited from CIM_ManagedElement.
IsContinuous
-
Data type: boolean
-
Access type: Read-only
True if the metric value is continuous; otherwise, false.
Name
-
Data type: string
-
Access type: Read-only
The name of the metric. This name does not have to be unique, but should be descriptive and may contain blank spaces.
ProgrammaticUnits
-
Data type: string
-
Access type: Read-only
The specific units of a value. The value of this property should be a legal value of the Programmatic Units qualifier as defined in Appendix C.1 of DSP0004 V2.4 or later.
TimeScope
-
Data type: uint16
-
Access type: Read-only
-
Qualifiers: ModelCorrespondence ("CIM_BaseMetricValue.TimeStamp", "CIM_BaseMetricValue.Duration")
The time scope that applies to the metric designer.
Unknown (0)
The time scope was not qualified by the metric designer, or is unknown to the provider.
Point (2)
The metric applies to a point in time. For corresponding CIM_BaseMetricValue instances, the TimeStamp property specifies the point in time, and the Duration property contains "0".
Interval (3)
The metric applies to a time interval. For corresponding CIM_BaseMetricValue instances, the TimeStamp property specifies the end of the time interval, and Duration property specifies the duration of the time interval.
StartupInterval (4)
The metric applies to a time interval that began at the startup of the measured resource, such as a CIM_ManagedElement that is associated with a metric using the CIM_MetricDefForME class.
For corresponding CIM_BaseMetricValue instances, TimeStamp property specifies the end of the time interval. If the Duration property is "0", this indicates that the startup time of the measured resource is unknown. Otherwise, Duration specifies the duration between the startup time of the resource and TimeStamp value.
DMTF Reserved
Reserved.
Vendor Reserved
Reserved.
Units
-
Data type: string
-
Access type: Read-only
The units of the metric. Examples are bytes, packets, jobs, files, milliseconds, and amps.
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2016 |
| Namespace |
Root\HyperVCluster\v2 |
| MOF |
|
| DLL |
|