GTPv1 Plugin

This plugin dissects GTPv1 signaling information (GTP-C) and saves it in dump files as well export the information via NetFlow/IPFIX using the following information elements.

%GTPV1_REQ_MSG_TYPE               GTPv1 Request Msg Type
%GTPV1_RSP_MSG_TYPE               GTPv1 Response Msg Type
%GTPV1_C2S_TEID_DATA              GTPv1 Client->Server TunnelId Data
%GTPV1_C2S_TEID_CTRL              GTPv1 Client->Server TunnelId Control
%GTPV1_S2C_TEID_DATA              GTPv1 Server->Client TunnelId Data
%GTPV1_S2C_TEID_CTRL              GTPv1 Server->Client TunnelId Control
%GTPV1_END_USER_IPV4              GTPv1 End User IPv4 Address
%GTPV1_END_USER_IMSI              GTPv1 End User IMSI
%GTPV1_END_USER_MSISDN            GTPv1 End User MSISDN
%GTPV1_END_USER_IMEI              GTPv1 End User IMEI
%GTPV1_APN_NAME                   GTPv1 APN Name
%GTPV1_RAI_MCC                    GTPv1 RAI Mobile Country Code
%GTPV1_RAI_MNC                    GTPv1 RAI Mobile Network Code
%GTPV1_RAI_LAC                    GTPv1 RAI Location Area Code
%GTPV1_RAI_RAC                    GTPv1 RAI Routing Area Code
%GTPV1_ULI_MCC                    GTPv1 ULI Mobile Country Code
%GTPV1_ULI_MNC                    GTPv1 ULI Mobile Network Code
%GTPV1_ULI_CELL_LAC               GTPv1 ULI Cell Location Area Code
%GTPV1_ULI_CELL_CI                GTPv1 ULI Cell CI
%GTPV1_ULI_SAC                    GTPv1 ULI SAC
%GTPV1_RESPONSE_CAUSE             GTPv1 Cause of Operation

The plugin supports the following command line options that are used to specify where the (optional) GTP log file is saved. As previously described for -P, dumps are nested in directories. It is possible to instruct nProbe to execute a command when a directory (not a log file) if fully dumped (i.e. nProbe has moved to the next directory in time order).

--gtpv1-dump-dir <dump dir> Directory where GTP logs will be dumped
--gtpv1-exec-cmd <cmd>    Command executed whenever a directory has been dumped

Please note that GTP-U is not handled by this plugin but rather by the nProbe core when the –tunnel option is used.

Note

As this plugin dissects traffic packets, it is only available when nProbe is used in probe mode.