MonitoringConfiguration

Artículo
08/05/2023

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