Monitor Subscriber

To capture messages for subscriber (gr-instance aware), use the following command:

monitor subscriber [ supi ] [ imsi ] [ imei ] (capture-duration) (internal-messages) (transaction-logs) (nf-service) (gr-instance) 
Note

In 2021.02 and later releases, the namespace keyword is deprecated and replaced with the nf-service keyword.

NOTES:

  • supi —Specify the subscriber identifier.

    Example: imsi-123456789, imsi-123*

  • imsi —Specify the IMSI value.

    Example: 123456789, *

  • imei —Specify the IMEI value.

  • Example: 123456789012345, *

  • capture-duration —(Optional) Used to specify the duration in seconds during which monitor subscriber is enabled. Default value is 300 secs.

  • internal-messages —(Optional) When set to yes, it enables internal messaging. By default, it is disabled.

  • transaction-logs —(Optional) When set to yes, it enables transaction logging. By default, it is disabled.

    Note

    Messages and transaction logs are mutually exclusive.

  • namespace —Deprecated option. Use nf-service instead.

  • nf-service —(Optional) Specify the NF service. Possible values are sgw, smf. Default value is none.

  • gr-instance —(Optional) Monitor subscriber for a given gr-instance only.

Example

The following is a configuration example.

monitor subscriber imsi 123456789 gr-instance 1
supi: imsi-123456789
captureDuration: 300
enableInternalMsg: false
enableTxnLog: false
namespace(deprecated. Use nf-service instead.): none
nf-service: none
gr-instance: 1
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   295  100    98  100   197  10888  21888 --:--:-- --:--:-- --:--:-- 29500
Command: --header Content-type:application/json --request POST --data 
{"commandname":"mon_sub","parameters":{"supi":"imsi-123456789","duration":300,
"enableTxnLog":false,"enableInternalMsg":false,"action":"start","namespace":"none",
"nf-service":"none","grInstance":1}} http://oam-pod:8879/commands
Result start mon_sub, fileName ->logs/monsublogs/none.imsi-123456789_TS_2021-04-09T09:59:59.964148895.txt
Starting to tail the monsub messages from file: logs/monsublogs/none.imsi-123456789_TS_2021-04-09T09:59:59.964148895.txt
Defaulting container name to oam-pod.
Use 'kubectl describe pod/oam-pod-0 -n smf' to see all the containers in this pod.

For more information on Monitor Protocol on cnSGW-C, see the Monitor Subscriber and Monitor Protocol Support chapter in the UCC Serving Gateway Control Plane Function - Configuration and Administration Guide.

For more information on Monitor Protocol on SMF, see the Monitor Subscriber and Monitor Protocol section in the UCC 5G Session Management Function - Configuration and Administration Guide.