-- **************************************************************************** -- **************************************************************************** -- Copyright(c) 2004 Mediatrix Telecom, Inc. -- NOTICE: -- This document contains information that is confidential and proprietary -- to Mediatrix Telecom, Inc. -- Mediatrix Telecom, Inc. reserves all rights to this document as well as -- to the Intellectual Property of the document and the technology and -- know-how that it includes and represents. -- This publication cannot be reproduced, neither in whole nor in part in -- any form whatsoever without written prior approval by -- Mediatrix Telecom, Inc. -- Mediatrix Telecom, Inc. reserves the right to revise this publication -- and make changes at any time and without the obligation to notify any -- person and/or entity of such revisions and/or changes. -- **************************************************************************** -- **************************************************************************** MX-CDR-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, Integer32 FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP FROM SNMPv2-CONF MxEnableState, MxActivationState, MxIpHostName, MxIpAddress, MxIpPort, MxAdvancedIpPort, MxIpSubnetMask, MxDigitMap FROM MX-TC MxUInt64, MxFloat32, MxIpHostNamePort, MxIpAddr, MxIpAddrPort, MxIpAddrMask, MxUri, MxUrl FROM MX-TC2 mediatrixServices FROM MX-SMI2; cdrMIB MODULE-IDENTITY LAST-UPDATED "1910210000Z" ORGANIZATION " Mediatrix Telecom, Inc. " CONTACT-INFO " Mediatrix Telecom, Inc. 4229, Garlock Street Sherbrooke (Quebec) Canada Phone: (819) 829-8749 " DESCRIPTION " Call Detail Record The Call Detail Record (CDR) service allows the administrator to generate custom call notifications with information such as endpoints, point of origin, duration, etc. " ::= { mediatrixServices 4200 } cdrMIBObjects OBJECT IDENTIFIER ::= { cdrMIB 1 } -- **************************************************************************** -- Group:Syslog Group -- **************************************************************************** syslogGroup OBJECT IDENTIFIER ::= { cdrMIBObjects 400 } -- Scalar:Syslog CDR Remote Host syslogRemoteHost OBJECT-TYPE SYNTAX MxIpHostNamePort MAX-ACCESS read-write STATUS current DESCRIPTION " Syslog CDR Remote Host Host name and port number of the device that archives CDR log entries. Specifying no port (or port 0) sends notifications to port 514. " DEFVAL { "" } ::= { syslogGroup 100 } -- Scalar:Syslog CDR Format syslogFormat OBJECT-TYPE SYNTAX OCTET STRING ( SIZE(0..1024) ) MAX-ACCESS read-write STATUS current DESCRIPTION " Syslog CDR Format Specifies the format of the syslog Call Detail Record. Formal Syntax Description of the Protocol * Precision=DIGIT * Width=DIGIT * MacroId=(ALPHA / '_') * Macro=%[Width]|[.Precision]|[Width.Precision]MacroId The Width field is the minimum width of the converted argument. If the converted argument has fewer characters than the specified field width, then it is padded with spaces. If the converted argument has more characters than the specified field width, the field width is extended to whatever is required. The Precision field specifies the maximum number of characters to be printed from a string. A config error message is issued when applying a Syslog Format containing an unknown macro. Any invalid macros will remain unchanged in the syslog. Examples : sipid=SipUser001 * CDR Log : %sipid --> CDR Log : SipUser001 * CDR Log : %15sipid --> CDR Log : SipUser001 * CDR Log : %15.5sipid --> CDR Log : SipUs * CDR Log : %.5sipid --> CDR Log : SipUs Call Detail Record predefined macros Control characters * %% : % * \n : Split message Call detail record macros * %id : CDR Id. The CDR ID is unique. The ID is incremented by one each time it is represented in a CDR record. * %sipid : SIP call ID. Blank if no SIP interface was used during the call. * %ocgnum : Original calling number. Calling number as received by the unit. * %cgnum : Calling number. Calling number after manipulation by the call router. * %ocdnum : Original called number. Called number as received by the unit. * %cdnum : Called number. Called number after manipulation by the call router. * %oiname : Origin interface name. Interface on which the call was received. Ex. isdn-Slot2/Pri1. * %diname : Destination interface name. Interface on which the call was relayed. Ex. SIP-Default. * %chan : Channel number. Blank if no PRI/BRI interface was used during the call. If 2 PRI/BRI interfaces were involved, display the originating interface. * %sipla : SIP local IP address. * %sipra : SIP remote IP address or FQDN (next hop). * %siprp : SIP remote port (next hop). * %mra : Media remote IP address. Source IP address of the incoming media stream. If the stream was modified during the call, display the last stream. * %mrsp : Media remote source port. Source port of the incoming media stream. If the stream was modified during the call, display the last stream. * %mrp : Media remote port. Destination port of the outgoing media stream. If the stream was modified during the call, display the last stream. * %tz : Local time zone * %cd : Call duration (in seconds) (connect/disconnect). * %sd : Call duration (in seconds) (setup/connect). * %pdd : Post dial delay (in seconds) (setup/progress). * %css : Call setup second (local time) * %csm : Call setup minute (local time) * %csh : Call setup hour (local time) * %csd : Call setup day (local time) * %csmm : Call setup month (local time) * %csy : Call setup year (local time) * %ccs : Call connect second (local time) * %ccm : Call connect minute (local time) * %cch : Call connect hour (local time) * %ccd : Call connect day (local time) * %ccmm : Call connect month (local time) * %ccy : Call connect year (local time) * %cds : Call disconnect second (local time) * %cdm : Call disconnect minute (local time) * %cdh : Call disconnect hour (local time) * %cdd : Call disconnect day (local time) * %cdmm : Call disconnect month (local time) * %cdy : Call disconnect year (local time) * %miptxc : IP Media last transmitted codec * %miptxp : IP Media last transmitted p-time * %dr : Call disconnect reason, expressed as a Q.850 cause. The Q.850 codes are used to represent the disconnect cause no matter what type of interface initiated the disconnect (SIP, FXS, ISDN, ...). A value of 0 means that no cause code is available. * %rxp : Received media packets. Excluding T.38. * %txp : Transmitted media packets. Excluding T.38. * %rxpl : Received media packets lost. Excluding T.38. * %rxmd : Received packets mean playout delay (ms, 2 decimals). Excluding T.38. * %rxaj : Received packets average jitter (ms, 2 decimals). Excluding T.38. * %sipdr : SIP status code of the received SIP response that caused the disconnect or rejection. A value of 0 means that no status code is available. " DEFVAL { "" } ::= { syslogGroup 200 } -- Scalar:Syslog CDR Facility syslogFacility OBJECT-TYPE SYNTAX INTEGER { local0(100) , local1(200) , local2(300) , local3 (400) , local4(500) , local5(600) , local6(700) , local7(800) } MAX-ACCESS read-write STATUS current DESCRIPTION " Syslog CDR Facility Syslog facility used by the unit to route the Call Detail Record messages. The application can use local0 through local7. " DEFVAL { local0 } ::= { syslogGroup 300 } -- End of group:Syslog Group -- **************************************************************************** -- Group:Notification Messages Configuration -- **************************************************************************** notificationsGroup OBJECT IDENTIFIER ::= { cdrMIBObjects 60010 } -- Scalar:Minimal Severity of Notification minSeverity OBJECT-TYPE SYNTAX INTEGER { disable(0) , debug(100) , info(200) , warning(300) , error(400) , critical (500) } MAX-ACCESS read-write STATUS current DESCRIPTION " Minimal Severity of Notification Sets the minimal severity to issue a notification message incoming from this service. * Disable: No notification is issued. * Debug: All notification messages are issued. * Info: Notification messages with a 'Informational' and higher severity are issued. * Warning: Notification messages with a 'Warning' and higher severity are issued. * Error: Notification messages with an 'Error' and higher severity are issued. * Critical: Notification messages with a 'Critical' severity are issued. " DEFVAL { warning } ::= { notificationsGroup 100 } -- End of group:Notification Messages Configuration -- **************************************************************************** -- Group:Configuration Settings -- **************************************************************************** configurationGroup OBJECT IDENTIFIER ::= { cdrMIBObjects 60020 } -- Scalar:Need Restart needRestartInfo OBJECT-TYPE SYNTAX INTEGER { no(0) , yes(100) } MAX-ACCESS read-only STATUS current DESCRIPTION " Need Restart Indicates if the service needs to be restarted for the configuration to fully take effect. * Yes: Service needs to be restarted. * No: Service does not need to be restarted. Services can be restarted by using the Scm.ServiceCommands.Restart command. " ::= { configurationGroup 100 } -- End of group:Configuration Settings END