Monitoramento de Eventos

O serviço de Evento de Monitoramento 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

O OmniSCEF atribui a cada inscrição um SCEF-Reference-ID. Este identificador único vai na configuração de saída, e a rede o ecoa de volta em cada relatório. O OmniSCEF o utiliza para direcionar 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. Quando você configura um destino de monitoramento, o OmniSCEF envia o CIR para armar o evento. Quando você não configura um, o OmniSCEF ainda cria a inscrição e ainda entrega quaisquer relatórios de entrada. Nesse caso, o OmniSCEF não envia proativamente o CIR (por exemplo, quando outro caminho arma o evento através do HSS).

Quando o SCEF-Reference-ID de um relatório não corresponde a nenhuma inscrição, o OmniSCEF o reconhece com um RIA, mas não o encaminha.

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 de `externalId`, `msisdn` ou `externalGroupId`.
`msisdn`	String	Condicional	MSISDN do Dispositivo.
`externalGroupId`	String	Condicional	Identificador de grupo para monitoramento de grupo.
`maximumNumberOfReports`	Integer	Não	Parar após este número de relatórios.
`monitoringDuration`	String (data-hora)	Não	Parar o monitoramento neste momento.
`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	O URI da própria 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 faz referência à inscrição de origem e carrega um ou mais relatórios de evento 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 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​