MonitoringConfiguration
En este tema se proporciona información general sobre los tipos REST de telemetría y supervisión de Azure Media Services: MonitoringConfiguration y ComponentMonitoringSettings. Estos tipos se agregaron en la versión 2.13 de Media Services.
La telemetría y supervisión de los Media Services permite a los clientes de los mismos tener acceso a datos de métricas para sus servicios. La versión actual es compatible con los datos de telemetría para entidades Channel y StreamingEndpoint. Puede configurar la telemetría en la granularidad de nivel de componente. Hay dos niveles de detalle "Normal" y "Detallado". La versión actual solo admite "Normal".
La telemetría se escribe en una tabla de almacenamiento de una cuenta de Azure Storage proporcionada por el cliente (la cuenta de Media Services tiene que tener adjunta una cuenta de almacenamiento). El sistema de telemetría creará una tabla independiente para cada día nuevo basada en 00:00 UTC. Por ejemplo "TelemetryMetrics20160321" donde "20160321" es la fecha de la tabla creada. Habrá una tabla independiente para cada día.
Tenga en cuenta que el sistema de telemetría no administra la retención de datos. Puede quitar los datos antiguos de telemetría eliminando las tablas de almacenamiento.
Para habilitar la telemetría para la cuenta de AMS especificada, debe hacer lo siguiente:
Obtener las credenciales de la cuenta de almacenamiento vinculada a la cuenta de Media Services.
Cree un punto de conexión de notificación con EndPointType establecido en AzureTable (2) y endPontAddress que apunte a la tabla de almacenamiento (por ejemplo, https://telemetryvalidationstore.table.core.windows.net/). Para obtener información sobre cómo crear un punto de conexión de notificación, vea el tema NotificationEndPoint .
Crear unos valores de configuración de supervisión para los servicios que desea supervisar. No se permite más que una configuración de supervisión. Para más información, consulte la sección Supervisión de operaciones de configuración .
Importante
Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración para el desarrollo de api REST de Media Services y conexión a Media Services con la API REST de Media Services.
Propiedades de entidad MonitoringConfiguration
| Propiedad | Tipo | Descripción |
|---|---|---|
| Identificador Solo lectura. Establezca por Media Services en el momento de la creación. |
Edm.String | Identificador único. Formato: "nb:mcid:UUID:<GUID>. |
| NotificationEndPointId | Edm.String | Identificador del punto de conexión de notificación del punto de conexión que desea asociar a esta configuración de supervisión. |
| Creado Solo lectura. Establezca por Media Services en el momento de la creación. |
Edm.DateTime | Media Services establece este valor en el momento de la creación. |
| LastModified | Edm.Int32 | Hora de la última modificación del elemento. |
| Configuración | ComponentMonitoringSettings | Configuración de supervisión de componentes. |
ComponentMonitoringSettings
| Propiedad | Tipo | Descripción |
|---|---|---|
| Componente | Edm.String | Componente de supervisión. Los valores válidos son: - Canal (0): especifique para supervisar un canal. - StreamingEndpoint (1): especifique para supervisar un punto de conexión de streaming. |
| Nivel | Edm.String | Nivel de supervisión. Los valores válidos son: - Deshabilitado (0): la salida no contendrá mensajes de supervisión. - Normal (1): la salida contendrá mensajes de supervisión informativos. - Verbose(2): la salida contendrá mensajes detallados de supervisión. |
Supervisión de operaciones de configuración
Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.
Obtención de configuraciones de supervisión
Solicitud
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
Respuesta
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":[]}}
Agregar una configuración de supervisión
Solicitud
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"}]}
Respuesta
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"}]}}}