[sip-clf] problem-statement and logging arbitrary SIP fields

"Vijay K. Gurbani" <vkg@bell-labs.com> Tue, 12 April 2011 21:08 UTC

Return-Path: <vkg@bell-labs.com>
X-Original-To: sip-clf@ietfc.amsl.com
Delivered-To: sip-clf@ietfc.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfc.amsl.com (Postfix) with ESMTP id 21424E08F6 for <sip-clf@ietfc.amsl.com>; Tue, 12 Apr 2011 14:08:44 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -105.099
X-Spam-Level:
X-Spam-Status: No, score=-105.099 tagged_above=-999 required=5 tests=[AWL=1.500, BAYES_00=-2.599, RCVD_IN_DNSWL_MED=-4, USER_IN_WHITELIST=-100]
Received: from mail.ietf.org ([208.66.40.236]) by localhost (ietfc.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id latOFbZ46UGx for <sip-clf@ietfc.amsl.com>; Tue, 12 Apr 2011 14:08:43 -0700 (PDT)
Received: from ihemail2.lucent.com (ihemail2.lucent.com [135.245.0.35]) by ietfc.amsl.com (Postfix) with ESMTP id 28DB5E0906 for <sip-clf@ietf.org>; Tue, 12 Apr 2011 14:08:43 -0700 (PDT)
Received: from usnavsmail1.ndc.alcatel-lucent.com (usnavsmail1.ndc.alcatel-lucent.com [135.3.39.9]) by ihemail2.lucent.com (8.13.8/IER-o) with ESMTP id p3CL8gvD019233 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <sip-clf@ietf.org>; Tue, 12 Apr 2011 16:08:42 -0500 (CDT)
Received: from umail.lucent.com (umail-ce2.ndc.lucent.com [135.3.40.63]) by usnavsmail1.ndc.alcatel-lucent.com (8.14.3/8.14.3/GMO) with ESMTP id p3CL8fZt014860 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT) for <sip-clf@ietf.org>; Tue, 12 Apr 2011 16:08:42 -0500
Received: from shoonya.ih.lucent.com (shoonya.ih.lucent.com [135.185.238.233]) by umail.lucent.com (8.13.8/TPES) with ESMTP id p3CL8fm2008229 for <sip-clf@ietf.org>; Tue, 12 Apr 2011 16:08:41 -0500 (CDT)
Message-ID: <4DA4BFD3.3070608@bell-labs.com>
Date: Tue, 12 Apr 2011 16:10:43 -0500
From: "Vijay K. Gurbani" <vkg@bell-labs.com>
Organization: Bell Laboratories, Alcatel-Lucent
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.2.15) Gecko/20110307 Fedora/3.1.9-0.39.b3pre.fc14 Thunderbird/3.1.9
MIME-Version: 1.0
To: "sip-clf@ietf.org" <sip-clf@ietf.org>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Scanned-By: MIMEDefang 2.57 on 135.245.2.35
X-Scanned-By: MIMEDefang 2.64 on 135.3.39.9
Subject: [sip-clf] problem-statement and logging arbitrary SIP fields
X-BeenThere: sip-clf@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: SIP Common Log File format discussion list <sip-clf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/sip-clf>, <mailto:sip-clf-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/sip-clf>
List-Post: <mailto:sip-clf@ietf.org>
List-Help: <mailto:sip-clf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/sip-clf>, <mailto:sip-clf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 12 Apr 2011 21:08:44 -0000

Folks: In the Prague IETF, it was decided that we will allow
the capability to log arbitrary SIP header fields and
header elements (like the Reason-Phrase) that are not
already part of the mandatory fields.

I am ratifying this decision on the list; pragmatically,
what this means to the problem-statement draft is that it
will undergo a change as follows:

OLD: (Section 8)

    The data model supports extensibility by providing the capability to
    log "optional fields".  Optional fields are those SIP header fields
    (or field components) that are not mandatory (see Section 8.1 for the
    mandatory field list).  A specific representation format MAY decide
    to explicitly maintain a representation-specific list of fields (or
    field components) to log.  All other fields that do not appear in the
    list of mandatory fields (Section 8.1), nor do they appear in the
    representation-specific list of optional fields, MUST be logged using
    a vendor-specific extension mechanism (through the use of private
    enterprise numbers).  The specific syntax and semantics to be
    accorded to optional fields, whether they are representation-specific
    or use vendor-extension mechanisms MUST be defined by the specific
    representation format used to generate the SIP CLF record.
    Finally, [I-D.ietf-sipclf-format] is an example of a representation
    format draft that provides an ASCII-based encoding scheme.

NEW: (Section 8)

    The data model supports extensibility by providing the capability to
    log "optional fields".  Optional fields are those SIP header fields
    (or field components) that are not mandatory (see Section 8.1 for the
    mandatory field list).  Optional fields may contain SIP headers or
    other elements present in a SIP message (for example, the Reason-
    Phrase element from the Status-Line production rule in RFC 3261
    [RFC3261]).  Optional fields may also contain additional information
    that a particular vendor desires to log.  The specific syntax and
    semantics to be accorded to optional fields MUST be defined by the
    specific representation format used to generate the SIP CLF record.
    Finally, [I-D.ietf-sipclf-format] is an example of a representation
    format draft that provides an ASCII-based encoding scheme.

In the new text, I have decided to stay away from specifying private
enterprise numbers for optional fields in the problem-statement
draft and am leaving it to the specific representation format to
outline this in more detail.  Clearly, to ensure the least ambiguity
and most interoperability, it is in the best interest of a
representation format to choose a mechanism like the private enterprise
number (and draft-ietf-sipclf-format already does so).

Please let me know of any comments for proceeding as outlined
above for the problem-statement draft.  This is the last open issue
in problem-statement, and once we close this, the draft is in
a shape to be moved ahead.

Thank you,

- vijay
-- 
Vijay K. Gurbani, Bell Laboratories, Alcatel-Lucent
1960 Lucent Lane, Rm. 9C-533, Naperville, Illinois 60566 (USA)
Email: vkg@{bell-labs.com,acm.org} / vijay.gurbani@alcatel-lucent.com
Web:   http://ect.bell-labs.com/who/vkg/