MonitoringConfiguration

아티클
08/05/2023

이 항목에서는 Azure Media Services 원격 분석/모니터링 REST 유형 MonitoringConfigurationComponentMonitoringSettings및 에 대한 개요를 제공합니다. 이러한 형식은 Media Services 버전 2.13에 추가되었습니다.

Media Services 고객은 Media Services 원격 분석/모니터링을 통해 서비스에 대한 메트릭 데이터에 액세스할 수 있습니다. 현재 버전에서는 "Channel" 및 "StreamingEndpoint" 엔터티에 대한 원격 분석 데이터를 지원합니다. 구성 요소 세분성 수준에서 원격 분석을 구성할 수 있습니다. "Normal" 및 "Verbose"라는 두 가지 세부 수준이 있습니다. 현재 버전은 "Normal"만 지원합니다.

원격 분석은 고객이 제공한 Azure Storage 계정의 스토리지 테이블에 기록됩니다(Storage 계정은 Media Services 계정에 연결되어야 함). 원격 분석 시스템은 00:00 UTC 기반으로 각 날마다 별도의 테이블을 만듭니다. 예를 들어 "TelemetryMetrics20160321"에서 "20160321"은 테이블이 생성된 날짜입니다. 각 날짜에 대한 별도의 테이블이 있습니다.

원격 분석 시스템은 데이터 보존을 관리하지 않습니다. 스토리지 테이블을 삭제하여 이전 원격 분석 데이터를 제거할 수 있습니다.

지정된 AMS 계정에 대한 원격 분석을 사용하도록 설정하려면 다음을 수행해야 합니다.

Media Services 계정에 연결된 스토리지 계정의 자격 증명을 가져옵니다.
EndPointType이 AzureTable(2)으로 설정되고 endPontAddress가 스토리지 테이블을 가리키는 알림 엔드포인트를 만듭니다(예: https://telemetryvalidationstore.table.core.windows.net/). 알림 엔드포인트를 만드는 방법에 대한 자세한 내용은 NotificationEndPoint 항목을 참조하세요.
모니터링할 서비스에 대한 모니터링 구성 설정을 만듭니다. 한 개 이하의 모니터링 구성 설정이 허용됩니다. 자세한 내용은 구성 작업 모니터링 섹션을 참조하세요 .

중요

Media Services에서 엔터티에 액세스할 때는 HTTP 요청에서 구체적인 헤더 필드와 값을 설정해야 합니다.
자세한 내용은 Media Services REST API 개발 설정 및 Media Services REST API 를 사용하여 Media Services에 연결을 참조하세요.

MonitoringConfiguration 엔터티 속성

속성	형식	설명
Id 읽기 전용입니다. 만들 때 Media Services에서 설정합니다.	Edm.String	고유 식별자입니다. 형식: "nb:mcid:UUID:<GUID>.
NotificationEndPointId	Edm.String	이 모니터링 구성과 연결하려는 엔드포인트의 알림 엔드포인트 ID입니다.
생성일 읽기 전용입니다. 만들 때 Media Services에서 설정합니다.	Edm.DateTime	이 값은 생성 시 Media Services에 의해 설정됩니다.
LastModified	Edm.Int32	항목의 마지막으로 수정된 시간입니다.
설정	ComponentMonitoringSettings	구성 요소 모니터링 설정입니다.

ComponentMonitoringSettings

속성	형식	Description
구성 요소	Edm.String	모니터링 구성 요소입니다. 유효한 값은 다음과 같습니다. - 채널(0) - 채널을 모니터링하도록 지정합니다. - StreamingEndpoint (1) - 스트리밍 엔드포인트를 모니터링하도록 지정합니다.
Level	Edm.String	모니터링 수준입니다. 유효한 값은 다음과 같습니다. - 사용 안 함(0) - 출력에 모니터링 메시지가 포함되지 않습니다. - 보통(1) - 출력에 정보 모니터링 메시지가 포함됩니다. - 자세한 정보 표시(2) - 출력에 자세한 모니터링 메시지가 포함됩니다.

구성 작업 모니터링

최신 x-ms-version:을 얻으려면 Media Services 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