Programmer's Reference Manual

Plum Voice Platform v. 3.0

© 2008 Plum Group, Inc. All rights reserved.

6. Logging

There are two types of logs: DNIS last call logs and session logs. The DNIS last 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.

6.1 Last Call Logs

Entries in the DNIS last 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;starttime)
• Entry-type can be one of: EVENT, DEBUG, LOCAL, USAGE, or ERROR

6.2 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;starttime)
• 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.