Allows the
specification of the optional attributes to be present in the Call Detail
Records (CDRs) that the GPRS/PDN/UMTS access gateway generates. It also defines
that how the information is presented in CDRs by encoding the attribute field
values.
Product
GGSN
SGSN
P-GW
SAEGW
Privilege
Security
Administrator, Administrator
Mode
Exec > Global
Configuration > Context Configuration
configure > context
context_name
Entering the above
command sequence results in the following prompt:
[context_name]host_name(config-ctx)#
Syntax
gtpp attribute { apn-ambr [ include-for-all-bearers | include-for-default-bearer | include-for-non-gbr-bearers ] | apn-ni | apn-selection-mode | charging-characteristic-selection-mode | camel-info | cell-plmn-id | { ciot-cp-optind | ciot-unipdu-cponly } | diagnostics [ abnormal-release-cause ] | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi last-ms-timezone | last-uli | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | node-id-suffix STRING | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos max-length | rat | recordextension | record-extensions rat | record-type { sgsnpdprecord | sgwrecord } | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sms { destination-number | recording-entity | service-centre } | sgw-ipv6-addr | sna-ipv6-addr | sponsor-id | start-time | stop-time | twanuli | uli | user-csg-information } +
default gtpp attribute { apn-ambr [ include-for-all-bearers | include-for-default-bearer | include-for-non-gbr-bearers ] | apn-ni | apn-selection-mode | charging-characteristic-selection-mode | camel-info | cell-plmn-id | { ciot-cp-optind | ciot-unipdu-cponly } | diagnostics [ abnormal-release-cause ] | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi last-ms-timezone | last-uli | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | node-id-suffix STRING | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos max-length | rat | recordextension | record-extensions rat | record-type { sgsnpdprecord | sgwrecord } | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sms { destination-number | recording-entity | service-centre } | sgw-ipv6-addr | sna-ipv6-addr | sponsor-id | start-time | stop-time | twanuli | uli | user-csg-information } +
no gtpp attribute { apn-ambr [ include-for-all-bearers | include-for-default-bearer | include-for-non-gbr-bearers ] | apn-ni | apn-selection-mode | charging-characteristic-selection-mode | camel-info | cell-plmn-id | { ciot-cp-optind | ciot-unipdu-cponly } | diagnostics [ abnormal-release-cause ] | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi last-ms-timezone | last-uli | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | node-id-suffix STRING | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos max-length | rat | recordextension | record-extensions rat | record-type { sgsnpdprecord | sgwrecord } | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sms { destination-number | recording-entity | service-centre } | sgw-ipv6-addr | sna-ipv6-addr | sponsor-id | start-time | stop-time | twanuli | uli | user-csg-information } +
default
Sets the default
GTPP attributes in the generated CDRs. It also sets the default presentation of
attribute values in generated CDRs.
no
Removes the
configured GTPP attributes from the CDRs.
apn-ambr
[ include-for-all-bearers | include-for-default-bearer |
include-for-non-gbr-bearers ]
Default: Disabled
This keyword
controls the inclusion of the optional field "apn-ambr" in the PGW-CDRs in the
custom24 GTPP dictionary.
Important |
This keyword
option will be available only if a valid license is installed. For more
information, contact your Cisco account representative.
|
The APN Aggregate
Maximum Bit Rate (AMBR) is a subscription parameter stored per APN. It limits
the aggregate bit rate that can be expected to be provided across all non-GBR
bearers and across all PDN connections of the same APN. Each of these non-GBR
bearers potentially utilize the entire APN AMBR, e.g. when the other non-GBR
bearers do not carry any traffic. The APN AMBR is present as part of QoS
information.
In 15.0 and later releases,
this CLI command should be configured along with the following additional
options to support APN-AMBR reporting in SGW-CDRs in all GTPP dictionaries.
- include-for-all-bearers : Includes the APN-AMBR
information in SGW-CDRs for all bearers (GBR and NON-GBR)
- include-for-default-bearer : Includes APN-AMBR
information in SGW-CDRs only for default bearer.
- include-for-non-gbr-bearers : Includes APN-AMBR
information for non-gbr-bearers.
This feature is required to
enable post-processing of CDRs to verify MVNO subscribers actual QoS against
invoicing systems.
Important |
This CLI command
and the associated options are not available for products other than S-GW and
P-GW. The option "non-gbr-bearers-only " is available in S-GW and
P-GW but the other options are available in S-GW only.
|
In the P-GW implementation,
if the CLI command "gtpp attribute
apn-ambr " is configured, it will be treated as "gtpp attribute apn-ambr non-gbr-bearers-only ". In
case of S-GW/P-GW combo if any of the options is configured, it will be
considered that the attribute is available.
apn-ni
Default: Enabled
This keyword
controls the inclusion of the optional field "APN" in the x-CDRs.
apn-selection-mode
Default: Enabled
This keyword
controls the inclusion of the optional field "APN Selection Mode" in the
x-CDRs.
camel-info
SGSN only
Enter this keyword
to include CAMEL-specific fields in SGSN CDRs. Default: Disabled
cell-plmn-id
SGSN only
Enter this keyword
to enable the system to include the Cell PLMN ID field in the M-CDR. Default:
Disabled
charging-characteristic-selection-mode
Default: Enabled
This keyword
controls the inclusion of the optional field "Charging Characteristic Selection
Mode" in the x-CDRs.
ciot-cp-optind
Includes optional
field "CP CIoT EPS optimisation indicator" in the CDR.
ciot-unipdu-cponly
Includes optional
field "UNI PDU CP Only Flag" in the CDR.
diagnostics [ abnormal-release-cause ]
Default: Disabled
Enables the system
to include the Diagnostic field in the CDR that is created when PDP contexts
are released. The field will include one of the following values:
-
26 -
For GGSN: if the GGSN sends "delete PDP context request" for any other reason
(e.g., the operator types "clear subscribers" on the GGSN).
For SGSN: The SGSN includes
this cause code in the S-CDR to indicate that a secondary PDP context
activation request or a PDP context modification request has been rejected due
to insufficient resources.
-
36 - For GGSN: this
cause code is sent in the G-CDR to indicate the PDP context has been
deactivated in the GGSN due to the SGSN having sent a "delete PDP context
request" to the GGSN.
For SGSN,
this cause code is used to indicate a regular MS or network-initiated PDP
context deactivation.
-
37 - when the network
initiates a QoS modification, the SGSN sends in the S-CDR to indicate that the
MS initiation deactivate request message has been rejected with QoS not
accepted as the cause.
-
38 - if the GGSN sends
"delete PDP context request" due to GTP-C/GTP-U echo timeout with SGSN. If the
SGSN sends this cause code, it indicates PDP context has been deactivated due
to path failure, specifically GTP-C/GTP-U echo timeout.
-
39 - SGSN only - this
code indicates the network (GGSN) has requested a PDP context reactivation
after a GGSN restart.
-
40 - if the GGSN sends
"delete PDP context request" due to receiving a RADIUS Disconnect-Request
message.
abnormal-release-cause : This keyword controls the
inclusion of abnormal bearer termination information in diagnostics field of
SGW-CDR. Note that the CLI command "gtpp attribute diagnostics " will disable
abnormal-release-cause and enable the
diagnostics
field. The
no gtpp attribute
diagnostics command will disable both
abnormal-release-cause and
diagnostics
field.
Important |
The Abnormal
Bearer Termination feature is currently applicable only to custom34 and
custom35 GTPP dictionaries. That is, the bearer termination cause is populated
in SGW-CDR for custom34 and custom35 dictionaries, and PGW-CDRs for custom35
GTPP dictionary when the cause for record closing is "Abnormal Release".
|
direct-tunnel
Default: Disabled
Includes the
Direct Tunnel field in PGW-CDR/eG-CDRs.
This keyword is
applicable for GGSN, P-GW and S-GW only.
duration-ms
Specifies that the
information contained in the mandatory Duration field be reported in
milliseconds instead of seconds (as the standards require). Default: Disabled
dynamic-flag
Default: Enabled
This keyword
controls the inclusion of the optional field "Dynamic Flag" in the x-CDRs.
dynamic-flag-extension
Default: Enabled
This keyword
controls the inclusion of the optional field "Dynamic Address Flag Extension"
in the x-CDRs.
This field is seen
in the CDR when the IPv4 address is dynamically assigned for a dual PDP
context. This extension field is required in the 3GPP Release 10 compliant CDRs
so that the Dual Stack Bearer support is available.
furnish-charging-information
Default: Disabled
This keyword
controls the inclusion of the optional field "pSFurnishChargingInformation" in
the eG-CDRs and PGW-CDRs.
Important |
The Furnish
Charging Information (FCI) feature is applicable to all GTPP dictionaries
compliant to 3GPP Rel.7 and 3GPP Rel.8 except custom43 dictionary. This keyword
option will be available only if a valid license is installed. For more
information, contact your Cisco account representative.
|
PGW-CDR and eG-CDR
will contain FCI only if it is enabled at command level, i.e. using the
gtpp attribute
furnish-charging-information command in GTPP Server Group
Configuration mode.
Whenever FCI
changes, a new Free-Format-Data (FFD) value is either appended to existing FFD
or overwritten on the existing FDD depending on Append-Free-Format-Data (AFFD)
flag. CDR is not generated upon FCI change.
FCI is supported
in main CDR as well as in LOSDV. Whenever a trigger (volume, time, RAT, etc.)
happens current available FFD at command level is added to the main body of the
CDR. The same FFD at command level is added to the main body of the next CDRs
until it is not appended or overwritten by next Credit-Control-Answer message
at command level.
In the case of
custom43 dictionary, the FCI implementation will be as follows:
- Whenever FCI changes
PGW-CDR will generate CDR i.e close old bucket and will have old FCI details in
the generated CDR.
- Translation for the
PS-Free-Format-Data in CDR will be conversion of hexadecimal values in ASCII
format (for numbers 0 to 9) to decimal values as integers.
- PS-Append-Free-Format-Data always
OVERWRITE.
imei
Default: Disabled
For SGSN: includes the IMEI value in the S-CDR.
For GGSN: includes
the IMEISV value in the G-CDR.
imsi-unauthenticated-flag
Default: Enabled
This keyword
controls the inclusion of the optional field "IMSI Unauthenticated Flag" in the
x-CDRs.
When the served
IMSI is not authenticated, this field "IMSI Unauthenticated Flag" if
configured, will be present in the P-GW CDR record for custom35 dictionary.
This field is added per 3GPP TS 32.298 v10.7.
lapi
Default: Disabled
Includes the Low
Access Priority Indicator (LAPI) field in the CDRs. This field is required to
support MTC feature.
When UE indicates
low priority connection, then the "lowPriorityIndicator" attribute will be
included in the CDR.
last-ms-timezone
Default: Disabled
Sets the "Last
MS-Timezone" in the CDR field. This option would be disabled when the default
option is used.
last-uli
Default: Disabled
Sets the "Last
ULI" in the CDR field. This option would be disabled when the default option is
used.
local-record-sequence-number
Default: Disabled
This keyword
provides both the local record sequence number and the Node ID. In the x-CDRs,
this field indicates the number of CDRs generated by the node and is unique
within the session manager.
The Node ID field
is included in the x-CDR for any of several reasons, such as when PDP contexts
are released or if partial-CDR is generated based on configuration. The field
will consist of a AAA Manager identifier automatically appended to the name of
the SGSN or GGSN service.
The name of the
SGSN or GGSN service may be truncated, because the maximum length of the Node
ID field is 20 bytes. Since each AAA Manager generates CDRs independently, this
allows the Local Record Sequence Number and Node ID fields to uniquely identify
a CDR.
Important |
If the
gtpp single-source
centralized-lrsn is configured, the 'Node-ID' field consists of
only the specified NodeID-suffix. If NodeID-suffix is not configured, GTPP
group name is used. For default GTPP groups, GTPP context-name is used. If the
gtpp single-source
centralized-lrsn is not configured, then node-id format for CDRs
generated by Sessmgr is as follows: <1-byte Sessmgr
restartvalue><3-byte Sessmgr instance number> <node-id-suffix>.
If the
gtpp single-source
centralized-lrsn is not configured, then node-id format for CDRs
generated by ACSmgr is as follows: <1-byte ACSmgr restart-value>
<3-byte ACSmgr instance number> <Active charging service-name>.
|
losdv
Default: Enabled
This keyword
controls the inclusion of the optional field "List of Service Data" in the
x-CDRs.
ms-timezone
Default: Enabled
This keyword
controls the inclusion of the optional field "MS-Timezone" in the x-CDRs.
msisdn
Default: Enabled
This keyword
controls the inclusion of the optional field "MSISDN" in the x-CDRs.
node-id
Default: Enabled
This keyword
controls the inclusion of the optional field "Node ID" in the x-CDRs.
node-id-suffix
STRING
Default: Disabled
Specifies the
configured Node-ID-Suffix to use in the NodeID field of GTPP CDRs as an
alphanumeric string of 1 through 16 characters. Each Session Manager task
generates a unique NodeID string per GTPP context.
Important |
The NodeID field
is a printable string of the
ndddSTRING
format:
n : The first
digit is the Sessmgr restart counter having a value between 0 and 7.
ddd : The
number of sessmgr instances. Uses the specified NodeID-suffix in all CDRs. The
"Node-ID" field consists of sessMgr Recovery counter (1 digit)
n + AAA
Manager identifier (3 digits)
ddd + the
configured Node-Id-suffix (1 to 16 characters)
STRING . If
the centralized LRSN feature is enabled, the "Node-ID" field will consist of
only the specified NodeID-suffix (NodeID-prefix is not included). If this
option is not configured, then GTPP group name will be used instead (For
default GTPP groups, context-name will be used).
|
Important |
If this
node-id-suffix is not configured, the GGSN uses the GTPP
context name as the Node-id-suffix (truncated to 16 characters) and the SGSN
uses the GTPP group named as the node-id-suffix.
|
pdn-connection-id
Default: Enabled
This keyword
controls the inclusion of the optional field "PDN Connection ID" in the x-CDRs.
pdp-address
Default: Enabled
This keyword
controls the inclusion of the optional field "PDP Address" in the x-CDRs.
pdp-type
Default: Enabled
This keyword
controls the inclusion of the optional field "PDP Type" in the x-CDRs.
pgw-ipv6-addr
Default: Disabled
Specifying this option allows to configure the P-GW IPv6
address.
Important |
This attribute
can be controllably configured in custom24 and custom35 SGW-CDR dictionaries.
|
pgw-plmn-id
Default: Enabled
This keyword
controls the inclusion of the optional field "PGW PLMN-ID" in the x-CDRs.
plmn-id [ unknown-use ]
Default: Enabled
For SGSN, reports the SGSN PLMN Identifier value (the RAI) in
the S-CDR provided if the dictionary supports it.
For GGSN, reports
the SGSN PLMN Identifier value (the RAI) in the G-CDR if it was originally
provided by the SGSN in the GTP create PDP context request. It is omitted if
the SGSN does not supply one.
Normally when SGSN
PLMN-id information is not available, the attribute sgsnPLMNIdentifier is not
included in the CDR. This keyword enables the inclusion of the
sgsnPLMNIdentifier with a specific value when the SGSN PLMN-id is not
available.
unknown-use
hex_num : is
aa hexadecimal number from 0x0 through 0xFFFFFF that identifies a foreign SGSN
that has not provided a PLMN-id. For GGSN only.
qos max-length
Default: Disabled
Specifying this option will change the parameters related to QoS
sent in S-CDR and SaMOG CDR. The
max-length
option is used to modify the length of QoS sent in CDR. The
qos_value
must be an integer from 4 through 24.
This feature is
introduced to support Rel.7+ QoS formats.
rat
Default: Enabled
For SGSN: includes the RAT (identifies the radio access
technology type) value in the S-CDR.
For GGSN: includes
the RAT (identifies the radio access technology type) value in the G-CDR.
recordextension
Default: Disabled
This keyword
controls the inclusion of the optional field "RecordExtension" in the x-CDRs.
record-extensions rat
Default: Disabled
Enables network
operators and/or manufacturers to add their own recommended extensions to the
CDRs according to the standard record definitions from 3GPP TS 32.298 Release 7
or higher.
record-type { sgsnpdprecord | sgwrecord }
Important |
This keyword is
available only when the SaMOG Mixed Mode license (supporting both 3G and 4G) is
configured.
|
Default: sgwrecord
Specifies the
SaMOG CDR type to use.
For an SaMOG 3G
license, this keyword will not be available. However, sgsnpdprecord type will
be used as the default record type.
served-mnai
Default: Disabled
This keyword
controls the inclusion of the optional field "Served MNAI" in the x-CDRs.
served-pdp-pdn-address-extension
Default: Disabled
In support of
IPv4v6 dual-stack PDP address types, this keyword causes the service to include
IPv4v6 address information in the CDR. The IPv4 address goes in the Served PDP
PDN Address Extension field and the IPv6 address goes in the Served PDP Address
or Served PDP PDN Address field.
Important |
This attribute
will not be displayed if the GTPP dictionary is set to custom34.
|
Note |
For SGSN, on
enabling
served-pdp-pdn-address-extension all custom S-CDR
dictionaries will support the CDR field "Served PDP/ PDN Address extension"
except for the following dictionaries:
- custom17
- custom18
- custom23
- custom42
- custom41
|
served-pdp-pdn-address-prefix-length
Default: Enabled
In support of IPv6
prefix delegation, this keyword causes the service to include this field
"Served PDP PDN Address" in the x-CDRs.
If this field is
configured, the servedPDPPDNAddress field will support reporting the IPv6
prefix length as outlined in 3GPP 32.298. The prefix length will only be
reported if:
- it is
configured
- it is not the
default length of 64
- it is an IPv6
or IPv4v6 call
sgsn-change
Default: Enabled
This keyword is specific to SGSN and is license restricted.
This keyword controls the inclusion of the S-CDR attribute "SGSN
Change" in the S-CDRs. It is enabled by default and the attribute "SGSN Change"
is included in the S-CDRs by default.
Note |
For SGSN
specific custom33 dictionary, it is recommended to disable this keyword before
an upgrade to prevent billing issues.
|
sgw-ipv6-addr
Default: Disabled
Specifying this option allows to configure the S-GW IPv6
address.
Important |
This attribute
can be controllably configured in custom24 and custom35 SGW-CDR dictionaries.
|
sms { destination-number | recording-entity | service-centre
}
This keyword is
specific to the SGSN.
Entering this
keyword causes the inclusion of an SMS-related field in the SMS-MO-CDR or
SMS-MT-CDR.
destination-number : Includes the
"destinationNumber" field in the SMS-MO-CDR or SMS-MT-CDR.
recording-entity : Includes the "recordingEntity"
field in the SMS-MO-CDR or SMS-MT-CDR.
service-centre : Includes the "serviceCentre" field
in the SMS-MO-CDR or SMS-MT-CDR.
sna-ipv6-addr
Default: Disabled
Specifying this option allows to configure the Serving Node IPv6
Address (SNAv6).
Important |
This attribute
can be controllably configured in custom24 and custom35 SGW-CDR dictionaries.
|
sponsor-id
Default: Disabled
Includes the
Sponsor ID and Application-Service-Provider-Identity fields in PGW-CDR.
Note that the
"Sponsor ID" and "Application-Service-Provider-Identity" attributes will be
included in PGW-CDR if the PCEF supports Sponsored Data Connectivity feature or
the required reporting level is sponsored connectivity level as described in
3GPP TS 29.212.
This feature is
implemented to be in compliance with Release 11 3GPP specification for CDRs.
So, this behavior is applicable to all GTPP dictionaries that are Release 11
compliant, i.e. custom35.
start-time
Default: Enabled
This keyword
controls the inclusion of the optional field "Start-Time" in the x-CDRs.
stop-time
Default: Enabled
This keyword
controls the inclusion of the optional field "Stop-Time" in the x-CDRs.
twanuli
Default: Disabled
This keyword
controls the inclusion of the optional field "TWAN User Location Information"
in the CDRs.
uli
Default: Enabled
This keyword
controls the inclusion of the optional field "User Location Information" in the
x-CDRs.
user-csg-information
Default: Disabled
This keyword
controls the inclusion of the optional field "User CSG Information" in the
x-CDRs.
Important |
Currently, UCI
values are only supported for SGW-CDRs.
This attribute
will not be displayed if the GTPP dictionary is set to custom11, custom34, or
custom35.
|
+
Indicates that
this command can be entered multiple times to configure multiple attributes.
Usage Guidelines
Use this command
to configure the type of optional information fields to include in generated
CDRs (M-CDRs, S-CDRs, S-SMO-CDR, S-SMT-CDR from SGSN and G-CDRs, eG-CDRs from
GGSN) by the AGW (SGSN/GGSN/P-GW/SAEGW). In addition,
it controls how the information for some of the mandatory fields are reported.
Fields described
as optional by the standards but not listed above will always be present in the
CDRs, except for Record Extensions (which will never be present).
Important |
This command can
be repeated multiple times with different keywords to configure multiple GTPP
attributes.
|
Example
The following
command configures the system to present the time provided in the Duration
field of the CDR is reported in milliseconds:
gtpp attribute duration-ms