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.
NoteMessages 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.