MonitoringConfiguration

Artikel
08/05/2023

Dieses Thema bietet eine Übersicht über die Azure Media Services-Telemetrie-/Überwachungs-REST-Typen: MonitoringConfiguration und ComponentMonitoringSettings. Diese Typen wurden in Media Services Version 2.13 hinzugefügt.

Die Media Services-Telemetrie/-Überwachung ermöglicht Media Services-Kunden den Zugriff auf Metrikdaten für die entsprechenden Dienste. Die aktuelle Version unterstützt Telemetriedaten für die Entitäten „Channel“ und „StreamingEndpoint“. Die Telemetrie kann auf Komponentenebene konfiguriert werden. Dabei stehen zwei Detailstufen zur Verfügung: „Normal“ und „Ausführlich“. Die aktuelle Version unterstützt nur „Normal“.

Die Telemetrie wird in eine vom Kunden angegebene Speichertabelle im Azure-Speicherkonto geschrieben (Das Speicherkonto muss mit dem Media Services-Konto verknüpft sein.). Das Telemetriesystem erstellt für jeden neuen Tag (Grundlage: 00:00 UTC) eine separate Tabelle. Beispiel: „TelemetryMetrics20160321“, wobei „20160321“ das Erstellungsdatum der Tabelle ist. Für jeden Tag wird eine separate Tabelle erstellt.

Beachten Sie, dass das Telemetriesystem keine Beibehaltung der Daten verwaltet. Sie können die alten Telemetriedaten durch Löschen der Speichertabellen entfernen.

Um Telemetriedaten für das angegebene AMS-Konto zu aktivieren, müssen Sie die folgenden Schritte ausführen:

Ermitteln Sie die Anmeldeinformationen des mit dem Media Services-Konto verknüpften Speicherkontos.
Erstellen Sie einen Benachrichtigungsendpunkt, wobei EndPointType auf AzureTable (2) und endPontAddress festgelegt ist, https://telemetryvalidationstore.table.core.windows.net/der auf die Speichertabelle verweist (z. B. ). Informationen zum Erstellen eines Benachrichtigungsendpunkts finden Sie im Thema NotificationEndPoint .
Erstellen Sie eine Überwachungskonfigurationseinstellung für die zu überwachenden Dienste. Mehrere Überwachungskonfigurationseinstellungen sind nicht zulässig. Weitere Informationen finden Sie im Abschnitt Überwachen von Konfigurationsvorgängen .

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

Eigenschaften der MonitoringConfiguration-Entität

Eigenschaft	type	BESCHREIBUNG
Id Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.	Edm.String	Eindeutiger Bezeichner. Format: "nb:mcid:UUID:<GUID>.
NotificationEndPointId	Edm.String	Die Benachrichtigungsendpunkt-ID des Endpunkts, den Sie dieser Überwachungskonfiguration zuordnen möchten.
Erstellt Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.	Edm.DateTime	Dieser Wert wird von Media Services zum Zeitpunkt der Erstellung festgelegt.
LastModified	Edm.Int32	Der Zeitpunkt der letzten Änderung des Elements.
Einstellungen	ComponentMonitoringSettings	Die Einstellungen für die Komponentenüberwachung.

ComponentMonitoringSettings

Eigenschaft	type	BESCHREIBUNG
Komponente	Edm.String	Die Überwachungskomponente. Gültige Werte sind: – Kanal (0): Geben Sie an, um einen Kanal zu überwachen. – StreamingEndpoint (1): Geben Sie an, um einen Streamingendpunkt zu überwachen.
Ebene	Edm.String	Die Überwachungsebene. Gültige Werte sind: – Deaktiviert (0): Die Ausgabe enthält keine Überwachungsmeldungen. - Normal (1): Die Ausgabe enthält Informationsmeldungen zur Überwachung. - Verbose(2): Die Ausgabe enthält detaillierte Überwachungsmeldungen.

Überwachen von Konfigurationsvorgängen

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.

Abrufen von Überwachungskonfigurationen

Anforderung

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

Antwort

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

Hinzufügen einer Überwachungskonfiguration