Logging

Accessing Log Information in Plum DEV

Application Debugging Tools Plum DEV provides a number of log options to assist with application debugging. Two primary types of log files exist that help with this process: DNIS Recent Calls and Session Logs.

The DNIS recent call logs capture only the events from the most recent call to a particular DNIS. The session logs record call statistics and can be used to generate utilization reports.

Recent Calls

Plum DEV keeps detailed call logs for the most recent five days (on a rolling basis). These logs include the event(s) that occurred within individual phone calls. To access these logs, go to the Call Logs menu and select Recent Calls.

Session Logs

Session log data remains in Plum DEV for one (1) year, on a rolling basis. Session log data records statistics about calls handled by the IVR. Session log data does not contain information about what happened within a call, rather it contains information about how the call occurred. Session log data can be used to generate call usage reports.

Select Session Logs from the Call Logs menu. Choose the desired log type (aggregate or daily) and parameters, and then click the ‘View Log’ button. If your account uses multiple phone numbers, use the Phone Number drop-down menu to generate log data for an individual phone number.

Interpreting Call Log Data

To understand call log data it is necessary to understand the data format and what each datum represents.

Recent Call Logs

Entries in the DNIS recent call logs use the following format:

Timestamp [module] (sessionID) entry-type: message

  • Timestamp is formatted: Wed 28 Aug 2002 10:16:58 AM EDT

  • Module can be one of: client, dxi, inet, jsi, log, prompt, rec, tel, vxi, dlg, sip

  • SessionID is a unique ID assigned by the platform to each session: (serverid;channel;timestamp)

  • Entry-type can be one of: EVENT, DEBUG, LOCAL, USAGE, or ERROR

Session Logs

Entries in the session logs are one of three formats:

calltype ANI channum [timestamp] DNIS sessionID callStart callEnd callLength

local ANI channum [timestamp] DNIS sessionID fetchurl: startURL

local ANI channum [timestamp] DNIS sessionID logTagLabel: logTagExpr

  • Calltype can be inbound, outbound, or transfer. Local is used for the <log> tag entries.

  • ANI is the calling phone number.

  • Channum is the hardware channel that the call came in on.

  • Timestamp is formatted like this: “08/Apr/2003:10:37:50 -0400”

  • DNIS is the called phone number.

  • SessionID is a unique ID assigned by the platform to each session: (serverid;channel;timestamp)

  • CallStart is the UNIX timestamp (seconds since 1/1/1970) for the start of the call.

  • CallEnd is the UNIX timestamp (seconds since 1/1/1970) for the end of the call.

  • CallLength is the length of the call in hours:minutes:seconds.

  • StartURL is the URL of the start page for the call.

  • LogTagLabel is the label name for any <log> tag entries.

  • LogTagMessage is the message contents of any <log> tag entries.