Base Metrics Profile 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 25 Document Number: DCIM1036 Document Type: Specification Document Status: Draft Document Language: E Date: 2012-03-08 26 Version: 1.0.
32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 THIS PROFILE IS FOR INFORMATIONAL PURPOSES ONLY, AND MAY CONTAIN TYPOGRAPHICAL ERRORS AND TECHNICAL INACCURACIES. THE CONTENT IS PROVIDED AS IS, WITHOUT EXPRESS OR IMPLIED WARRANTIES OF ANY KIND. ABSENT A SEPARATE AGREEMENT BETWEEN YOU AND DELL™ WITH REGARD TO FEEDBACK TO DELL ON THIS PROFILE SPECIFICATION, YOU AGREE ANY FEEDBACK YOU PROVIDE TO DELL REGARDING THIS PROFILE SPECIFICATION WILL BE OWNED AND CAN BE FREELY USED BY DELL.
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 CONTENTS 1 2 3 4 5 6 7 Scope .................................................................................................................................................... 7 Normative References........................................................................................................................... 7 Terms and Definitions ...........................................................................
95 Figures 96 97 98 99 100 101 Figure 1 – Class Diagram ............................................................................................................................. 9 Figure 2 – Maximum, Headroom Power and Energy Consumption Metrics ............................................... 10 Figure 3 – Minimum Power Consumption for Last Minute, Hour, Day and Week ...................................... 11 Figure 4 – Maximum Power Consumption for Last Minute, Hour, Day and Week ....................
141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 Table 31 – DCIM_BaseMetricValue: Instantaneous Power Consumption Headroom Metric in Amperes Properties .......................................................................................................................... 35 Table 44 – DCIM_MetricDefForME Operations .......................................................................................... 36 Table 45 – DCIM_MetricDefForME Properties ............................
Base Metrics Profile 161 162 1 163 164 165 166 The DCIM Base Metrics Profile extends the DMTF Base Metrics Profile to add Dell specific implementation requirements for power related metrics. The profile standardizes the units and description for the metrics as well as provides static methodology for the clients to query the metrics without substantial traversal of the model.
194 195 196 197 198 199 200 3.2 mandatory indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted 3.3 may indicates a course of action permissible within the limits of the document 3.
230 231 The Dell Base Metrics Profile is derived from the DMTF Base Metrics Profile and contains additional Dell specific implementation requirements. 232 Table 1 identifies profiles that are related to this profile. 233 Table 1 – Related Profiles Profile Name Organization Version Relationship Base Metrics Profile DMTF 1.
LCRegisteredProfile RegisteredProfile Interop Namespace Implementation Namespace ElementConformsToProfile BMElementCapabilities MCapabilities1 : MetricServiceCapabilities ControllableMetrics : { HiAmdWatt1, HiAmdAmp1, BmdCum1 } MetricControlTypes :{ 2 (Discrete), 2 (Discrete), 2 (Discrete)} SupportedMethods : { 2 (ControlMetrics) } LCElementConformsToProfile MService1 : MetricService BMServiceAffectsElement HostedService BMServiceAffectsElement HiAmdWatt1 : AggregationMetricDefinition Name : DMTF:Sy
To MService1 BMServiceAffectsElement MetricDefForME MetricCollectionEnabled : 2 (Enabled) LoAmd : AggregationMetricDefinition ChangeType : 5 (Simple Function) SimpleFunction : 2 (Minimum) system1 : ComputerSystem LoAmvDay1 : AggregationMetricValue AggrMetricInstance MetricForME LoAmvWeek1 : AggregationMetricValue LoAmvHr1 : AggregationMetricValue LoAmdMin1 : AggregationMetricValue 247 248 Figure 3 – Minimum Power Consumption for Last Minute, Hour, Day and Week Version 1.0.
To MService1 BMServiceAffectsElement HiAmd : AggregationMetricDefinition MetricDefForME MetricCollectionEnabled : 2 (Enabled) ChangeType : 5 (Simple Function) SimpleFunction : 3 (Maximum) system1 : ComputerSystem HiAmvDay1 : AggregationMetricValue AggrMetricInstance MetricForME HiAmvWeek1 : AggregationMetricValue HiAmvHr1 : AggregationMetricValue HiAmdMin1 : AggregationMetricValue 249 250 Figure 4 – Maximum Power Consumption for Last Minute, Hour, Day and Week 12 Version 1.0.
To MService1 BMServiceAffectsElement AvgAmd : AggregationMetricDefinition MetricDefForME MetricCollectionEnabled : 2 (Enabled) ChangeType : 5 (Simple Function) SimpleFunction : 4 (Average) system1 : ComputerSystem AvgAmvDay1 : AggregationMetricValue MetricInstance MetricForME AvgAmvWeek1 : AggregationMetricValue AvgAmvHr1 : AggregationMetricValue AvgAmdMin1 : AggregationMetricValue 251 252 Figure 5 – Average Power Consumption for Last Minute, Hour, Day and Week 253 254 7 255 256 257 The requ
Class Name Requirement Description DCIM_BaseMetricValue Mandatory The class shall be implemented in the Implementation Namespaces. See section 7.7.2, and 7.8.2. DCIM_AggrMetricInstance Mandatory The class shall be implemented in the Implementation Namespaces. See section 7.1.1, 7.3.1, 7.4.1, 7.5.1, 7.6.1, 7.1.2, 7.3.2, 7.4.2, 7.5.2 and 7.6.2. DCIM_BaseMetricInstance Mandatory The class shall be implemented in the Implementation Namespaces. See section 7.7.1, 7.8.1, 7.7.2, and 7.8.2.
263 7.1.1 DCIM_AggregationMetricDefinition 264 265 The following clauses define the requirements for the DCIM_AggregationMetricDefinition class. DCIM_AggregationMetricDefinition is a derivation of CIM_AggregationMetricDefinition. 266 267 The DCIM_BMServiceAffectsElement association’s AffectedElement property shall reference DCIM_AggregationMetricDefinition instances. 268 269 The DCIM_BMServiceAffectsElement association’s ElementEffects property shall have value 5 (Manages).
GatheringType uint16 Mandatory Id string Mandatory IsContinuous boolean Mandatory Name ProgrammaticUnits string string Mandatory Mandatory SampleInterval datetime Mandatory SimpleFunction uint16 Mandatory TimeScope uint16 Mandatory “Peak Watt Power Consumption” The property shall have value 3 (periodic) The property is the key and shall have value “AggrMetricDef:0” The property shall have value TRUE The property shall have value "DMTF:System Input Power" The property shall have value "w
310 311 7.2 312 The following defines the requirements for the maximum headroom power consumption metric. 313 7.2.1 DCIM_AggregationMetricDefinition 314 315 The following clauses define the requirements for the DCIM_AggregationMetricDefinition class. DCIM_AggregationMetricDefinition is a derivation of CIM_AggregationMetricDefinition. 316 7.2.1.1 Resource URIs for WinRM® 317 318 The class Resource URI shall be “http://schemas.dell.
340 7.2.2.2 Operations 341 The following table details the implemented operations on DCIM_AggregationMetricValue. 342 Table 7 – DCIM_AggregationMetricValue Operations Operation Name Get Enumerate Associators References Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI Instance URI Instance URI 343 7.2.2.
355 7.3.1 DCIM_AggregationMetricDefinition 356 357 The following clauses define the requirements for the DCIM_AggregationMetricDefinition class. DCIM_AggregationMetricDefinition is a derivation of CIM_AggregationMetricDefinition. 358 359 The DCIM_BMServiceAffectsElement association’s AffectedElement property shall reference DCIM_AggregationMetricDefinition instances. 360 361 The DCIM_BMServiceAffectsElement association’s ElementEffects property shall have value 5 (Manages).
GatheringType Id IsContinuous uint16 string boolean Mandatory Mandatory Mandatory Name ProgrammaticUnits string string Mandatory Mandatory SampleInterval SimpleFunction TimeScope datetime uint16 uint16 Mandatory Mandatory Mandatory The property shall have value 3 (periodic) The property shall have value “AggrMetricDef:3” The property shall have value TRUE The property shall have value "DMTF:System Input Power" The property shall have value "ampere * 10^-1" The property value shall be in W3C represe
409 410 Table 12 – DCIM_AggregationMetricValue: Maximum Power Consumption Metric in Amperes Properties Property Name Type Requirement AggregationDuration datetime Mandatory AggregationTimeStamp datetime Mandatory InstanceID string Mandatory MetricDefinitionId string Mandatory MetricValue string Mandatory TimeStamp datetime Mandatory Volatile boolean Mandatory Additional Requirements The property shall be in W3C representation in WS-CIM with the corresponding value equal to Current T
422 7.4.1 DCIM_AggregationMetricDefinition 423 424 The following clauses define the requirements for the DCIM_AggregationMetricDefinition class. DCIM_AggregationMetricDefinition is a derivation of CIM_AggregationMetricDefinition. 425 426 The DCIM_BMServiceAffectsElement association’s AffectedElement property shall reference DCIM_AggregationMetricDefinition instances. 427 428 The DCIM_BMServiceAffectsElement association’s ElementEffects property shall have value 5 (Manages).
GatheringType Id IsContinuous uint16 string boolean Mandatory Mandatory Mandatory Name ProgrammaticUnits SimpleFunction TimeScope string string uint16 uint16 Mandatory Mandatory Mandatory Mandatory The property shall have value 3 (periodic) The property shall have value “AggrMetricDef:4” The property shall have value TRUE The property shall have value "DMTF:System Input Power" The property shall have value "watt" The property shall have value 3 (Maximum) The property shall have value 2 (Point) 452 7
Property Name Type Requirement AggregationDuration datetime Mandatory AggregationTimeStamp datetime Mandatory Additional Requirements shall be in W3C representation in WS-CIM with the corresponding value equal to 1 minute or 1 hour or 1 day or 1 week. shall be in W3C representation in WS-CIM with the corresponding value equal to current timestamp.
489 7.5.1 DCIM_AggregationMetricDefinition 490 491 The following clauses define the requirements for the DCIM_AggregationMetricDefinition class. DCIM_AggregationMetricDefinition is a derivation of CIM_AggregationMetricDefinition. 492 493 The DCIM_BMServiceAffectsElement association’s AffectedElement property shall reference DCIM_AggregationMetricDefinition instances. 494 495 The DCIM_BMServiceAffectsElement association’s ElementEffects property shall have value 5 (Manages).
Property Name GatheringType Id IsContinuous Name ProgrammaticUnits SimpleFunction TimeScope Type uint16 string boolean string string uint16 uint16 Requirement Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Additional Requirements The property shall have value 3 (periodic) The property shall have value “AggrMetricDef:1” The property shall have value TRUE The property shall have value "DMTF:System Input Power" The property shall have value "watt" The property shall have value 2 (Mini
544 545 Table 20 – DCIM_AggregationMetricValue: Minimum Power Consumption Metric in Watts for Last Minute, Hour, Day and Week Properties Property Name Type Requirement Additional Requirements The property shall be in W3C representation in WS-CIM with the corresponding value equal to 1 minute or 1 hour or 1 day or 1 week. The property shall be in W3C representation in WS-CIM with the corresponding value equal to current timestamp.
557 7.6.1 DCIM_AggregationMetricDefinition 558 559 The following clauses define the requirements for the DCIM_AggregationMetricDefinition class. DCIM_AggregationMetricDefinition is a derivation of CIM_AggregationMetricDefinition. 560 561 The DCIM_BMServiceAffectsElement association’s AffectedElement property shall reference DCIM_AggregationMetricDefinition instances. 562 563 The DCIM_BMServiceAffectsElement association’s ElementEffects property shall have value 5 (Manages).
Property Name GatheringType Id IsContinuous Name ProgrammaticUnits SimpleFunction TimeScope Type uint16 string boolean string string uint16 uint16 Requirement Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Additional Requirements The property shall have value 3 (periodic) The property shall have value “AggrMetricDef:2” The property shall have value TRUE The property shall have value "DMTF:System Input Power" The property shall have value "watt" The property shall have value 4 (Aver
612 613 Table 24 – DCIM_AggregationMetricValue: Average Power Consumption Metric in Watts for Last Minute, Hour, Day and Week Properties Property Name Type Requirement Additional Requirements The property shall be in W3C representation in WS-CIM with the corresponding value equal to 1 minute or 1 hour or 1 day or 1 week. The property shall be in W3C representation in WS-CIM with the corresponding value equal to current timestamp.
636 7.7.1.2 Operations 637 The following table details the implemented operations on DCIM_BaseMetricDefinition. 638 Table 25 – DCIM_BaseMetricDefinition Operations Operation Name Get Enumerate Associators References Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI Instance URI Instance URI 639 7.7.1.
647 7.7.2 DCIM_BaseMetricValue 648 649 The following clauses define the requirements for the DCIM_BaseMetricValue class. DCIM_BaseMetricValue is derived from CIM_BaseMetricValue. 650 651 The DCIM_BaseMetricInstance association’s Dependent property shall reference DCIM_AggregationMetricValue instances. 652 653 The DCIM_MetricForME association’s Dependent property shall reference DCIM_AggregationMetricValue instances. 654 7.7.2.
Type Property Name Requirement TimeStamp datetime Mandatory Volatile boolean Mandatory Additional Requirements cumulative reading in kilowatthour (kWh). The property shall be in W3C representation in WS-CIM with the corresponding value equal to Current timestamp The property shall have value TRUE 672 7.8 673 The following defines the requirements for the instantaneous power consumption headroom metric. 674 7.8.
Type Property Name Requirement ChangeType uint16 Mandatory DataType uint16 Mandatory ElementName string Mandatory GatheringType uint16 Mandatory Id string Mandatory IsContinuous boolean Mandatory Name string Mandatory ProgrammaticUnits string Mandatory SampleInterval datetime Mandatory TimeScope uint16 Mandatory Additional Requirements The property shall have value 4 (Gauge) The property shall have value 12 (uint32) The property shall have value “Instantaneous Power” The pro
Operation Name References Requirements Mandatory Required Input Instance URI 710 7.8.2.3 Properties 711 712 713 The following table details the requirements for implementing DCIM_BaseMetricValue instance representing the instantaneous power consumption headroom metric. The most derived class name of this instance shall be DCIM_BaseMetricValue.
731 7.9.2 Operations 732 The following table details the implemented operations on DCIM_MetricDefForME. 733 Table 33 – DCIM_MetricDefForME Operations Operation Name Get Enumerate Associators References Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI Instance URI Instance URI 734 7.9.
756 Table 35 – DCIM_MetricServiceCapabilities Operations Operation Name Get Enumerate Associators References Requirements Mandatory Mandatory Mandatory Mandatory Required Input Instance URI Class URI Instance URI Instance URI 757 7.10.3 Properties 758 759 760 The following table details the requirements for implementing DCIM_MetricServiceCapabilities instance representing an association between DCIM_ComputerSystem and both DCIM_BaseMetricValue and DCIM_AggregationMetricValue.
765 766 7.11 DCIM_MetricService 767 768 The following clauses define the requirements for the DCIM_MetricService class. DCIM_MetricService is derived from CIM_MetricService. 769 770 The DCIM_BMElementCapabilities association’s ManagedElement property shall reference the DCIM_MetricService instance. 771 772 The DCIM_BMServiceAffectsElement association’s AffectingElement property shall reference the DCIM_MetricService instance.
798 799 corresponding column “Additional Requirements”, or shall be implemented according to the requirements in the corresponding column “Additional Requirements”.
819 7.12.3 Properties 820 821 The following table details the implemented properties for DCIM_LCRegisteredProfile instance representing Base Metrics Profile implementation.
844 Table 42 – DCIM_LCRegisteredProfile - Properties Property Name InstanceID RegisteredName RegisteredVersion RegisteredOrganization OtherRegisteredOrganization Requirement Mandatory Mandatory Mandatory Mandatory Mandatory Type String String String Uint16 String Additional Requirements This property value shall be “DMTF:BaseMetrics:1.0.0” This property value is "Base Metrics” This property value is "1.0.0". This property value is 1 (Other). The property value is “DCIM”.
858 Table 45 – CIM_MetricService.ControlMetrics( ) Method: Parameters Qualifiers Name Type Description/Values IN Subject CIM_ManagedElement REF The parameter shall be NULL. IN Definition CIM_BaseMetricDefinition REF Reference to the DCIM_BaseMetricDefinition or DCIM_AggregationMetricDefinition for which collection is to be enabled or disabled IN, REQ MetricCollectionEnabled uint16 The parameter value shall be 4 (Reset).
868 Value Description 2 Error occurred Table 47 – DCIM_MetricService.GetAvgPowerConsumptionByInterval() Method: Parameters Qualifiers Name Type Description/Values IN, REQ Interval Datetime The parameter shall represent the interval for which the average power is requested. The interval value shall be between 30 seconds to 15 minutes. IN Device Uint16 The parameter shall represent the device for which the power consumption information is requested.
875 10 876 No additional requirements are specified. 877 11 878 879 880 The following table describes the privilege and license requirements for the listed operations. For the detailed explanation of the privileges and licenses, refer to the Dell WSMAN Licenses and Privileges specification.
Class and Method DCIM_LCElementConformsToProfile Operation ENUMERATE, GET User Privilege Required Login License Required None. 882 Version 1.0.
ANNEX A 883 884 Change Log 885 Version Date Description 0.0.0 01/20/2009 Initial Draft. 0.1.0 10/20/09 Extended to add specific requirements for Power Metrics and Sensors 886 46 Version 1.0.