閱讀英文

共用方式為


MonitoringConfiguration

本主題提供 Azure 媒體服務遙測/監視 REST 類型的概觀: MonitoringConfigurationComponentMonitoringSettings 。 這些類型已在媒體服務 2.13 版中新增。

媒體服務遙測/監視可讓媒體服務客戶存取其服務的度量資料。 目前的版本支援 "Channel" 和 "StreamingEndpoint" 實體的遙測資料。 您可以設定元件層級細微度的遙測。 詳細資料層級可分為「正常」和「詳細資訊」兩種。 目前的版本僅支援「正常」。

遙測會寫入由客戶提供的 Azure 儲存體帳戶中的儲存體資料表 (儲存體帳戶必須附加至媒體服務帳戶)。 遙測系統會以 00:00 UTC 為基準為每一天建立個別的資料表。 以 "TelemetryMetrics20160321" 為例,其中的 "20160321" 即代表資料表的建立日期。 每天都會有個別的資料表。

請注意遙測系統不會管理資料保留。 您可以刪除儲存體資料表來移除舊的遙測資料。

若要啟用指定 AMS 帳戶的遙測,您必須執行下列動作:

  • 取得媒體服務帳戶附加之儲存體帳戶的認證。

  • 建立端點,並將 EndPointType 設定為 AzureTable (2) ,並指向儲存體資料表 (,例如 https://telemetryvalidationstore.table.core.windows.net/) 。 如需如何建立通知端點的詳細資訊,請參閱 NotificationEndPoint 主題。

  • 針對要監視的服務建立監視組態設定。 系統最多只允許一個監視組態設定。 如需詳細資訊,請參閱 監視組態作業 一節。

重要

在媒體服務中存取實體時,您必須在 HTTP 要求中設定特定的標頭欄位和值。
如需詳細資訊,請參閱媒體服務 REST API 開發和使用媒體服務 REST API 連線到媒體服務

MonitoringConfiguration 實體屬性

屬性 類型 Description
識別碼

唯讀。 在建立時由媒體服務設定。
Edm.String 唯一識別碼。 格式:「nb:mcid:UUID: < GUID > 。
NotificationEndPointId Edm.String 您想要與此監視組態建立關聯的端點通知端點識別碼。
建立時間

唯讀。 在建立時由媒體服務設定。
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"}]}}}