MonitoringConfiguration

Artigo
08/05/2023

Este tópico apresenta uma descrição geral dos tipos rest de telemetria/monitorização dos Serviços de Multimédia do Azure: MonitoringConfiguration e ComponentMonitoringSettings. Estes tipos foram adicionados na versão 2.13 dos Serviços de Multimédia.

A telemetria/monitorização dos Serviços de Multimédia permite que os clientes dos Serviços de Multimédia acedam aos dados de métricas dos respetivos serviços. A versão atual suporta dados telemétricos para entidades "Channel" e "StreamingEndpoint". Pode configurar a telemetria numa granularidade ao nível do componente. Existem dois níveis de detalhe "Normal" e "Verboso". A versão atual só suporta "Normal".

A telemetria é escrita numa tabela de armazenamento numa conta de Armazenamento do Azure fornecida pelo cliente (a conta de armazenamento tem de ser anexada à conta dos Serviços de Multimédia). O sistema de telemetria irá criar uma tabela separada para cada novo dia com base nas 00:00 UTC. Como exemplo, "TelemetryMetrics20160321" em que "20160321" é a data de criação da tabela. Para cada dia haverá uma tabela separada.

Tenha em atenção que o sistema de telemetria não gere a retenção de dados. Pode remover os dados telemétricos antigos ao eliminar as tabelas de armazenamento.

Para ativar a telemetria para a conta AMS especificada, tem de fazer o seguinte:

Obtenha as credenciais da conta de armazenamento anexadas à conta dos Serviços de Multimédia.
Crie um Ponto Final de Notificação com EndPointType definido como AzureTable (2) e endPontAddress apontando para a tabela de armazenamento (por exemplo, https://telemetryvalidationstore.table.core.windows.net/). Para obter informações sobre como criar um ponto final de notificação, consulte o tópico NotificationEndPoint .
Crie definições de configuração de monitorização para os serviços que pretende monitorizar. Não são permitidas mais do que uma definição de configuração de monitorização. Para obter detalhes, veja a secção Monitorizar operações de configuração .

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API ( Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades da Entidade MonitoringConfiguration

Propriedade	Tipo	Description
Id Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.	Edm.String	Identificador exclusivo. Formato: "nb:mcid:UUID:<GUID>.
NotificationEndPointId	Edm.String	O ID do ponto final de notificação do ponto final que pretende associar a esta configuração de monitorização.
Criado Só de leitura. Definido pelos Serviços de Multimédia no momento da criação.	Edm.DateTime	Este valor é definido pelos Serviços de Multimédia no momento da criação.
LastModified	Edm.Int32	A última hora modificada do item.
Definições	ComponentMonitoringSettings	As definições de monitorização de componentes.

ComponentMonitoringSettings

Propriedade	Tipo	Description
Componente	Edm.String	O componente de monitorização. Os valores válidos são: - Canal (0) - especifique para monitorizar um canal. - StreamingEndpoint (1) - especifique para monitorizar um ponto final de transmissão em fluxo.
Level	Edm.String	O nível de monitorização. Os valores válidos são: - Desativado (0) - a saída não conterá mensagens de Monitorização. - Normal (1) - o resultado conterá mensagens informativas de Monitorização. - Verboso(2) - a saída conterá mensagens detalhadas de Monitorização.

Monitorizar operações de configuração

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia REST.

Obter configurações de monitorização

Pedir

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

Response

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

Adicionar uma configuração de monitorização