Monitoramento de Eventos

O serviço de Monitoramento de Eventos permite que um Servidor de Aplicação se inscreva em eventos de rede sobre um dispositivo ou grupo — acessibilidade, perda de conectividade, localização, status de roaming e mais. O Servidor de Aplicação se inscreve via T8; o OmniSCEF arma o evento na rede via T6a e entrega cada relatório de volta ao callback do assinante.

Os eventos de monitoramento são definidos na 3GPP TS 23.682 §5.6, a API T8 na TS 29.122 §5.3, e os procedimentos Diameter na TS 29.128 / TS 29.336.

Visão Geral

Cada inscrição é atribuída a um SCEF-Reference-ID — um identificador único que o OmniSCEF coloca na configuração de saída e que a rede ecoa de volta em cada relatório. O OmniSCEF o utiliza para encaminhar um relatório de entrada para a inscrição correta e seu callback do Servidor de Aplicação.

Fluxo de Inscrição e Relato

Armar é opcional no SCEF. Se um destino de monitoramento estiver configurado, o OmniSCEF envia o CIR para armar o evento. Se não estiver configurado, a inscrição ainda é criada e o OmniSCEF ainda entrega quaisquer relatórios de entrada — ele simplesmente não envia proativamente o CIR (por exemplo, quando o evento é armado via o HSS por outro caminho).

Um relatório cujo SCEF-Reference-ID não corresponde a nenhuma inscrição é reconhecido com um RIA, mas não é encaminhado.

Referência de Recursos T8

MonitoringEventSubscription

Criado por POST /api/3gpp-monitoring-event/v1/{scsAsId}/subscriptions.

Campo	Tipo	Obrigatório	Descrição
`notificationDestination`	String (URI)	Sim	Callback que o AS recebe relatórios de monitoramento.
`monitoringType`	String (enum)	Sim	O evento a ser monitorado — veja Tipos de Monitoramento.
`externalId`	String	Condicional	Identificador Externo do Dispositivo. Um dos `externalId`, `msisdn`, ou `externalGroupId`.
`msisdn`	String	Condicional	MSISDN do Dispositivo.
`externalGroupId`	String	Condicional	Identificador do grupo para monitoramento em grupo.
`maximumNumberOfReports`	Integer	Não	Parar após este número de relatórios.
`monitoringDuration`	String (data-hora)	Não	Parar o monitoramento neste horário.
`reachabilityType`	String (enum)	Não	Para `UE_REACHABILITY`: `SMS` ou `DATA`.
`maximumDetectionTime`	Integer	Não	Para `LOSS_OF_CONNECTIVITY`: tempo de detecção em segundos.
`mtcProviderId`	String	Não	Identificador do provedor de serviço MTC.
`self`	String (URI)	Somente leitura	A própria URI da inscrição.

Exemplo de solicitação de inscrição:

{
  "monitoringType": "UE_REACHABILITY",
  "notificationDestination": "https://as.example.org/monitoring/callback",
  "externalId": "device01@iot.example.org",
  "reachabilityType": "DATA",
  "maximumNumberOfReports": 10
}

MonitoringNotification

O OmniSCEF POSTa um MonitoringNotification para o notificationDestination da inscrição para cada relatório. Ele referencia a inscrição de origem e carrega um ou mais relatórios de eventos decodificados.

Exemplo de notificação:

{
  "subscription": "/3gpp-monitoring-event/v1/as01/subscriptions/XyZ...",
  "monitoringEventReports": [
    {
      "monitoringType": "UE_REACHABILITY",
      "reachabilityType": "DATA"
    }
  ]
}

O Servidor de Aplicação reconhece com 204 No Content.

Tipos de Monitoramento

O OmniSCEF suporta o conjunto completo de tipos de monitoramento da TS 29.122. Cada um mapeia para o valor correspondente de Monitoring-Type na interface Diameter (TS 29.336 §5.3.9).

`monitoringType` (T8)	Valor Diameter	Descrição
`LOSS_OF_CONNECTIVITY`	0	O UE não está mais acessível para dados.
`UE_REACHABILITY`	1	O UE se tornou acessível para SMS ou dados.
`LOCATION_REPORTING`	2	A localização do UE (ou uma mudança nela) é relatada.
`CHANGE_OF_IMSI_IMEI_ASSOCIATION`	3	O IMEI associado ao IMSI mudou.
`ROAMING_STATUS`	4	O status de roaming do UE (ou uma mudança) é relatado.
`COMMUNICATION_FAILURE`	5	Um evento de falha de comunicação ocorreu.
`AVAILABILITY_AFTER_DDN_FAILURE`	6	O UE se tornou disponível após uma falha de notificação de dados de downlink.
`NUMBER_OF_UES_IN_AN_AREA`	7	Contagem de UEs presentes em uma determinada área.
`PDN_CONNECTIVITY_STATUS`	8	Conexão PDN estabelecida/liberada.
`DOWNLINK_DATA_DELIVERY_STATUS`	9	Status da entrega de dados de downlink.
`API_SUPPORT_CAPABILITY`	10	Relato da capacidade de suporte à API.

Uma inscrição com um monitoringType não suportado é rejeitada com 400 INVALID_MONITORING_TYPE.

Valores de Referência

Tipo de Acessibilidade

Valor	Significado
`SMS`	O UE está acessível para SMS.
`DATA`	O UE está acessível para dados.

Comandos Diameter Relacionados

Veja as tabelas de referência do Guia de Operações para os códigos de comando e resultado do CIR/CIA e RIR/RIA.

Índice​

Visão Geral​

Fluxo de Inscrição e Relato​

Referência de Recursos T8​

MonitoringEventSubscription​

MonitoringNotification​

Tipos de Monitoramento​

Valores de Referência​

Tipo de Acessibilidade​

Comandos Diameter Relacionados​