Zum Hauptinhalt springen

5. Subservice Augmentation: \"ietf-service-assurance-device\" YANG Module (5. Subservice-Erweiterung: \"ietf-service-assurance-device\" YANG-Modul)

5. Subservice Augmentation: "ietf-service-assurance-device" YANG Module (5. Subservice-Erweiterung: "ietf-service-assurance-device" YANG-Modul)​

5.1. Tree View (5.1. Baumansicht)​

The following tree diagram [RFC8340] provides an overview of the "ietf-service-assurance-device" module.

Das folgende Baumdiagramm [RFC8340] gibt einen Überblick über das Modul "ietf-service-assurance-device".

module: ietf-service-assurance-device

  augment /sain:subservices/sain:subservice/sain:parameter:
    +--rw parameters
       +--rw device    string

A complete tree view of the base module with all augmenting modules presented in this document is available in Appendix B.3.

Eine vollständige Baumansicht des Basismoduls mit allen in diesem Dokument vorgestellten Erweiterungsmodulen ist in Anhang B.3 verfügbar.

5.2. Concepts (5.2. Konzepte)​

As the number of subservices will grow over time, the YANG module is designed to be extensible. A new subservice type requires the precise specifications of its type and expected parameters. Let us illustrate the example of the new device subservice type. As the name implies, it monitors and reports the device health, along with some symptoms in case of degradation.

Da die Anzahl der Subservices mit der Zeit wachsen wird, ist das YANG-Modul erweiterbar konzipiert. Ein neuer Subservice-Typ erfordert die genauen Spezifikationen seines Typs und der erwarteten Parameter. Lassen Sie uns das Beispiel des neuen Geräte-Subservice-Typs veranschaulichen. Wie der Name schon sagt, überwacht und meldet er den Gerätezustand sowie einige Symptome im Falle einer Verschlechterung.

For our device subservice definition, the new identity "device-type" is specified as an inheritance from the base identity for subservices. This indicates to the assurance agent that we are now assuring the health of a device.

Für unsere Geräte-Subservice-Definition wird die neue Identität "device-type" als Vererbung von der Basisidentität für Subservices spezifiziert. Dies signalisiert dem Assurance-Agenten, dass wir nun die Gesundheit eines Geräts sicherstellen.

The typical parameter for the configuration of the device subservice is the name of the device that we want to assure. By augmenting the parameter choice from the "ietf-service-assurance" YANG module for the case of the "device-type" subservice type, this new parameter is specified.

Der typische Parameter für die Konfiguration des Geräte-Subservices ist der Name des Geräts, das wir sichern wollen. Durch Erweiterung der Parameterauswahl aus dem "ietf-service-assurance" YANG-Modul für den Fall des Subservice-Typs "device-type" wird dieser neue Parameter spezifiziert.

5.3. YANG Module (5.3. YANG-Modul)​

<CODE BEGINS> file "[email protected]"
module ietf-service-assurance-device {
  yang-version 1.1;
  namespace
    "urn:ietf:params:xml:ns:yang:ietf-service-assurance-device";
  prefix sain-device;

  import ietf-service-assurance {
    prefix sain;
    reference
      "RFC 9418: YANG Modules for Service Assurance";
  }

  organization
    "IETF OPSAWG Working Group";
  contact
    "WG Web:   <https://datatracker.ietf.org/wg/opsawg/>
     WG List:  <mailto:[email protected]>
     Author:   Benoit Claise  <mailto:[email protected]>
     Author:   Jean Quilbeuf   <mailto:[email protected]>";
  description
    "This module augments the ietf-service-assurance module with
     support of the device subservice.

     Copyright (c) 2023 IETF Trust and the persons identified as
     authors of the code.  All rights reserved.

     Redistribution and use in source and binary forms, with or
     without modification, is permitted pursuant to, and subject
     to the license terms contained in, the Revised BSD License
     set forth in Section 4.c of the IETF Trust's Legal Provisions
     Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC 9418; see the
     RFC itself for full legal notices.  ";

  revision 2023-07-11 {
    description
      "Initial revision.";
    reference
      "RFC 9418: YANG Modules for Service Assurance";
  }

  identity device-type {
    base sain:subservice-base;
    description
      "Identity of device subservice.";
  }

  augment "/sain:subservices/sain:subservice/sain:parameter" {
    when "derived-from-or-self(sain:type, 'device-type')";
    description
      "Augments the parameter choice from the ietf-service-assurance
       module with a case specific to the device subservice.";
    container parameters {
      description
        "Parameters for the device subservice type.";
      leaf device {
        type string;
        mandatory true;
        description
          "Identifier of the device to monitor. The
           identifier (e.g., device id, hostname, or management IP)
           depends on the context.";
      }
    }
  }
}
<CODE ENDS>
Letztes Update am