MonitoringConfiguration

Article
07/19/2023

Cette rubrique fournit une vue d’ensemble des types REST de télémétrie/surveillance Azure Media Services : MonitoringConfiguration et ComponentMonitoringSettings. Ces types ont été ajoutés dans Media Services version 2.13.

La télémétrie et la surveillance Media Services permettent aux clients Media Services d’accéder aux données de métriques pour ces services. La version actuelle prend en charge les données de télémétrie des entités « Channel » et « StreamingEndpoint ». Vous pouvez configurer la télémétrie sur une granularité au niveau du composant. Il existe deux niveaux de détail : « Normal » et « Détaillé ». La version actuelle prend uniquement en charge « Normal ».

La télémétrie est écrite sur une table de stockage dans un compte Azure Storage fourni par le client (le compte de stockage doit être attaché au compte Media Services). Le système de télémétrie crée une table distincte pour chaque nouveau jour basé sur l’heure UTC 00:00. Par exemple « TelemetryMetrics20160321», où « 20160321» est la date de création de la table. Une table distincte est créée pour chaque jour.

Notez que le système de télémétrie ne gère pas la rétention des données. Vous pouvez supprimer les anciennes données de télémétrie en supprimant les tables de stockage.

Pour activer la télémétrie pour le compte AMS spécifié, vous devez effectuer les opérations suivantes :

Obtenez les informations d’identification du compte de stockage associé au compte Media Services.
Créez un point de terminaison de notification avec EndPointType défini sur AzureTable (2) et endPontAddress pointant vers la table de stockage (par exemple, https://telemetryvalidationstore.table.core.windows.net/). Pour plus d’informations sur la création d’un point de terminaison de notification, consultez la rubrique NotificationEndPoint .
Créez des paramètres de configuration de la surveillance pour les services que vous souhaitez surveiller. Pas plus d’un paramètre de configuration de la surveillance n’est autorisé. Pour plus d’informations, consultez la section Opérations de configuration de surveillance .

Important

Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Propriétés de l’entité MonitoringConfiguration

Propriété	Type	Description
Id Lecture seule. Défini par Media Services au moment de la création.	Edm.String	Identificateur unique. Format : « nb:mcid:UUID:<GUID>.
NotificationEndPointId	Edm.String	ID de point de terminaison de notification du point de terminaison que vous souhaitez associer à cette configuration de surveillance.
Date de création Lecture seule. Défini par Media Services au moment de la création.	Edm.DateTime	Cette valeur est définie par Media Services au moment de la création.
LastModified	Edm.Int32	Heure de la dernière modification de l’élément.
Paramètres	ComponentMonitoringSettings	Paramètres de surveillance des composants.

ComponentMonitoringSettings

Propriété	Type	Description
Composant	Edm.String	Composant d’analyse. Les valeurs autorisées sont : - Canal (0) : spécifiez pour surveiller un canal. - StreamingEndpoint (1) : spécifiez pour surveiller un point de terminaison de streaming.
Level	Edm.String	Niveau de surveillance. Les valeurs autorisées sont : - Désactivé (0) : la sortie ne contient aucun message d’analyse. - Normal (1) : la sortie contient des messages d’analyse d’informations. - Détaillé(2) : la sortie contiendra des messages de surveillance détaillés.

Surveillance des opérations de configuration

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

Obtenir des configurations de surveillance

Requête

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

Réponse

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

Ajouter une configuration de surveillance