MonitoringConfiguration

Статья
08/05/2023

В этом разделе приводятся общие сведения о типах rest телеметрии и мониторинга Служб мультимедиа Azure: MonitoringConfiguration и ComponentMonitoringSettings. Эти типы были добавлены в Службах мультимедиа версии 2.13.

Благодаря функциям телеметрии и мониторинга служб мультимедиа клиенты могут получать доступ к данным метрик для своих служб. Текущая версия поддерживает данные телеметрии для сущностей Channel и StreamingEndpoint. Телеметрию можно настроить на уровне компонента. Существует два уровня детализации: "Обычный" и "Подробный". Текущая версия поддерживает только "Обычный".

Данные телеметрии записываются таблицу хранилища в учетной записи хранения Azure, предоставленной клиентом (эту учетную запись нужно подключить к учетной записи служб мультимедиа). Система телеметрии будет создавать отдельную таблицу для данных по каждому новому дню в 00:00 UTC. К примеру, с именем TelemetryMetrics20160321, где 20160321 — это дата создания таблицы. Для каждого дня будет создана отдельная таблица.

Обратите внимание, что система телеметрии не управляет периодом хранения данных. Вы можете удалить устаревшие данные телеметрии, удалив таблицы хранилища.

Чтобы включить телеметрию для указанной учетной записи AMS, необходимо выполнить следующие действия:

Получите учетные данные учетной записи хранения, подключенной к учетной записи служб мультимедиа.
Создайте конечную точку уведомления с параметром EndPointType, равным AzureTable (2), и endPontAddress, указывающим на таблицу хранилища (например, https://telemetryvalidationstore.table.core.windows.net/). Сведения о создании конечной точки уведомления см. в разделе NotificationEndPoint .
Создайте параметры конфигурации мониторинга служб, которые требуется отслеживать. Разрешено не более одного параметра конфигурации мониторинга. Дополнительные сведения см. в разделе Мониторинг операций конфигурации .

Важно!

При доступе к сущностям в службах мультимедиа необходимо задать определенные поля и значения заголовков в HTTP-запросах.
Дополнительные сведения см. в разделе Настройка разработки REST API Служб мультимедиа и подключение к службам мультимедиа с помощью REST API Служб мультимедиа.

Свойства сущности MonitoringConfiguration

Свойство	Тип	Описание
Идентификатор Только для чтения. Устанавливается службой мультимедиа во время создания.	Edm.String	Уникальный идентификатор. Формат: "nb:mcid:UUID:<GUID>.
NotificationEndPointId	Edm.String	Идентификатор конечной точки уведомления конечной точки, которую необходимо связать с этой конфигурацией мониторинга.
Создание Только для чтения. Устанавливается службой мультимедиа во время создания.	Edm.DateTime	Это значение задается Службами мультимедиа во время создания.
LastModified	Edm.Int32	Время последнего изменения элемента.
Параметры	ComponentMonitoringSettings	Параметры мониторинга компонентов.

ComponentMonitoringSettings

Свойство	Тип	Описание
Компонент	Edm.String	Компонент мониторинга. Допустимые значения: — Канал (0) — укажите для мониторинга канала. — StreamingEndpoint (1) — указывает для мониторинга конечной точки потоковой передачи.
Level	Edm.String	Уровень мониторинга. Допустимые значения: — отключено (0) — выходные данные не будут содержать сообщений мониторинга. — Обычный (1) — выходные данные будут содержать информационные сообщения мониторинга. - Verbose(2) — выходные данные будут содержать подробные сообщения мониторинга.

Мониторинг операций конфигурации

Сведения о том, как получить последнюю версию x-ms-version:, см. в разделе REST Служб мультимедиа.

Получение конфигураций мониторинга

Запрос

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

Ответ

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

Добавление конфигурации мониторинга