blob: 4ba2c1219d74679edb2974cc2281a7b1128129bb [file] [log] [blame]
Ed Tanous530520e2019-01-02 13:41:37 -08001<?xml version="1.0" encoding="UTF-8"?>
2<!---->
3<!--################################################################################ -->
Gunnar Mills09b9d452020-02-11 13:27:39 -06004<!--# Redfish Schema: TelemetryService v1.2.0 -->
Ed Tanous530520e2019-01-02 13:41:37 -08005<!--# -->
6<!--# For a detailed change log, see the README file contained in the DSP8010 bundle, -->
7<!--# available at http://www.dmtf.org/standards/redfish -->
Ed Tanouscb103132019-10-08 11:34:22 -07008<!--# Copyright 2014-2019 DMTF. -->
Ed Tanous530520e2019-01-02 13:41:37 -08009<!--# For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright -->
10<!--################################################################################ -->
11<!---->
12<edmx:Edmx xmlns:edmx="http://docs.oasis-open.org/odata/ns/edmx" Version="4.0">
13
14 <edmx:Reference Uri="http://docs.oasis-open.org/odata/odata/v4.0/errata03/csd01/complete/vocabularies/Org.OData.Core.V1.xml">
15 <edmx:Include Namespace="Org.OData.Core.V1" Alias="OData"/>
16 </edmx:Reference>
17 <edmx:Reference Uri="http://docs.oasis-open.org/odata/odata/v4.0/errata03/csd01/complete/vocabularies/Org.OData.Capabilities.V1.xml">
18 <edmx:Include Namespace="Org.OData.Capabilities.V1" Alias="Capabilities"/>
19 </edmx:Reference>
20 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/Resource_v1.xml">
21 <edmx:Include Namespace="Resource"/>
22 <edmx:Include Namespace="Resource.v1_0_0"/>
23 </edmx:Reference>
24 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/RedfishExtensions_v1.xml">
25 <edmx:Include Namespace="RedfishExtensions.v1_0_0" Alias="Redfish"/>
26 </edmx:Reference>
27 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricDefinitionCollection_v1.xml">
28 <edmx:Include Namespace="MetricDefinitionCollection"/>
29 </edmx:Reference>
30 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricReportDefinitionCollection_v1.xml">
31 <edmx:Include Namespace="MetricReportDefinitionCollection"/>
32 </edmx:Reference>
33 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricReportCollection_v1.xml">
34 <edmx:Include Namespace="MetricReportCollection"/>
35 </edmx:Reference>
36 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/TriggersCollection_v1.xml">
37 <edmx:Include Namespace="TriggersCollection"/>
38 </edmx:Reference>
39 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/LogService_v1.xml">
40 <edmx:Include Namespace="LogService"/>
41 </edmx:Reference>
Marri Devender Raod45d2d02019-01-21 10:11:34 -060042 <edmx:Reference Uri="http://redfish.dmtf.org/schemas/v1/MetricDefinition_v1.xml">
43 <edmx:Include Namespace="MetricDefinition"/>
44 </edmx:Reference>
Ed Tanous530520e2019-01-02 13:41:37 -080045
46 <edmx:DataServices>
47
48 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService">
49 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
50
51 <EntityType Name="TelemetryService" BaseType="Resource.v1_0_0.Resource" Abstract="true">
Ed Tanouscb103132019-10-08 11:34:22 -070052 <Annotation Term="OData.Description" String="The TelemetryService schema describes a Telemetry Service. The Telemetry Service is used to for collecting and reporting metric data within the Redfish Service."/>
53 <Annotation Term="OData.LongDescription" String="This Resource contains a Telemetry Service for a Redfish implementation."/>
Ed Tanous530520e2019-01-02 13:41:37 -080054 <Annotation Term="Capabilities.InsertRestrictions">
55 <Record>
56 <PropertyValue Property="Insertable" Bool="false"/>
57 </Record>
58 </Annotation>
59 <Annotation Term="Capabilities.UpdateRestrictions">
60 <Record>
61 <PropertyValue Property="Updatable" Bool="true"/>
Ed Tanouscb103132019-10-08 11:34:22 -070062 <Annotation Term="OData.Description" String="Any writable properties, such as ServiceEnabled, can be updated for the Telemetry Service."/>
Ed Tanous530520e2019-01-02 13:41:37 -080063 </Record>
64 </Annotation>
65 <Annotation Term="Capabilities.DeleteRestrictions">
66 <Record>
67 <PropertyValue Property="Deletable" Bool="false"/>
68 </Record>
69 </Annotation>
70 <Annotation Term="Redfish.Uris">
71 <Collection>
72 <String>/redfish/v1/TelemetryService</String>
73 </Collection>
74 </Annotation>
75 </EntityType>
76
77 <Action Name="SubmitTestMetricReport" IsBound="true">
Ed Tanouscb103132019-10-08 11:34:22 -070078 <Annotation Term="OData.Description" String="This action generates a metric report."/>
79 <Annotation Term="OData.LongDescription" String="This action shall cause the Event Service to immediately generate the metric report as an alert event. Then, this message should be sent to any appropriate event destinations."/>
Ed Tanous530520e2019-01-02 13:41:37 -080080 <Parameter Name="TelemetryService" Type="TelemetryService.v1_0_0.Actions"/>
81 <Parameter Name="MetricReportName" Type="Edm.String" Nullable="false">
Ed Tanouscb103132019-10-08 11:34:22 -070082 <Annotation Term="OData.Description" String="The name of the metric report in generated metric report."/>
83 <Annotation Term="OData.LongDescription" String="This parameter shall contain the name of the generated metric report."/>
Ed Tanous530520e2019-01-02 13:41:37 -080084 </Parameter>
Marri Devender Raod45d2d02019-01-21 10:11:34 -060085 <Parameter Name="MetricReportValues" Type="Edm.String">
Ed Tanouscb103132019-10-08 11:34:22 -070086 <Annotation Term="OData.Description" String="The contents of MetricReportValues array in the generated metric report."/>
Ed Tanous530520e2019-01-02 13:41:37 -080087 <Annotation Term="OData.LongDescription" String="This parameter shall contain the contents of the MetricReportValues array property in the generated metric report."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -060088 <Annotation Term="Redfish.Revisions">
89 <Collection>
90 <Record>
91 <PropertyValue Property="Kind" EnumMember="Redfish.RevisionKind/Deprecated"/>
92 <PropertyValue Property="Version" String="v1_1_0"/>
Ed Tanouscb103132019-10-08 11:34:22 -070093 <PropertyValue Property="Description" String="This property has been deprecated in favor of using the property 'GeneratedMetricReportValues'."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -060094 </Record>
95 </Collection>
96 </Annotation>
97 </Parameter>
98 <Parameter Name="GeneratedMetricReportValues" Type="Collection(TelemetryService.v1_1_0.MetricValue)" Nullable="false">
99 <Annotation Term="OData.Description" String="The content of the MetricReportValues in the generated metric report."/>
100 <Annotation Term="OData.LongDescription" String="This parameter shall contain the contents of the MetricReportValues array property in the generated metric report."/>
101 <Annotation Term="Redfish.Revisions">
102 <Collection>
103 <Record>
104 <PropertyValue Property="Kind" EnumMember="Redfish.RevisionKind/Added"/>
105 <PropertyValue Property="Version" String="v1_1_0"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700106 <PropertyValue Property="Description" String="This property has been deprecated in favor of using the property 'GeneratedMetricReportValues'."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600107 </Record>
108 </Collection>
109 </Annotation>
Ed Tanous530520e2019-01-02 13:41:37 -0800110 </Parameter>
111 </Action>
112 </Schema>
113
114 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_0_0">
115 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600116 <Annotation Term="Redfish.Release" String="2018.2"/>
Ed Tanous530520e2019-01-02 13:41:37 -0800117
118 <EntityType Name="TelemetryService" BaseType="TelemetryService.TelemetryService">
Ed Tanous530520e2019-01-02 13:41:37 -0800119 <Property Name="Status" Type="Resource.Status" Nullable="false">
Ed Tanouscb103132019-10-08 11:34:22 -0700120 <Annotation Term="OData.Description" String="The status and health of the Resource and its subordinate or dependent Resources."/>
121 <Annotation Term="OData.LongDescription" String="This property shall contain any status or health properties of the Resource."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800122 </Property>
123 <Property Name="MaxReports" Type="Edm.Int64">
124 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700125 <Annotation Term="OData.Description" String="The maximum number of metric reports that this service supports."/>
126 <Annotation Term="OData.LongDescription" String="This property shall contain the maximum number of metric reports that this service supports."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800127 </Property>
128 <Property Name="MinCollectionInterval" Type="Edm.Duration">
129 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700130 <Annotation Term="OData.Description" String="The minimum time interval between gathering metric data that this service allows."/>
131 <Annotation Term="OData.LongDescription" String="This property shall contain the minimum time interval between gathering metric data that this service allows."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800132 </Property>
133 <Property Name="SupportedCollectionFunctions" Type="Collection(TelemetryService.v1_0_0.CollectionFunction)">
134 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/ReadWrite"/>
135 <Annotation Term="OData.Description" String="The functions that can be performed over each metric."/>
Ed Tanouscb103132019-10-08 11:34:22 -0700136 <Annotation Term="OData.LongDescription" String="This property shall contain the function to apply over the collection duration."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800137 </Property>
138
139 <NavigationProperty Name="MetricDefinitions" Type="MetricDefinitionCollection.MetricDefinitionCollection" ContainsTarget="true" Nullable="false">
140 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700141 <Annotation Term="OData.Description" String="The link to the collection of metric definitions."/>
142 <Annotation Term="OData.LongDescription" String="This property shall contain a link to a Resource Collection of type MetricDefinitionCollection."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800143 <Annotation Term="OData.AutoExpandReferences"/>
144 </NavigationProperty>
145 <NavigationProperty Name="MetricReportDefinitions" Type="MetricReportDefinitionCollection.MetricReportDefinitionCollection" ContainsTarget="true" Nullable="false">
146 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700147 <Annotation Term="OData.Description" String="The link to the collection of metric report definitions."/>
148 <Annotation Term="OData.LongDescription" String="This property shall contain a link to a Resource Collection of type MetricReportDefinitionCollection."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800149 <Annotation Term="OData.AutoExpandReferences"/>
150 </NavigationProperty>
151 <NavigationProperty Name="MetricReports" Type="MetricReportCollection.MetricReportCollection" ContainsTarget="true" Nullable="false">
152 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700153 <Annotation Term="OData.Description" String="The link to the collection of metric reports."/>
154 <Annotation Term="OData.LongDescription" String="This property shall contain a link to a Resource Collection of type MetricReportCollection."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800155 <Annotation Term="OData.AutoExpandReferences"/>
156 </NavigationProperty>
157 <NavigationProperty Name="Triggers" Type="TriggersCollection.TriggersCollection" ContainsTarget="true" Nullable="false">
158 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700159 <Annotation Term="OData.Description" String="The link to the collection of triggers, which apply to metrics."/>
160 <Annotation Term="OData.LongDescription" String="This property shall contain a link to a Resource Collection of type TriggersCollection."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800161 <Annotation Term="OData.AutoExpandReferences"/>
162 </NavigationProperty>
Ed Tanouscb103132019-10-08 11:34:22 -0700163 <NavigationProperty Name="LogService" Type="LogService.LogService" Nullable="false">
Ed Tanous530520e2019-01-02 13:41:37 -0800164 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700165 <Annotation Term="OData.Description" String="The link to a Log Service that the Telemetry Service uses. This service may be a dedicated Log Service or a pointer a Log Service under another entity, such as Manager."/>
166 <Annotation Term="OData.LongDescription" String="This property shall contain a link to a Log Service that this Telemetry Service uses."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800167 <Annotation Term="OData.AutoExpandReferences"/>
168 </NavigationProperty>
169 <Property Name="Actions" Type="TelemetryService.v1_0_0.Actions" Nullable="false">
Ed Tanouscb103132019-10-08 11:34:22 -0700170 <Annotation Term="OData.Description" String="The available actions for this Resource."/>
171 <Annotation Term="OData.LongDescription" String="This property shall contain the available actions for this Resource."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800172 </Property>
173 </EntityType>
174
175 <EnumType Name="CollectionFunction">
176 <Annotation Term="OData.Description" String="An operation to perform over the sample."/>
177 <Annotation Term="OData.LongDescription" String="If present, the metric value shall be computed according to this function."/>
178 <Member Name="Average">
179 <Annotation Term="OData.Description" String="An averaging function."/>
180 </Member>
181 <Member Name="Maximum">
182 <Annotation Term="OData.Description" String="A maximum function."/>
183 </Member>
184 <Member Name="Minimum">
185 <Annotation Term="OData.Description" String="A minimum function."/>
186 </Member>
187 <Member Name="Summation">
188 <Annotation Term="OData.Description" String="A summation function."/>
189 </Member>
190 </EnumType>
191
192 <ComplexType Name="Actions">
193 <Annotation Term="OData.AdditionalProperties" Bool="false"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700194 <Annotation Term="OData.Description" String="The available actions for this Resource."/>
195 <Annotation Term="OData.LongDescription" String="This type shall contain the available actions for this Resource."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800196 <Property Name="Oem" Type="TelemetryService.v1_0_0.OemActions" Nullable="false">
Ed Tanouscb103132019-10-08 11:34:22 -0700197 <Annotation Term="OData.Description" String="The available OEM-specific actions for this Resource."/>
198 <Annotation Term="OData.LongDescription" String="This property shall contain the available OEM-specific actions for this Resource."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800199 </Property>
200 </ComplexType>
201
202 <ComplexType Name="OemActions">
203 <Annotation Term="OData.AdditionalProperties" Bool="true"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700204 <Annotation Term="OData.Description" String="The available OEM-specific actions for this Resource."/>
205 <Annotation Term="OData.LongDescription" String="This type shall contain the available OEM-specific actions for this Resource."/>
Ed Tanous530520e2019-01-02 13:41:37 -0800206 </ComplexType>
207 </Schema>
208
Ed Tanouscb103132019-10-08 11:34:22 -0700209 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_0_1">
210 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
211 <Annotation Term="OData.Description" String="This version was created to force the regeneration of JSON Schema so that URI properties use the uri-reference format."/>
212 <EntityType Name="TelemetryService" BaseType="TelemetryService.v1_0_0.TelemetryService"/>
213 </Schema>
214
215 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_0_2">
216 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
217 <Annotation Term="OData.Description" String="This version was created to update the description of the LogService property. It was also created to update descriptions that this schema defines."/>
218 <EntityType Name="TelemetryService" BaseType="TelemetryService.v1_0_1.TelemetryService"/>
219 </Schema>
220
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600221 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_1_0">
222 <Annotation Term="OData.Description" String="This version was created to add the GeneratedMetricReportValues property to the SubmittestMetricReport action."/>
223 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
224 <Annotation Term="Redfish.Release" String="2018.3"/>
225 <EntityType Name="TelemetryService" BaseType="TelemetryService.v1_0_0.TelemetryService"/>
226
227 <ComplexType Name="MetricValue">
228 <Annotation Term="OData.AdditionalProperties" Bool="false"/>
229 <Annotation Term="OData.Description" String="A metric value."/>
230 <Annotation Term="OData.LongDescription" String="A metric value in the context of a Metric."/>
231 <Property Name="MetricId" Type="Edm.String">
232 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
233 <Annotation Term="OData.Description" String="The metric definitions identifier for this metric."/>
Ed Tanouscb103132019-10-08 11:34:22 -0700234 <Annotation Term="OData.LongDescription" String="This property shall contain the same as the Id property of the source metric within the associated MetricDefinition."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600235 </Property>
236 <Property Name="MetricValue" Type="Edm.String">
237 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700238 <Annotation Term="OData.Description" String="The metric value, as a string."/>
239 <Annotation Term="OData.LongDescription" String="This property shall contain the metric value, as a string."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600240 </Property>
241 <Property Name="Timestamp" Type="Edm.DateTimeOffset">
242 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700243 <Annotation Term="OData.Description" String="The time when the metric value is obtained. A management application may establish a time series of metric data by retrieving the instances of metric value and sorting them according to their Timestamp."/>
244 <Annotation Term="OData.LongDescription" String="This property shall contain the time when the metric value was obtained. Note that this may be different from the time when this instance is created."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600245 </Property>
246 <Property Name="MetricProperty" Type="Edm.String">
247 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
248 <Annotation Term="OData.Description" String="The URI for the property from which this metric is derived."/>
Ed Tanouscb103132019-10-08 11:34:22 -0700249 <Annotation Term="OData.LongDescription" String="This property shall contain the URI to the property, which follows the RFC6901-defined JSON fragment notation, to identify an individual property in a Redfish Resource."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600250 <Annotation Term="OData.IsURL"/>
251 </Property>
252 <NavigationProperty Name="MetricDefinition" Type="MetricDefinition.MetricDefinition" Nullable="false">
253 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/Read"/>
Ed Tanouscb103132019-10-08 11:34:22 -0700254 <Annotation Term="OData.Description" String="The link to the metric."/>
255 <Annotation Term="OData.LongDescription" String="The link to the Metric Definition Resource that describes what this metric report captures."/>
Marri Devender Raod45d2d02019-01-21 10:11:34 -0600256 <Annotation Term="OData.AutoExpandReferences"/>
257 </NavigationProperty>
258 </ComplexType>
259 </Schema>
260
Ed Tanouscb103132019-10-08 11:34:22 -0700261 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_1_1">
262 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
263 <Annotation Term="OData.Description" String="This version was created to force the regeneration of JSON Schema so that URI properties use the uri-reference format."/>
264 <EntityType Name="TelemetryService" BaseType="TelemetryService.v1_1_0.TelemetryService"/>
265 </Schema>
266
267 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_1_2">
268 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
269 <Annotation Term="OData.Description" String="This version was created to update the description of the LogService property. It was also created to update descriptions that this schema defines."/>
270 <EntityType Name="TelemetryService" BaseType="TelemetryService.v1_1_1.TelemetryService"/>
271 </Schema>
272
Gunnar Mills09b9d452020-02-11 13:27:39 -0600273 <Schema xmlns="http://docs.oasis-open.org/odata/ns/edm" Namespace="TelemetryService.v1_2_0">
274 <Annotation Term="Redfish.OwningEntity" String="DMTF"/>
275 <Annotation Term="Redfish.Release" String="2019.4"/>
276
277 <EntityType Name="TelemetryService" BaseType="TelemetryService.v1_1_2.TelemetryService">
278 <Property Name="ServiceEnabled" Type="Edm.Boolean">
279 <Annotation Term="OData.Permissions" EnumMember="OData.Permission/ReadWrite"/>
280 <Annotation Term="OData.Description" String="An indication of whether this service is enabled."/>
281 <Annotation Term="OData.LongDescription" String="This property shall indicate whether this service is enabled."/>
282 </Property>
283 </EntityType>
284 </Schema>
285
Ed Tanous530520e2019-01-02 13:41:37 -0800286 </edmx:DataServices>
287</edmx:Edmx>