Delen via


MonitoringConfiguration

In dit onderwerp vindt u een overzicht van de Azure Media Services-telemetrie-/bewakings-REST-typen: MonitoringConfiguration en ComponentMonitoringSettings. Deze typen zijn toegevoegd in Media Services versie 2.13.

Media Services-telemetrie/-bewaking biedt Media Services-klanten toegang tot metrische gegevens voor de services. De huidige versie ondersteunt telemetriegegevens voor de entiteiten 'Channel' en 'StreamingEndpoint'. U kunt telemetrie configureren op granulariteit op onderdeelniveau. Er zijn twee detailniveaus 'Normaal' en 'Uitgebreid'. De huidige versie ondersteunt alleen 'Normaal'.

Telemetrie wordt geschreven naar een opslagtabel in een Azure Storage-account dat is opgegeven door de klant (het opslagaccount moet worden gekoppeld aan het Media Services-account). Het telemetriesysteem maakt een afzonderlijke tabel voor elke nieuwe dag op basis van 00:00 UTC. Als voorbeeld 'TelemetryMetrics20160321' waarbij '20160321' de datum is waarop de tabel is gemaakt. Voor elke dag is er een aparte tabel.

Houd er rekening mee dat het telemetriesysteem geen gegevensretentie beheert. U kunt de oude telemetriegegevens verwijderen door de opslagtabellen te verwijderen.

Als u telemetrie wilt inschakelen voor het opgegeven AMS-account, moet u het volgende doen:

  • Haal de referenties op van het opslagaccount dat is gekoppeld aan het Media Services-account.

  • Maak een meldingseindpunt waarbij EndPointType is ingesteld op AzureTable (2) en endPontAddress verwijst naar de opslagtabel (bijvoorbeeld https://telemetryvalidationstore.table.core.windows.net/). Zie het onderwerp NotificationEndPoint voor meer informatie over het maken van een meldingseindpunt.

  • Maak een bewakingsconfiguratie-instellingen voor de services die u wilt bewaken. Er is niet meer dan één bewakingsconfiguratie-instellingen toegestaan. Zie de sectie Configuratiebewerkingen bewaken voor meer informatie.

Belangrijk

Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

Eigenschappen van de entiteit MonitoringConfiguration

Eigenschap Type Beschrijving
Id

Alleen-lezen. Ingesteld door Media Services tijdens het maken.
Edm.String Unieke id. Indeling: "nb:mcid:UUID:<GUID>.
NotificationEndPointId Edm.String De eindpunt-id van de melding van het eindpunt dat u wilt koppelen aan deze bewakingsconfiguratie.
Gemaakt

Alleen-lezen. Ingesteld door Media Services tijdens het maken.
Edm.DateTime Deze waarde wordt ingesteld door Media Services tijdens het maken.
Lastmodified Edm.Int32 Het tijdstip van de laatste wijziging van het item.
Instellingen ComponentMonitoringSettings De instellingen voor onderdeelbewaking.

ComponentMonitoringSettings

Eigenschap Type Beschrijving
Onderdeel Edm.String Het bewakingsonderdeel. Geldige waarden zijn:

- Kanaal (0) - geef op om een kanaal te bewaken.
- StreamingEndpoint (1): geef op om een streaming-eindpunt te bewaken.
Niveau Edm.String Het bewakingsniveau. Geldige waarden zijn:

- Uitgeschakeld (0): de uitvoer bevat geen bewakingsberichten.
- Normaal (1) - uitvoer bevat informatieve bewakingsberichten.
- Uitgebreid(2): de uitvoer bevat gedetailleerde bewakingsberichten.

Configuratiebewerkingen bewaken

Zie Media Services REST voor de meest recente x-ms-version:versie.

Bewakingsconfiguraties ophalen

Aanvraag

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  

Response

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":[]}}  

Een bewakingsconfiguratie toevoegen

Aanvraag

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"}]}  

Response

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"}]}}}