メインコンテンツまでスキップ

7. 構造化データID

このセクションでは、実装全体で使用できる標準化されたSD-IDを定義します。これらのSD-IDはIANAに登録されています。

7.1. timeQuality​

timeQuality SD-IDは、HEADERのタイムスタンプの品質に関する情報を提供します。次を説明するパラメータが含まれています:

  • タイムゾーンの知識
  • 時刻同期ステータス
  • 同期精度

SD-ID名: timeQuality

7.1.1. tzKnown​

TIMESTAMPにタイムゾーン情報が含まれているかどうかを示します。

値:

  • 0: タイムゾーン情報は不明です(デフォルト)
  • 1: タイムゾーン情報は既知です

パラメータが存在しない場合、値 0 が想定されます。

7.1.2. isSynced​

発信者の時刻が信頼できる時刻ソース(NTPサーバーなど)と同期されているかどうかを示します。

値:

  • 0: 時刻は同期されていません
  • 1: 時刻は同期されています

パラメータが存在しない場合、値を決定できません。

7.1.3. syncAccuracy​

タイムスタンプの精度をマイクロ秒単位で示します。この値は、isSynced="1" の場合にのみ意味があります。

値: 精度をマイクロ秒単位で表す整数。

例: syncAccuracy="60000" は、時刻が60ミリ秒以内で正確であることを意味します。

7.1.4. 例​

タイムゾーン既知、同期済み、100ms精度:

[timeQuality tzKnown="1" isSynced="1" syncAccuracy="100000"]

タイムゾーン不明、非同期:

[timeQuality tzKnown="0" isSynced="0"]

同期のみ:

[timeQuality isSynced="1"]

7.2. origin​

origin SD-IDは、syslogメッセージの発信者に関する情報を提供します。これは、メッセージがリレーを通過する場合に特に役立ちます。

SD-ID名: origin

7.2.1. ip​

発信者のIPアドレスを含みます。

値: IPv4またはIPv6アドレス

IPv6アドレスは角括弧で囲む必要があります (SHOULD)。

例: ip="192.0.2.1" または ip="[2001:db8::1]"

7.2.2. enterpriseId​

ベンダーまたは組織のIANA割り当てのプライベートエンタープライズ番号(PEN)を含みます。

値: エンタープライズ番号を表す整数

例: enterpriseId="32473"

エンタープライズ番号はIANAから取得できます。http://www.iana.org/assignments/enterprise-numbers を参照してください

7.2.3. software​

メッセージを生成したソフトウェアを識別します。

値: ソフトウェアを識別する自由形式の文字列

例: software="rsyslogd" または software="myapp"

7.2.4. swVersion​

software パラメータで識別されたソフトウェアのバージョンを指定します。

値: バージョン文字列

例: swVersion="1.2.3" または swVersion="8.24.0"

7.2.5. 例​

完全な発信元情報:

[origin ip="192.0.2.1" enterpriseId="32473" software="myapp" swVersion="1.2.3"]

最小限の発信元情報:

[origin ip="192.0.2.1"]

7.3. meta​

meta SD-IDは、メッセージ自体に関するメタデータを提供します。

SD-ID名: meta

7.3.1. sequenceId​

メッセージの一意の識別子で、多くの場合はシーケンス番号です。これは、メッセージの損失を検出するために使用できます。

値: シーケンスを表す整数または文字列

例: sequenceId="1234"

7.3.2. sysUpTime​

発信者が最後に再起動してからの時間(100分の1秒単位)。SNMP sysUpTimeに類似しています。

値: 時間をセンチ秒(1/100秒)単位で表す整数

例: sysUpTime="1234567" (約3.4時間)

7.3.3. language​

メッセージのMSG部分で使用されている自然言語を指定します。

値: RFC 5646で定義されている言語タグ

例:

  • language="en" (英語)
  • language="fr-CA" (カナダ フランス語)
  • language="ja" (日本語)
  • language="de" (ドイツ語)

使用例:

[meta sequenceId="1234" sysUpTime="1234567" language="en"]
に最終更新