Condividi tramite


MonitoringConfiguration

In questo argomento viene fornita una panoramica dei tipi di telemetria/monitoraggio di Servizi multimediali di Azure: MonitoringConfiguration e ComponentMonitoringSettings. Questi tipi sono stati aggiunti nella versione 2.13 di Servizi multimediali.

La telemetria e il monitoraggio di Servizi multimediali consentono ai clienti di accedere ai dati di metrica per i servizi. La versione corrente supporta i dati di telemetria per le entità "Channel" e "StreamingEndpoint". È possibile configurare i dati di telemetria con granularità a livello di componente. Esistono due livelli di dettaglio: "Normal" e "Verbose". La versione corrente supporta solo "Normal".

I dati di telemetria vengono scritti in una tabella di archiviazione in un account di archiviazione di Azure fornito dal cliente (l'account di archiviazione deve essere collegato all'account di Servizi multimediali). Il sistema di telemetria creerà una tabella separata per ogni nuovo giorno in base alle 00:00 UTC. Ad esempio, "TelemetryMetrics20160321" dove "20160321" è la data di creazione della tabella. Per ogni giorno ci sarà una tabella separata.

Si noti che il sistema di telemetria non gestisce la conservazione dei dati. È possibile rimuovere i vecchi dati di telemetria eliminando le tabelle di archiviazione.

Per abilitare i dati di telemetria per l'account AMS specificato, è necessario eseguire le operazioni seguenti:

Importante

Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP.
Per altre informazioni, vedere Configurazione per lo sviluppo di API REST di Servizi multimediali e connessione a Servizi multimediali con l'API REST di Servizi multimediali.

Proprietà dell'entità MonitoringConfiguration

Proprietà Type Descrizione
ID

Di sola lettura. Impostato da Servizi multimediali in fase di creazione.
Edm.String Identificatore univoco. Formato: "nb:mcid:UUID:<GUID>.
NotificationEndPointId Edm.String ID dell'endpoint di notifica dell'endpoint che si vuole associare a questa configurazione di monitoraggio.
Data di creazione

Di sola lettura. Impostato da Servizi multimediali in fase di creazione.
Edm.DateTime Questo valore viene impostato da Servizi multimediali in fase di creazione.
LastModified Edm.Int32 Ultima volta modificata dell'elemento.
Impostazioni ComponentMonitoringSettings Impostazioni di monitoraggio dei componenti.

ComponentMonitoringSettings

Proprietà Type Descrizione
Componente Edm.String Componente di monitoraggio. I valori validi sono:

- Canale (0) - specificare per monitorare un canale.
- StreamingEndpoint (1) - specificare per monitorare un endpoint di streaming.
Level Edm.String Livello di monitoraggio. I valori validi sono:

- Disabilitato (0): l'output non conterrà messaggi di monitoraggio.
- Normale (1) - L'output conterrà messaggi di monitoraggio informativi.
- Verbose(2) - l'output conterrà messaggi di monitoraggio dettagliati.

Monitoraggio delle operazioni di configurazione

Per ottenere l'ultima versione x-ms-version:, vedere REST servizi multimediali.

Ottenere configurazioni di monitoraggio

Richiesta

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  

Risposta

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

Aggiungere una configurazione di monitoraggio

Richiesta

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

Risposta

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