Solución de problemas de OmniNWDAF

Resumen | Operaciones | Configuración | Métricas

Esta guía cubre problemas comunes y sus resoluciones.

Problemas Comunes

AnalyticsInfo devuelve 400 MANDATORY_QUERY_PARAM_MISSING

Síntomas: GET /nnwdaf-analyticsinfo/v1/analytics devuelve 400 con MANDATORY_QUERY_PARAM_MISSING.

Causas posibles:

• El parámetro de consulta event-id está ausente. Es obligatorio: los análisis siempre se recuperan para un solo evento.

Resolución:

1. Agregue un parámetro de consulta event-id configurado en uno de los ID de evento admitidos (ver Operaciones: Referencia de ID de Evento de Análisis).

AnalyticsInfo devuelve 404 UNSUPPORTED_EVENT

Síntomas: GET /nnwdaf-analyticsinfo/v1/analytics devuelve 404 con UNSUPPORTED_EVENT.

Causas posibles:

• El valor de event-id no es uno de los 16 ID de evento de análisis estandarizados.

Resolución:

1. Verifique el valor contra la Referencia de ID de Evento de Análisis. Los ID de evento son sensibles a mayúsculas y minúsculas y deben coincidir exactamente con los nombres NwdafEvent de TS 29.520.

La creación de suscripción devuelve 400 MANDATORY_IE_MISSING

Síntomas: POST /nnwdaf-eventssubscription/v1/subscriptions devuelve 400 con MANDATORY_IE_MISSING.

Causas posibles:

• El cuerpo no tiene notificationURI.
• Las eventSubscriptions del cuerpo no contienen ningún evento soportado. Los eventos no soportados se eliminan silenciosamente, por lo que un cuerpo que solo enumera eventos no soportados se trata como vacío y se rechaza.

Resolución:

1. Asegúrese de que haya un notificationURI presente.
2. Asegúrese de que al menos una entrada de eventSubscriptions haga referencia a un ID de evento soportado.

El suscriptor nunca recibe la notificación

Síntomas: Se crea una suscripción (201), pero el notificationURI del suscriptor nunca recibe la llamada de retorno.

Causas posibles:

• El notificationURI es inalcanzable desde OmniNWDAF, o el suscriptor devolvió un estado no 2xx en cada intento.
• Todos los intentos de entrega (hasta notification_max_attempts) se agotaron; OmniNWDAF se rindió y registró una advertencia.

Resolución:

1. Confirme que el notificationURI sea alcanzable desde OmniNWDAF y que el suscriptor devuelva un 2xx al recibir.
2. Verifique los registros de OmniNWDAF para los intentos de entrega y la advertencia final de rendición (ver Métricas).
3. Si es necesario, aumente notification_max_attempts o notification_backoff_ms (ver Configuración). Una notificación perdida en el momento de la creación se reintentará según el cronograma de entrega; si la suscripción lleva un repPeriod, también se volverá a intentar en cada ciclo recurrente. De lo contrario, modifique (PATCH) o recree la suscripción para activar una nueva entrega.

Las suscripciones desaparecieron después de un reinicio

Síntomas: Las suscripciones creadas anteriormente devuelven 404 al leer o eliminar, o ya no existen después de un reinicio.

Causas posibles:

• Las suscripciones se persisten en un archivo DETS duradero y se recargan al iniciar. Si desaparecieron, el archivo de almacenamiento no se preservó: puede haber estado en almacenamiento efímero (la ruta predeterminada está bajo el directorio temporal del sistema) o la subscription_store_path configurada cambió entre ejecuciones.

Resolución:

1. Apunte subscription_store_path a un almacenamiento duradero que persista entre reinicios, y mantenga la ruta estable entre ejecuciones (ver Configuración).
2. Si se perdió el archivo de almacenamiento, recree las suscripciones afectadas.

OmniNWDAF no aparece en el NRF

Síntomas: Los consumidores no pueden encontrar OmniNWDAF, o el NRF no muestra ningún perfil de NWDAF.

Causas posibles:

• nrf_uri apunta al NRF incorrecto o a una dirección inalcanzable.
• El registro falló al inicio (verifique los registros).
• El latido expiró y el NRF expiró el perfil.

Resolución:

1. Verifique que nrf_uri sea correcto y alcanzable (ver Configuración).
2. Verifique los registros de inicio para un registro exitoso.
3. Confirme que el latido esté en funcionamiento; si heartbeat_interval es más largo que el período de validez del NRF, acórtelo.

DELETE devuelve 404

Síntomas: DELETE /nnwdaf-eventssubscription/v1/subscriptions/{id} devuelve 404.

Causas posibles:

• El id de la suscripción es desconocido, ya sea porque nunca existió, ya fue eliminado, o el archivo de almacenamiento duradero no se preservó durante un reinicio.

Resolución:

1. Confirme que el id coincida con uno devuelto en un encabezado Location de creación. Si existió antes de un reinicio, verifique que subscription_store_path apunte a un almacenamiento duradero (ver Las suscripciones desaparecieron después de un reinicio).