你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

MonitoringConfiguration

项目
08/05/2023

本主题概述了 Azure 媒体服务遥测/监视 REST 类型： MonitoringConfiguration 和 ComponentMonitoringSettings。媒体服务版本 2.13 中添加了这些类型。

媒体服务遥测/监视允许媒体服务客户访问其服务的指标数据。当前版本支持“Channel”和“StreamingEndpoint”实体的遥测数据。可按组件级的粒度配置遥测。有两种详细级别：“正常”和“详细”。当前版本仅支持“正常”。

遥测数据将写入客户提供的 Azure 存储帐户中的存储表， (存储帐户必须附加到媒体服务帐户) 。遥测系统将为每个新日期（基于 00:00 UTC）单独创建一个表。例如“TelemetryMetrics20160321”，其中的“20160321”是表的创建日期。每天将有一个单独的表。

请注意，遥测系统不管理数据保留。通过删除存储表，可移除旧的遥测数据。

若要为指定的 AMS 帐户启用遥测，必须执行以下操作：

获取已附加到媒体服务帐户的存储帐户的凭据。
创建一个通知终结点，其中 EndPointType 设置为 AzureTable (2) ，endPontAddress 指向存储表 (例如 https://telemetryvalidationstore.table.core.windows.net/ ，) 。有关如何创建通知终结点的信息，请参阅 NotificationEndPoint 主题。
为要监视的服务创建监视配置设置。最多允许一个监视配置设置。有关详细信息，请参阅监视配置操作部分。

重要

访问媒体服务中的实体时，必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息，请参阅设置媒体服务 REST API 开发和使用媒体服务 REST API 连接到媒体服务。

MonitoringConfiguration 实体属性

属性	类型	说明
ID 只读。由媒体服务在创建时设置。	Edm.String	唯一标识符。格式：“nb：mcid：UUID：<GUID>。
NotificationEndPointId	Edm.String	要与此监视配置关联的终结点的通知终结点 ID。
创建只读。由媒体服务在创建时设置。	Edm.DateTime	此值由媒体服务在创建时设置。
LastModified	Edm.Int32	项的上次修改时间。
设置	ComponentMonitoringSettings	组件监视设置。

ComponentMonitoringSettings

属性	类型	说明
组件	Edm.String	监视组件。有效值为： - 通道 (0) - 指定以监视通道。 - StreamingEndpoint (1) - 指定以监视流式处理终结点。
级别	Edm.String	监视级别。有效值为： - 禁用 (0) - 输出将不包含监视消息。 - 正常 (1) - 输出将包含信息性监视消息。 - 详细 (2) - 输出将包含详细的监视消息。

监视配置操作

若要获取最新的 x-ms-version:，请参阅媒体服务 REST。

获取监视配置

请求

GET https://wamsbnp1clus001rest-hs.cloudapp.net/api/MonitoringConfigurations HTTP/1.1  
x-ms-version: 2.19 
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/json; odata=verbose  
Authorization: (redacted)  
Host: wamsbnp1clus001rest-hs.cloudapp.net

响应

HTTP/1.1 200 OK  
Cache-Control: no-cache  
Content-Length: 20  
Content-Type: application/json;odata=verbose;charset=utf-8  
Server: Microsoft-IIS/8.5  
request-id: 00a3ee37-bb19-4fca-b5c7-a92b629d4416  
x-ms-request-id: 00a3ee37-bb19-4fca-b5c7-a92b629d4416  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
access-control-expose-headers: request-id, x-ms-request-id  
X-Powered-By: ASP.NET  
Strict-Transport-Security: max-age=31536000; includeSubDomains  
Date: Wed, 02 Dec 2015 05:10:42 GMT  
{"d":{"results":[]}}

添加监视配置

请求

POST https://wamsbnp1clus001rest-hs.cloudapp.net/api/MonitoringConfigurations HTTP/1.1  
x-ms-version: 2.19 
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/json; odata=verbose  
Authorization: (redacted)  
Content-Type: application/json; charset=utf-8  
Host: wamsbnp1clus001rest-hs.cloudapp.net  
Content-Length: 133  
{"NotificationEndPointId":"nb:nepid:UUID:76bb4faf-ea29-4815-840a-9a8e20102fc4","Settings":[{"Component":"Channel","Level":"Normal"}]}

响应

HTTP/1.1 201 Created  
Cache-Control: no-cache  
Content-Length: 825  
Content-Type: application/json;odata=verbose;charset=utf-8  
Location: https://wamsbnp1clus001rest-hs.cloudapp.net/api/MonitoringConfigurations('nb%3Amcid%3AUUID%3A1a8931ae-799f-45fd-8aeb-9641740295c2')  
Server: Microsoft-IIS/8.5  
request-id: daede9cb-8684-41b0-a921-a3af66430cbe  
x-ms-request-id: daede9cb-8684-41b0-a921-a3af66430cbe  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
access-control-expose-headers: request-id, x-ms-request-id  
X-Powered-By: ASP.NET  
Strict-Transport-Security: max-age=31536000; includeSubDomains  
Date: Wed, 02 Dec 2015 05:10:43 GMT  
{"d":{"__metadata":{"id":"https://wamsbnp1clus001rest-hs.cloudapp.net/api/MonitoringConfigurations('nb%3Amcid%3AUUID%3A1a8931ae-799f-45fd-8aeb-9641740295c2')","uri":"https://wamsbnp1clus001rest-hs.cloudapp.net/api/MonitoringConfigurations('nb%3Amcid%3AUUID%3A1a8931ae-799f-45fd-8aeb-9641740295c2')","type":"Microsoft.Cloud.Media.Vod.Rest.Data.Models.MonitoringConfiguration"},"Id":"nb:mcid:UUID:1a8931ae-799f-45fd-8aeb-9641740295c2","NotificationEndPointId":"nb:nepid:UUID:76bb4faf-ea29-4815-840a-9a8e20102fc4","Created":"2015-12-02T05:10:43.7680396Z","LastModified":"2015-12-02T05:10:43.7680396Z","Settings":{"__metadata":{"type":"Collection(Microsoft.Cloud.Media.Vod.Rest.Data.Models.ComponentMonitoringSettings)"},"results":[{"Component":"Channel","Level":"Normal"},{"Component":"StreamingEndpoint","Level":"Disabled"}]}}}

Share via