MonitorowanieKonfiguracja
Ten temat zawiera omówienie typów rest telemetrii/monitorowania usługi Azure Media Services: MonitoringConfiguration i ComponentMonitoringSettings. Te typy zostały dodane w usłudze Media Services w wersji 2.13.
Usługa Media Services telemetria/monitorowanie umożliwia klientom usługi Media Services dostęp do danych metryk dla swoich usług. Bieżąca wersja obsługuje dane telemetryczne dla jednostek "Channel" i "StreamingEndpoint". Telemetrię można skonfigurować na poziomie składnika stopnia szczegółowości. Istnieją dwa poziomy szczegółów "Normal" i "Verbose". Bieżąca wersja obsługuje tylko wartość "Normal".
Dane telemetryczne są zapisywane w tabeli magazynu na koncie usługi Azure Storage dostarczonym przez klienta (konto magazynu musi być dołączone do konta usługi Media Services). System telemetrii utworzy oddzielną tabelę dla każdego nowego dnia na podstawie 00:00 CZASU UTC. Jako przykład "Telemetrymetrymetrys20160321", gdzie "20160321" to data utworzenia tabeli. Dla każdego dnia będzie dostępna oddzielna tabela.
Należy pamiętać, że system telemetrii nie zarządza przechowywaniem danych. Stare dane telemetryczne można usunąć, usuwając tabele magazynu.
Aby włączyć telemetrię dla określonego konta usługi AMS, należy wykonać następujące czynności:
Pobierz poświadczenia konta magazynu dołączonego do konta usługi Media Services.
Utwórz punkt końcowy powiadomień z ustawieniem EndPointType na wartość AzureTable (2) i endPontAddress wskazującą tabelę magazynu (na przykład https://telemetryvalidationstore.table.core.windows.net/). Aby uzyskać informacje o sposobie tworzenia punktu końcowego powiadomień, zobacz Temat NotificationEndPoint .
Utwórz ustawienia konfiguracji monitorowania dla usług, które chcesz monitorować. Nie jest dozwolone więcej niż jedno ustawienie konfiguracji monitorowania. Aby uzyskać szczegółowe informacje, zobacz sekcję Monitorowanie operacji konfiguracji .
Ważne
Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Konfigurowanie tworzenia interfejsu API REST usługi Media Services i nawiązywanie połączenia z usługą Media Services przy użyciu interfejsu API REST usługi Media Services.
MonitoringConfiguration, właściwości jednostki
| Właściwość | Typ | Opis |
|---|---|---|
| Id Tylko do odczytu. Ustaw przez usługę Media Services w czasie tworzenia. |
Edm.String | Unikatowy identyfikator. Format: "nb:mcid:UUID:<GUID>. |
| NotificationEndPointId | Edm.String | Identyfikator punktu końcowego powiadomień punktu końcowego, który chcesz skojarzyć z tą konfiguracją monitorowania. |
| Utworzone Tylko do odczytu. Ustaw przez usługę Media Services w czasie tworzenia. |
Edm.DateTime | Ta wartość jest ustawiana przez usługę Media Services w czasie tworzenia. |
| Lastmodified | Edm.Int32 | Czas ostatniej modyfikacji elementu. |
| Ustawienia | ComponentMonitoringSettings | Ustawienia monitorowania składników. |
ComponentMonitoringSettings
| Właściwość | Typ | Opis |
|---|---|---|
| Składnik | Edm.String | Składnik monitorowania. Prawidłowe wartości: - Kanał (0) — określ, aby monitorować kanał. - StreamingEndpoint (1) — określ, aby monitorować punkt końcowy przesyłania strumieniowego. |
| Poziom | Edm.String | Poziom monitorowania. Prawidłowe wartości: - Wyłączone (0) — dane wyjściowe nie będą zawierać komunikatów monitorowania. - Normalny (1) — dane wyjściowe będą zawierać informacyjne komunikaty monitorowania. - Pełne(2) — dane wyjściowe będą zawierać szczegółowe komunikaty monitorowania. |
Monitorowanie operacji konfiguracji
Aby uzyskać najnowszą wersję x-ms-version:, zobacz Media Services REST.
Pobieranie konfiguracji monitorowania
Żądanie
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
Odpowiedź
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":[]}}
Dodawanie konfiguracji monitorowania
Żądanie
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"}]}
Odpowiedź
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"}]}}}