MonitoringConfiguration

Artigo
08/05/2023

Este tópico fornece uma visão geral dos tipos REST de telemetria/monitoramento dos Serviços de Mídia do Azure: MonitoringConfiguration e ComponentMonitoringSettings. Esses tipos foram adicionados aos Serviços de Mídia versão 2.13.

A telemetria/monitoramento dos Serviços de Mídia permite que os clientes de Serviços de Mídia acessem dados de métricas para seus serviços. A versão atual dá suporte a dados de telemetria para entidades "Channel" e "StreamingEndpoint". Você pode configurar a telemetria com granularidade no nível de componente. Há dois níveis de detalhe, "Normal" e "Detalhado". A versão atual dá suporte somente a "Normal".

A telemetria é gravada em uma tabela de armazenamento em uma conta de Armazenamento do Azure fornecida pelo cliente (a conta de armazenamento deve ser anexada à conta dos Serviços de Mídia). O sistema de telemetria criará uma tabela separada para cada novo dia com base em 00:00 UTC. Como um exemplo, "TelemetryMetrics20160321", em que "20160321" é a data da tabela criada. Para cada dia, haverá uma tabela separada.

Observe que o sistema de telemetria não gerencia a retenção de dados. Você pode remover os dados de telemetria antigos excluindo as tabelas de armazenamento.

Para habilitar a telemetria para a conta ams especificada, você precisa fazer o seguinte:

Obter as credenciais da conta de armazenamento anexada à conta dos Serviços de Mídia.
Crie um ponto de extremidade 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 de extremidade de notificação, consulte o tópico NotificationEndPoint .
Criar definições de configuração de monitoramento para os serviços que você deseja monitorar. Não é permitida mais de uma definição de configuração de monitoramento. Para obter detalhes, consulte a seção Monitoramento de operações de configuração .

Importante

Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.

Propriedades da entidade MonitoringConfiguration

Propriedade	Type	Descrição
ID Somente leitura. Definido pelos Serviços de Mídia no momento da criação.	Edm.String	Identificador exclusivo. Formato: "nb:mcid:UUID:<GUID>.
NotificationEndPointId	Edm.String	A ID do ponto de extremidade de notificação do ponto de extremidade que você deseja associar a essa configuração de monitoramento.
Criado Somente leitura. Definido pelos Serviços de Mídia no momento da criação.	Edm.DateTime	Esse valor é definido pelos Serviços de Mídia no momento da criação.
LastModified	Edm.Int32	A hora da última modificação do item.
Configurações	ComponentMonitoringSettings	As configurações de monitoramento de componentes.

ComponentMonitoringSettings

Propriedade	Type	Descrição
Componente	Edm.String	O componente de monitoramento. Os valores válidos são: – Canal (0) – especifique para monitorar um canal. – StreamingEndpoint (1) – especifique para monitorar um ponto de extremidade de streaming.
Nível	Edm.String	O nível de monitoramento. Os valores válidos são: - Desabilitado (0) – a saída não conterá nenhuma mensagem de Monitoramento. – Normal (1) – a saída conterá mensagens de Monitoramento informativas. - Detalhado(2) – a saída conterá mensagens detalhadas de Monitoramento.

Operações de configuração de monitoramento

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

Obter configurações de monitoramento

Solicitação

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

Resposta

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 a configuração de monitoramento