Plum DEV Documentation
developer_reference:logging

Table of Contents

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.

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

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.