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
Syntax Description
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 | diagnostics [ abnormal-release-cause ] | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi | 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 | cell-plmn-id | diagnostics | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos | rat | recordextension | record-extensions rat | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sgw-ipv6-addr | sms { destination-number | recording-entity | service-centre } | 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 | cell-plmn-id | diagnostics | direct-tunnel | duration-ms | dynamic-flag | dynamic-flag-extension | furnish-charging-information | imei | imsi-unauthenticated-flag | lapi | local-record-sequence-number | losdv | ms-timezone | msisdn | node-id | pdn-connection-id | pdp-address | pdp-type | pgw-ipv6-addr | pgw-plmn-id | plmn-id | qos | rat | recordextension | record-extensions rat | record-type | served-mnai | served-pdp-pdn-address-extension | served-pdp-pdn-address-prefix-length | sgsn-change | sgw-ipv6-addr | served-mnai | sms { destination-number | recording-entity | service-centre }| 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.
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.
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.
Examples
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