Zum Hauptinhalt springen

9. IANA Considerations (IANA-Überlegungen)

Abschnitt 6 dieser Spezifikation verwendet die "syslog" Nachricht als eine Grundeinheit von Daten. Die in diesem Dokument definierte "syslog"-Nachricht ist eine Formalisierung von ursprünglichen BSD-Syslog-Nachrichten und kann andere Anwendungen haben als die ursprüngliche Absicht. Um es anderen Anwendungen zu ermöglichen, auf dieser Grundlage aufzubauen, wird ein "syslog"-Medientyp verwendet. Dieses Dokument spezifiziert keine Anwendungen dieses Medientyps, sondern bietet nur die Definition dafür.

9.1. VERSION (Version)

Die IANA erstellte und pflegt ein Register von VERSION-Werten für syslog. VERSION-Werte MÜSSEN zwischen 0 und 999 einschließlich liegen. Die Anfangswerte für dieses Register werden im Folgenden besprochen.

VERSION-Werte werden über die Standards Action-Methode zugewiesen, wie in [RFC5226] beschrieben.

Die Anfangswerte für VERSION sind:

  • 0 - reserviert
  • 1 - definiert in RFC 5424

9.2. syslog Structured Data ID Values (syslog-Strukturierte-Daten-ID-Werte)

Die IANA erstellt und pflegt ein Register von syslog Structured Data ID (SD-ID) Werten zusammen mit ihren zugehörigen PARAM-NAMEs. SD-IDs MÜSSEN druckbare USASCII-Zeichenketten sein. Es gibt zwei Formate von SD-IDs: ohne At-Zeichen ("@", ABNF %d64) oder mit einem At-Zeichen, wobei der Teil nach dem At-Zeichen eine private Unternehmensnummer sein muss. Mit At-Zeichen dargestellte SD-IDs können von jedem erstellt werden, wie in Abschnitt 6.3.2 beschrieben, und sie müssen nicht bei der IANA registriert werden. SD-IDs ohne At-Zeichen müssen bei der IANA unter Verwendung einer IETF Review Policy registriert sein, wie in [RFC5226] beschrieben. Die Anfangswerte für dieses Register werden im Folgenden besprochen.

PARAM-NAMEs sind auch druckbare US-ASCII-Zeichenketten. Sie werden innerhalb des Kontexts einer SD-ID registriert. PARAM-NAMEs für registrierte SD-IDs ohne At-Zeichen werden über die Standards Action-Methode zugewiesen, wie in [RFC5226] beschrieben.

Die Anfangswerte für SD-IDs sind wie folgt beschrieben. Bitte beachten Sie, dass auch SD-IDs mit at-Zeichen (@) registriert werden können, und einige werden in diesem Dokument registriert.

SD-ID: timeQuality

  • PARAM-NAME: tzKnown
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: '1' wenn die Zeitzone bekannt ist

  • PARAM-NAME: isSynced
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: '1' wenn die Zeit synchronisiert ist

  • PARAM-NAME: syncAccuracy
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Die Genauigkeit der synchronisierten Zeit in Millisekunden

SD-ID: origin

  • PARAM-NAME: ip
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Die IP-Adresse des Originators

  • PARAM-NAME: enterpriseId
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Die private Unternehmensnummer des Herstellers des Originators

  • PARAM-NAME: software
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Der Softwarename

  • PARAM-NAME: swVersion
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Die Software-Version

SD-ID: meta

  • PARAM-NAME: sequenceId
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Eine eindeutige Sequenz-ID

  • PARAM-NAME: sysUpTime
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Die Betriebszeit des Systems in Hundertstelsekunden

  • PARAM-NAME: language
  • OPTIONAL / MANDATORY: OPTIONAL
  • PARAM-Beschreibung: Der Language Tag der Nachricht

9.3. syslog Approved Transport Mappings (syslog-genehmigte Transport-Mappings)

Die IANA erstellt und pflegt ein Register von genehmigten syslog-Transport-Mappings. Ein syslog-Transport-Mapping MUSS durch ein RFC-Dokument beschrieben werden, das die Standards Track oder Best Current Practice-Spezifikation erfüllt, wie in [RFC5226] beschrieben. Der Name des Transport-Mappings MUSS "syslog" sein und KANN von einer Identifikationszeichenfolge gefolgt werden.

Die Anfangswerte für das Register sind wie folgt:

  • Transport-Mapping-Name: syslog/udp (vorgeschlagen)
  • Referenz: [RFC5426]

  • Transport-Mapping-Name: syslog/tls (erforderlich)
  • Referenz: [RFC5425]