MonitoringConfiguration
本主題提供 Azure 媒體服務遙測/監視 REST 類型的概觀: MonitoringConfiguration
和 ComponentMonitoringSettings
。 這些類型已在媒體服務 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 連線到媒體服務。
屬性 | 類型 | Description |
---|---|---|
識別碼 唯讀。 在建立時由媒體服務設定。 |
Edm.String | 唯一識別碼。 格式:「nb:mcid:UUID: < GUID > 。 |
NotificationEndPointId | Edm.String | 您想要與此監視組態建立關聯的端點通知端點識別碼。 |
建立時間 唯讀。 在建立時由媒體服務設定。 |
Edm.DateTime | 此值是由媒體服務在建立時設定。 |
LastModified | Edm.Int32 | 專案的最後一次修改時間。 |
設定 | 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"}]}}}