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