[OPSAWG] AD review of draft-ietf-opsawg-ipfix-fixes

Mahesh Jethanandani <mjethanandani@gmail.com> Sun, 14 April 2024 03:21 UTC

Return-Path: <mjethanandani@gmail.com>
X-Original-To: opsawg@ietfa.amsl.com
Delivered-To: opsawg@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id D18B9C14F61D; Sat, 13 Apr 2024 20:21:21 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.094
X-Spam-Level:
X-Spam-Status: No, score=-2.094 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id H_2aMDyjYgn0; Sat, 13 Apr 2024 20:21:18 -0700 (PDT)
Received: from mail-oa1-x30.google.com (mail-oa1-x30.google.com [IPv6:2001:4860:4864:20::30]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id EA891C14F61A; Sat, 13 Apr 2024 20:21:14 -0700 (PDT)
Received: by mail-oa1-x30.google.com with SMTP id 586e51a60fabf-233e41de0caso674458fac.0; Sat, 13 Apr 2024 20:21:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1713064873; x=1713669673; darn=ietf.org; h=to:cc:date:message-id:subject:mime-version:from:from:to:cc:subject :date:message-id:reply-to; bh=WxvtJamahUtando3enFDs4wjTB/ofoO+Pg+bbbXYu4I=; b=LdBWaQC7mRnLW4ZTAra7PLzF66TXT5DbqgrALzqgJxO4qTDqK1lXE0dFUWernbObQY wQjclGoykdtmsfQzQL4iY+VaKKzYU6McFLwGmS4D5fveCMvIQKl7DgU35s4+qbg7Ie1O 4Bk2W0gahMiYLjLvkSDd6dAhG2b15m1w8u1IQvrMPrLOaFaLy3mbaweOqE30Eh/eKQeZ YGqwjNLhemrpKmUS9slZtoPL+nbg3tbfXvM0fYeRq65QXZF/12Zfz/WTgR9YDnOy8f2Q 0lyuBeAc92KbQ5o8YDabxbh0N8Wd8hw4Yyfqb8xyni/7NCQ79jAUVzK+tmCxw1UPRP+E AiOQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1713064873; x=1713669673; h=to:cc:date:message-id:subject:mime-version:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=WxvtJamahUtando3enFDs4wjTB/ofoO+Pg+bbbXYu4I=; b=qFOnNeTGWZc3PVaTcJmddtz+R3uf2RXKSOdcRmYVR9ke6nuIHpkZ8suRbJLci6y2sj /F3NYEbIuzGewnvjOHfUfkKyDIGP3Ac+KyOY0+y3c8hwayKUEKu1fgopnEp52N3J0plW yuLiQ+kP6iEhVjfQ20mYxzfD+84Nm/2M7WnvoQmV610nCQSWcmwxlRrqnLUnwvK9PlGO l2CSXGMncSmWl9aCOJH5FP4YYlP0IQoDWaGCXjfDKy6mO8pTgXUJP4mSvgYTDLhDNmIF GjWz5l/nGdbRS7I0gtqMY6rVVR8I93icP3GQluXo5t5mKhkFx5Gjw9SazryTv4K/CtFb 6mnA==
X-Gm-Message-State: AOJu0Yyu+heQCfbvEaDaLiqRYmvD0b4sUc1kEGVCOaUq/860GaH8ozDQ Fgiu+KCcjfJmwg5EQJZVkesVgONIntINPV64gDF4QHhOKKzNMr82QCKsBasD
X-Google-Smtp-Source: AGHT+IF3Dh5k8KgKx1pARauZm+2t7D5TOVqbqMrUC8XJWtd+sh4HybxI7jn+K2Y399VLrJn595lrcg==
X-Received: by 2002:a05:6870:c0d0:b0:22e:c787:5fa2 with SMTP id e16-20020a056870c0d000b0022ec7875fa2mr7309642oad.58.1713064872776; Sat, 13 Apr 2024 20:21:12 -0700 (PDT)
Received: from smtpclient.apple (c-69-181-169-15.hsd1.ca.comcast.net. [69.181.169.15]) by smtp.gmail.com with ESMTPSA id s67-20020a637746000000b005d8b89bbf20sm4665645pgc.63.2024.04.13.20.21.11 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 13 Apr 2024 20:21:11 -0700 (PDT)
From: Mahesh Jethanandani <mjethanandani@gmail.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_2FC0A861-1292-4C11-8D2F-A9EC555ADF7C"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.8\))
Message-Id: <3F8B2225-262C-45FE-A486-3A7DEA521E04@gmail.com>
Date: Sat, 13 Apr 2024 20:21:10 -0700
Cc: opsawg@ietf.org
To: draft-ietf-opsawg-ipfix-fixes@ietf.org
X-Mailer: Apple Mail (2.3696.120.41.1.8)
Archived-At: <https://mailarchive.ietf.org/arch/msg/opsawg/ryywDJV0Jxpvs0vchoo5Nai2V6k>
Subject: [OPSAWG] AD review of draft-ietf-opsawg-ipfix-fixes
X-BeenThere: opsawg@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: OPSA Working Group Mail List <opsawg.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/opsawg>, <mailto:opsawg-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/opsawg/>
List-Post: <mailto:opsawg@ietf.org>
List-Help: <mailto:opsawg-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/opsawg>, <mailto:opsawg-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sun, 14 Apr 2024 03:21:21 -0000

Hi Authors,

Thank you for working on this document, This is my review of draft-ietf-opsawg-ipfix-fixes-06 draft. They are roughly divided between COMMENT and NIT. The COMMENTs should be resolved before this document is sent for IETF LC for publication as a Draft Standard.

-------------------------------------------------------------------------------
COMMENT
-------------------------------------------------------------------------------

Section 1, paragraph 2
>    When OPSAWG was considering [I-D.ietf-opsawg-rfc7125-update] which
>    updates [RFC7125], the WG realized that some other parts of the IANA
>    IP Flow Information Export (IPFIX) registry [IANA-IPFIX] were not up-
>    to-date.  Indeed, since its initial creation in 2007, some IPFIX
>    Information Elements (IEs) are no longer adequately specified (while
>    they were at some point in time in the past).  This document intends
>    to update the IANA registry and bring some consistency among the
>    entries of the registry.


For a specification to "no longer adequately" specify an IE, the underlying specification for IPFIX must have changed. If that is so, can you cite what changed? If not, I would just remove the statement. It is not serving any purpose in this specification.

Section 1, paragraph 1
>    As discussed with IANA during the publication process of [RFC9487],
>    the "Additional Information" entry in [IANA-IPFIX] should contain a
>    link to an existing registry, when applicable, as opposed to having:


What happens to the existing registries? Does Section 6 take care of all of them? Should the link in existing registries not specified in Section 6, also move to Additional Information?

Section 3, paragraph 3

Since Sections 4-7 are really for the IANA Consideration section, why not move them there?

Section 4.1.2, paragraph 0
>     - Description:  This Information Element describes the forwarding
>                     status of the flow and any attached reasons.
>                     IPFIX reduced-size encoding is used as required.


I know that you explain what reduced-size encoding in the other IPFIX documents, but it will be worth repeating it here or refer to that definition from here.

Found terminology that should be reviewed for inclusivity; see
https://www.rfc-editor.org/part2/#inclusive_language for background and more
guidance:

 * Term "he"; alternatives might be "they", "them", "their"
 * Term "traditional"; alternatives might be "classic", "classical", "common",
   "conventional", "customary", "fixed", "habitual", "historic",
   "long-established", "popular", "prescribed", "regular", "rooted",
   "time-honored", "universal", "widely used", "widespread"

-------------------------------------------------------------------------------
NIT
-------------------------------------------------------------------------------

All comments below are about very minor potential issues that you may choose to
address in some way - or ignore - as you see fit. Some were flagged by
automated tools (via https://github.com/larseggert/ietf-reviewtool), so there
will likely be some false positives. There is no need to let me know what you
did with these suggestions.

Uncited references: [RFC_Errata_1739] and [RFC_Errata_1738].

Reference [RFC2482] to RFC2482, which was obsoleted by RFC6082 (this may be on
purpose).

Reference [RFC5102] to RFC5102, which was obsoleted by RFC7012 (this may be on
purpose).

Reference [RFC1631] to RFC1631, which was obsoleted by RFC3022 (this may be on
purpose).

Document references draft-ietf-opsawg-RFC7125-update, but that has been
published as RFC9565.

Reference [I-D.ietf-opsawg-rfc7125-update] to RFC7125, which was obsoleted by
RFC9565 (this may be on purpose).

Reference [RFC7125] to RFC7125, which was obsoleted by RFC9565 (this may be on
purpose).

Reference [RFC4646] to RFC4646, which was obsoleted by RFC5646 (this may be on
purpose).

"Abstract", paragraph 3
> ions and Management Area Working Group Working Group mailing list (opsawg@iet
>                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^
This phrase is duplicated. You should probably use "Working Group" only once.

Section 6.2.2, paragraph 1
> NAT event. This IE identifies the type of a NAT event. Examples of NAT events
>                                   ^^^^^^^^^
If "type" is a classification term, "a" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.3.1, paragraph 1
> NAT event. This IE identifies the type of a NAT event. Examples of NAT events
>                                   ^^^^^^^^^
If "type" is a classification term, "a" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.10.1, paragraph 5
> description of the abstract data type of an IPFIX information element. These
>                                  ^^^^^^^^^^
If "type" is a classification term, "an" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.10.2, paragraph 5
> description of the abstract data type of an IPFIX information element.These a
>                                  ^^^^^^^^^^
If "type" is a classification term, "an" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.20.2, paragraph 1
> nformation Element identifies the type of a NAT Quota Exceeded event. Values
>                                   ^^^^^^^^^
If "type" is a classification term, "a" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.20.2, paragraph 2
> nformation Element identifies the type of a NAT Quota Exceeded event. Values
>                                   ^^^^^^^^^
If "type" is a classification term, "a" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.21.1, paragraph 2
>  Information Element identifies a type of a NAT Threshold event. Values for t
>                                   ^^^^^^^^^
If "type" is a classification term, "a" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.21.2, paragraph 2
>  Information Element identifies a type of a NAT Threshold event. Values for t
>                                   ^^^^^^^^^
If "type" is a classification term, "a" is not necessary. Use "type of". (The
phrases "kind of" and "sort of" are informal if they mean "to some extent".).

Section 6.23.1, paragraph 4
>  | | | table below, and section Section 5.1. | | 2 | PmA | Pe
>                         ^^^^^^^^^^^^^^^
Possible typo: you repeated a word.

Section 6.24.2, paragraph 1
> SHOULD have this flag set, and vice-versa.) | +--------+----------+---------
>                                ^^^^^^^^^^
The expression "vice versa" is spelled without hyphens.

Section 7.2.1, paragraph 1
> SHOULD have this flag set, and vice-versa.) | +--------+----------+---------
>                                ^^^^^^^^^^
The expression "vice versa" is spelled without hyphens.


Mahesh Jethanandani
mjethanandani@gmail.com