CDRs. CDR Overview. CPS MOG Guide, Release

Size: px

Start display at page:

Download "CDRs. CDR Overview. CPS MOG Guide, Release"

Stanley Jacobs
6 years ago
Views:

CDR Overview, page Auth, page Request, page Callback, page AAR, page 7 AAA, page 0 STR, page 0 STA, page RAR, page RAA, page ASR, page ASA, page Token, page Onboard, page ACRS Request, page 7 ACRS

1 CDR Overview, page Auth, page Request, page Callback, page AAR, page 7 AAA, page 0 STR, page 0 STA, page RAR, page RAA, page ASR, page ASA, page Token, page Onboard, page ACRS Request, page 7 ACRS Response, page 7 writedb, page 8 readdb, page 9 CDR Overview MOG generates Call Data Records () for Update QoS API requests, callback responses, and for Rx commands exchanged with PCRF. The associated with the same Update QoS API request have same session identifier. Each CDR consists of a comma-separated values.

2 Auth Auth The following table describes the Auth CDR that is generated only when UpdateQoS API is called and not for other APIs like onboarding and authentication: API path Subscriber Tenant Source IP Address Token Method Status Error ion Value of Auth case of UpdateQoS API, value of network/define/qostype/.0 Onboarded user invoking the API Domain of the enterprise. IP address of the client invoking the REST call. Authentication Token used for the API call. REST method, either POST or PUT or DELETE or GET Success or Failure Error ion Auth,0--0T:0: ,network/define/qosType/.0,anuchatu,cisco.com,7...9, twsmgwsieyijjmgsv0adlbb8x9zau9a9yq09p/n8dhfvncrvixpkbzssajoesxhthp0dfh8rula ==,POST,Success, Request On successful acceptance of the UpdateQoS API request, the Request CDR is generated. The following table describes the Request CDR fields: Value of "Request"

3 Request Session Id Source IP Address API Method Callback URI Callback token Version Subscriber Address QCI MBR (UL) MBR (DL) Identifier of the Session, which is common for all the related to the request IP address of the source Value of "UpdateQoS" POST or PUT or DELETE Callback URI for the session Callback token for the session API version MSISDN or IMSI or IP QCI Max bit rate up link Max bit rate down link

4 Request Flows List of flow attributes. Each set of flow attributes may contain the following attributes separated by semi-colons: Destination address or application server IP address Destination port or application server port Application server protocol Source IP or UE IP address Source port or UE port Each set of attributes is separated by a comma. For example: [destaddress;destport; srcaddress;srcport; protocol, destaddress; destport;srcaddress; srcport;protocol] Sponsor Id Duration Volume APN ARP-Priority ARP-Pre-emption-Capability ARP-Pre-emption-Vulnerability Sponsor Identifier Duration Volume Access point name Allocation retention priority level Determines whether the bearer can use resources from another bearer with lower priority. Determines whether the bearer can give up resources to a bearer with higher priority

5 Request tent-tention tent-priority DPCC-name DPCC-value You can assign the following values to modify the bandwidth: BOOST: creases the QoS (QCI, ARP, Bandwidth) of the subscriber. Cisco Policy Suite selects the higher value of the applied vs. requested QoS. THROTTLE: Decreases the QoS (QCI, ARP, Bandwidth) of the subscriber. Cisco Policy Suite selects the lower value of the applied vs. requested QoS. REFRESH: Refreshes the CC-Time of the session with configured duration value from create session or validity time configured for the tenant and sponsor ID pair in Policy Builder MOG Configuration plugin. Note: Not case sensitive Priority value (positive integer). When multiple Rx sessions exist, Cisco Policy Suite decides whether to apply tention or not by comparing the priority value. A higher value indicates a lowest priority. Used to derive the Dynamic PCC rule from CRD tables Used to derive the Dynamic PCC rule from CRD tables Request,0-0-T08:7:.-000,7E70DC7777D77977DD ,0..8.,UpdateQoS,post, 0,.0,imsi:00000,8,0000,000,[9.8..;;;;, 9.8..;;;;],,,0000,cisco.com,,true,false,BOOST, dpccname,dpccvalue

6 Callback Callback The Callback CDR is generated whenever a callback is sent to AppServer. The following table describes the Callback CDR fields: Session Id Source IP Address API Method Callback URI Callback token APN Subscriber Address MBR (UL) MBR (DL) Used Volume Used Duration ValidityTime API Status Error ID Error fo CallbackResponse code Value of "Callback" Identifier of the Session, which is common for all the related to the request N/A Value of "UpdateQoS" N/A Callback URI for the session Callback token for the session List of APNs MSISDN or IMSI or IP Maximum uplink bit rate Maximum downlink bit rate Used Volume Used Duration Time remaining for session timeout. Status of the API. Success or Failed Error Number. Error ion. Callback Response code.

7 AAR 0 CallbackResponse DPCC-Name DPCC-Value Detailed-Report Callback response. Used to derive the Dynamic PCC rule from CRD tables Used to derive the Dynamic PCC rule from CRD tables DPCC detailed report enabled or not Callback,0-0-0T::7.-000, 7E70DC7777D77977DD ,lb0,UpdateQoS,RAR, cisco.com,imsi:00000,,,,,0,defined,,,00,success,dpcc-,,enabled AAR The AAR CDR is generated when an Rx AAR command is sent to PCRF. The following table describes the AAR CDR fields: Session Id Diameter Id APN Value of AAR Identifier of the Session, which is common for all the related to the request Diameter Identifier of the Rx Session APN Value 7

8 AAR Application-Service-Provider-Identity MSISDN IMSI Frame IP AMBR (UL) AMBR (DL) Sponsor Id CC Total Octets CC Total Time Max Bandwidth (UL) Max Bandwidth (DL) Flows Media Type QCI ARP-Priority ARP-Pre-emption-Capability Application service provider identifier used for sponsored data connectivity. The is UpdateQoS.<Tenant domain>. For example, if the request is made by a subscriber of domain acme.com, the value is UpdateQoS.acme.com MSISDN of Subscriber IMSI of Subscriber IP of Subscriber APN Aggregate Max bit rate uplink APN Aggregate Max bit rate downlink Sponsor Identifier Volume in bytes Duration Max Requested Bandwidth uplink Max Requested Bandwidth downlink of flows as (destip;destport; srcip;srcport; protocol) Media Type QCI Allocation retention priority level Determines whether the bearer can use resources from another bearer with lower priority. 8

9 AAR ARP-Pre-emption-Vulnerability tent-tention tent-priority Service-fo-Status Determines whether the bearer can give up resources to a bearer with higher priority You can assign the following values to modify the bandwidth: BOOST: creases the QoS (QCI, ARP, Bandwidth) of the subscriber. Cisco Policy Suite selects the higher value of the applied vs. requested QoS. THROTTLE: Decreases the QoS (QCI, ARP, Bandwidth) of the subscriber. Cisco Policy Suite selects the lower value of the applied vs. requested QoS. Note: Not case sensitive Priority value (positive integer). When multiple Rx sessions exist, Cisco Policy Suite decides whether to apply tention or not by comparing the priority value. A higher value indicates lowest priority. Positive integer. ServicefoStatus has values PRELIMINARY_SERVICE _INFORMATION () for default bearer and FINAL_SERVICE_INFORMATION (0) for dedicated bearer. AAR,0-0-T08:7:.-000,7E70DC7777D77977DD ,iqns0-.cluster-.system- ;00;; ;7E70DC7777D77977DD DC ,cisco.com, 78808,cisco.com,UpdateQoS.cisco.com,,00000,,,,,0000,,0000, 000,[9.8..;;;;, 9.8..;;;;],,8,,true,false,BOOST,, 9

10 AAA AAA The AAA CDR is generated when an Rx command AAA is received from PCRF. The following table describes the AAA CDR fields: Session Id Diameter Id APN Result Code Value of AAA Identifier of the Session, which is common for all the related to the request Diameter Identifier of the Rx Session APN Value Result Code AAA,0-0-T08:7:.9-000,7E70DC7777D77977DD ,iqns0-.cluster-.system- ;00;; ;7E70DC7777D77977DD ,cisco.com,0 STR STR CDR is generated when an Rx command STR is sent to PCRF. The following table describes the STR CDR fields: Session Id Value of STR Identifier of the Session, which is common for all the related to the request 0

11 STA Diameter Id APN Termination Cause Diameter Identifier of the Rx Session APN Value Termination Cause STR,0-0-T08:9: ,7E70DC7777D77977DD ,iqns0-.cluster-.system- ;00;; ;7E70DC7777D77977DD ,cisco.com, STA STA CDR is generated when an Rx command STA is received from PCRF. The following table describes the STA CDR fields: Session Id Diameter Id APN Result Code Value of STA Identifier of the Session, which is common for all the related to the request Diameter Identifier of the Rx Session APN Value Result Code STA,0-0-T08:9: ,7E70DC7777D77977DD ,iqns0-.cluster-.system- ;00;; ;7E70DC7777D77977DD ,cisco.com,0

12 RAR RAR RAR CDR is generated when an Rx command RAR is received from PCRF. The following table describes the RAR CDR fields: Session Id Diameter Id APN MBR (UL) MBR (DL) CC Total Octets CC Total Time Result Code QoS-Class-Identifier Status Allocation-Retention-Priority Status APN-Aggregate-Max-Bitrate-DL Status Value of RAR Identifier of the Session, which is common for all the related to the request Diameter Identifier of the Rx Session APN Value Max bit rate uplink Max bit rate downlink Volume in bytes Duration Result Code QoS-Class-Identifier Status received from PCRF, allowed values success(0)/failure()/ignored() Allocation-Retention-Priority Status received from PCRF, allowed values success(0)/failure()/ignored() APN-Aggregate-Max-Bitrate-DL Status received from PCRF, allowed values success(0)/failure()/ignored()

13 RAA APN-Aggregate-Max-Bitrate-UL Status APN-Aggregate-Max-Bitrate-UL Status received from PCRF, allowed values success(0)/failure()/ignored() RAR,0-0-T08:7: ,7E70DC7777D77977DD ,iqns0-.cluster-.system- ;00;; ;7E70DC7777D77977DD ,cisco.com,,,,,0,success,success,success,success RAA RAA CDR is generated when an Rx command RAA is sent to PCRF. The following table describes the RAA CDR fields: Session Id Diameter Id APN Result Code Value of RAA Identifier of the Session, which is common for all the related to the request Diameter Identifier of the Rx Session APN Value Result Code RAA,0-0-T08:7:.8-000,7E70DC7777D77977DD ,iqns0-.cluster-.system- ;00;; ;7E70DC7777D77977DD ,cisco.com,0 ASR ASR CDR is generated when an Rx command ASR is received from PCRF.

14 ASA The following table describes the ASR CDR fields: Session Id Diameter Id APN Abort Cause Value of ASR Identifier of the Session, which is common for all the related to the request Diameter Identifier of the Rx Session APN Value Abort Cause ASR,0-0-T7:: ,DF7D9FD0D C7777DC ,imog-aio-0-.cluster-. lab;78007;;99880;df7d9fd0dc77 77DC ,cisco.com,0 ASA ASA CDR is generated when an Rx command ASA is sent to PCRF. The following table describes the ASA CDR fields: Session Id Diameter Id APN Value of ASA Identifier of the Session, which is common for all the related to the request Diameter Identifier of the Rx Session APN Value

15 Token Abort Cause Abort Cause ASA,0-0-T7:: ,DF7D9FD0D C7777DC ,imog-aio-0-.cluster-.lab ;78007;;99880;DF7D9FD0DC77 77DC ,cisco.com,0 Token This CDR is generated whenever token generation request is received by MOG. Following fields in CDR are separated by comma API path Subscriber Tenant Source IP Address Token Expiry Status Error Value of Token Value of auth/token On boarded user invoking the api Domain of the enterprise. IP address of the client invoking the REST call. Authentication Token used for the API call. Expiry time in seconds Success or Failure Error ion Sample of success Token CDR Token,0--0T::.- 000,auth/token,anuchatu,cisco.com,7...9,9y9/dFJ7PYLxFxeXjqwJtLBB8X9Zau9a9Yq 09p/ N8dHFVNCRVIxPkbzsSajOESXHtHP0DfH8RUlA==,899,Success,

16 Onboard Sample of Token CDR with missing parameter Token,0--0T:: ,auth/token,ciscoadmin,,7...9,,,Failure,Mandatory parameter [domain] missing in request Sample of failure Token CDR Token,0--0T:9: ,auth/token,,,7...9,,,Failure,valid username/password. Authentication Failed. Onboard This CDR is generated whenever onboarding request is received by MOG. Following fields in CDR are separated by comma API path User Tenant Source IP Address Method Tenant User Status Error Value of Onboard Value of onboarding/subscriber or value of onboarding/tenant User credentials used to call the onboarding api Tenant whose user credentials used to call the onboarding api IP address of the client invoking the REST call POST,PUT,DELETE Tenant which is impacted by the onboarding call User which is impacted by the onboarding call Success or Failure Error inion

17 ACRS Request Sample of success Onboard CDR Onboard,0--0T0:: ,onboarding/tenant,ciscoadmin,,7...9,POST,pk_.com,admin_,Success, Sample of failure Onboard CDR Onboard,0--0T0:8: ,onboarding/tenant,ciscoadmin,,7...9,POST,pk_.com,admin_,Failure,Tenant pk_.com already exists. ACRS Request ACRS Request CDR is generated whenever API request is send by MOG to the ACRS server. The following table describes the fields in the ACRS Request CDR: Value of "ACRSRequest" 7 HostName ACRS Server UserName API Path Method Hostname of Policy Director (load balancer VM). Value of "lb0" or "lb0" Server to which the request was made. Name used to authenticate the request with ACRS Server Value of ACRS API REST method, either POST or PUT or DELETE or GET. ACRS Response ACRS Response CDR is generated whenever MOG receives an API response from the ACRS server. The following table describes the fields in the ACRS Response CDR: Value of "ACRSResponse" 7

18 writedb HostName ACRS Server UserName API Path Keydex Status ACRS Error Code Error Message Hostname of the node where the request is initiated. Server to which the request is made. Username used to authenticate the request with the ACRS server. Value of ACRS API. keydex of the key. HTTP response code: Success(00) or Failure(00) or ternalerror(0) Error inion (00- key type not found,00-key index not found, 00 -parameter of request not valid, 00-server error, 00-database connection error, 00-error throttling) of error. writedb The writedb CDR is generated whenever the MOG server interacts with the administrator database to write the key. The following table describes the fields in the writedb CDR: Value of "writedb" Keydex keydex for which the encryption keys need to be written 8

19 readdb Current Key Next Key Key Expiry Time CurrentKey to be written NextKey to be written The Value of expiration timer to be written readdb The readdb CDR is generated whenever the MOG server interacts with the administrator database to read the encryption keys. The following table describes the fields in the readdb CDR: Value of "writedb" Keydex Current Key Next Key Key Expiry Time keydex for which the encryption keys need to be retrieved CurrentKey returned NextKey returned The Value of expiration timer returned 9

20 readdb 0

Southbound Rx Interface

Southbound Rx Interface Overview, page 1 Diameter Adaptor Connectivity, page 1 Protocol Support, page 2 Diameter Connection Establishment, page 2 Diameter Base RFC Compliance, page 2 Rx Protocol Message Formats, page 2 Cisco