Actions

Toolpack: Enabling CDR

Revision as of 10:12, 1 May 2019 by Allyntree (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Applies to version(s): v2.9, v2.10, v3.0, v3.1

To enable CDR:

1- Select Gateway from the navigation panel.

EnableCdr 0.png


2- To enable CDR, select Use CDR behavior.

3- Configure the CDR behavior in the CDR Options section:

  • Enable periodic CDR update will add one entry in the CDR per Periodic CDR update time, in minutes.
  • Select one of the Text CDR mode from the CDR Mode :
    • Text CDR only: Will store the CDRs in a flat file. See Text CDR
    • RADIUS CDR only: Will send the CDR to an external RADIUS Server. See Radius CDR
    • Text and RADIUS CDR: Will store the CDRs in a flat file and send the CDR to an external RADIUS Server.
    • RADIUS CDR with Text CDR Fallback: Will send the CDR to an external RADIUS Server and if the RADIUS server cannot handle the load of CDRs, they will be stored in a flat file.
  • Click Save to save your changes.

EnableCdr 1.png

3- Expand the Text CDR parameters section

  • Configure the Text CDR parameters as required. Refer to the description of parameters described below.

EnableCdr 2.png


Path

/configurations/@[configuration_name]/gateways/@[gateway_name]

Parameters (text)

/configurations/@[configuration_name]/gateways/@[gateway_name]
cdr_system_id                 = 5448
routing_script                = "default_routing_script"
translate_privacy_information = false
use_cdr_behavior              = true

/configurations/@[configuration_name]/gateways/@[gateway_name]/advanced_parameters
enable_call_recording            = false
forward_connected_number         = false
forward_redirecting_number       = true
forward_redirection_number       = true
forward_ss7_raw_message_bytes    = true
forward_user_to_user_information = true
route_retry_mode                 = "Call Alerted"
route_retry_relay_progress_msgs  = true
route_retry_timeout              = "10 seconds"

/configurations/@[configuration_name]/gateways/@[gateway_name]/advanced_parameters/call_recording_options
called                                = ""
calling                               = ""
incoming_nap                          = "(Any)"
outgoing_nap                          = "(Any)"
record_all_legs_of_a_call_to_one_file = false
termination_name                      = ""

/configurations/@[configuration_name]/gateways/@[gateway_name]/cdr_options
cdr_mode                   = "Text CDR only"
enable_periodic_cdr_update = false
periodic_cdr_update_time   = "0 minute"
reverse_cdr_call_origin    = false

/configurations/@[configuration_name]/gateways/@[gateway_name]/cdr_options/text_cdr_parameters
cdr_format_end                     = "@{Timestamp:%Y-%m-%d %H:%M:%S.@m%z},END,SessionId='@{SessionId}',LegId='@{LegId}',StartTime='@{StartTime}',ConnectedTime='@{ConnectedTime}',EndTime='@{EndTime}',FreedTime='@{Timestamp}',Duration='@{CallDuration}',TerminationCause='@{TerminationCauseString}',TerminationSource='@{TerminationSource}',Calling='@{CallingNumber}',Called='@{CalledNumber}',NAP='@{NAP}',Direction='@{OriginatorName}',Media='@{RemoteMediaInfo}',Rtp:Rx='@{Stat:Rtp:Rx}',Rtp:Tx='@{Stat:Rtp:Tx}',T38:Rx='@{Stat:T38:Rx}',T38:Tx='@{Stat:T38:Tx}'"
cdr_format_start                   = "@{Timestamp:%Y-%m-%d %H:%M:%S.@m%z},BEG,SessionId='@{SessionId}',LegId='@{LegId}',StartTime='@{StartTime}',ConnectedTime='@{ConnectedTime}',Calling='@{CallingNumber}',Called='@{CalledNumber}',NAP='@{NAP}',Protocol='@{Protocol}',Direction='@{OriginatorName}'"
cdr_format_update                  = "@{Timestamp:%Y-%m-%d %H:%M:%S.@m%z},UPD,SessionId='@{SessionId}',LegId='@{LegId}'"
cdr_log_file_path                  = "@{TB_SETUP_HOME}/cdr_logs/cdr"
max_total_size_of_gzipped_cdr_logs = "10 GB"
maximum_cdr_log_file_segment_size  = "100 MB"
rotation_delay                     = "1 hour"

/configurations/@[configuration_name]/gateways/@[gateway_name]/sip_privacy_options
use_alternate_anonymous_address = false

Parameters (json)

{
  "advanced_parameters" : {
    "call_recording_options" : {
      "called" : "",
      "calling" : "",
      "incoming_nap" : "(Any)",
      "outgoing_nap" : "(Any)",
      "record_all_legs_of_a_call_to_one_file" : false,
      "termination_name" : ""
    },
    "enable_call_recording" : false,
    "forward_connected_number" : false,
    "forward_redirecting_number" : true,
    "forward_redirection_number" : true,
    "forward_ss7_raw_message_bytes" : true,
    "forward_user_to_user_information" : true,
    "route_retry_mode" : "Call Alerted",
    "route_retry_relay_progress_msgs" : true,
    "route_retry_timeout" : "10 seconds"
  },
  "cdr_options" : {
    "cdr_mode" : "Text CDR only",
    "enable_periodic_cdr_update" : false,
    "periodic_cdr_update_time" : "0 minute",
    "reverse_cdr_call_origin" : false,
    "text_cdr_parameters" : {
      "cdr_format_end" : "@{Timestamp:%Y-%m-%d %H:%M:%S.@m%z},END,SessionId='@{SessionId}',LegId='@{LegId}',StartTime='@{StartTime}',ConnectedTime='@{ConnectedTime}',EndTime='@{EndTime}',FreedTime='@{Timestamp}',Duration='@{CallDuration}',TerminationCause='@{TerminationCauseString}',TerminationSource='@{TerminationSource}',Calling='@{CallingNumber}',Called='@{CalledNumber}',NAP='@{NAP}',Direction='@{OriginatorName}',Media='@{RemoteMediaInfo}',Rtp:Rx='@{Stat:Rtp:Rx}',Rtp:Tx='@{Stat:Rtp:Tx}',T38:Rx='@{Stat:T38:Rx}',T38:Tx='@{Stat:T38:Tx}'",
      "cdr_format_start" : "@{Timestamp:%Y-%m-%d %H:%M:%S.@m%z},BEG,SessionId='@{SessionId}',LegId='@{LegId}',StartTime='@{StartTime}',ConnectedTime='@{ConnectedTime}',Calling='@{CallingNumber}',Called='@{CalledNumber}',NAP='@{NAP}',Protocol='@{Protocol}',Direction='@{OriginatorName}'",
      "cdr_format_update" : "@{Timestamp:%Y-%m-%d %H:%M:%S.@m%z},UPD,SessionId='@{SessionId}',LegId='@{LegId}'",
      "cdr_log_file_path" : "@{TB_SETUP_HOME}/cdr_logs/cdr",
      "max_total_size_of_gzipped_cdr_logs" : "10 GB",
      "maximum_cdr_log_file_segment_size" : "100 MB",
      "rotation_delay" : "1 hour"
    }
  },
  "cdr_system_id" : 5448,
  "routing_script" : "default_routing_script",
  "sip_privacy_options" : {
    "use_alternate_anonymous_address" : false
  },
  "translate_privacy_information" : false,
  "use_cdr_behavior" : true
}


List of Parameters