2. YANG Modules Overview (2. Panoramica dei Moduli YANG)
2. YANG Modules Overview (2. Panoramica dei Moduli YANG)
The main YANG module, "ietf-service-assurance" (Section 3), defines objects for assuring network services based on their decomposition into so-called subservices. The subservices are hierarchically organized by dependencies. The subservices, along with the dependencies, constitute an assurance graph. This module should be supported by an agent that is able to interact with the devices in order to produce the health statuses and symptoms for each subservice in an assurance graph. This module is intended for the following use cases:
Il modulo principale YANG, "ietf-service-assurance" (Sezione 3), definisce oggetti per assicurare i servizi di rete basati sulla loro scomposizione in cosiddetti sottoservizi. I sottoservizi sono organizzati gerarchicamente da dipendenze. I sottoservizi, insieme alle dipendenze, costituiscono un grafo di assurance. Questo modulo dovrebbe essere supportato da un agente che sia in grado di interagire con i dispositivi al fine di produrre gli stati di salute e i sintomi per ogni sottoservizio in un grafo di assurance. Questo modulo è destinato ai seguenti casi d'uso:
-
Assurance graph configuration:
-
Configurazione del grafo di assurance:
-
Subservices: Configure a set of subservices to assure by specifying their types and parameters.
-
Sottoservizi: Configurare un insieme di sottoservizi da assicurare specificando i loro tipi e parametri.
-
Dependencies: Configure the dependencies between the subservices, along with their types.
-
Dipendenze: Configurare le dipendenze tra i sottoservizi, insieme ai loro tipi.
-
-
Assurance telemetry: Export the assurance graph with health statuses and symptoms for each node.
-
Telemetria di assurance: Esportare il grafo di assurance con stati di salute e sintomi per ogni nodo.
The module is also intended to be exported by the SAIN collector that aggregates the output of several SAIN agents to provide the global assurance graph. In that case, only the telemetry export use case is considered.
Il modulo è anche destinato ad essere esportato dal raccoglitore SAIN che aggrega l'output di diversi agenti SAIN per fornire il grafo di assurance globale. In quel caso, viene considerato solo il caso d'uso dell'esportazione della telemetria.
The modules presented in this document conform to the Network Management Datastore Architecture (NMDA) defined in [RFC8342].
I moduli presentati in questo documento sono conformi alla Network Management Datastore Architecture (NMDA) definita in [RFC8342].
The second YANG module, "ietf-service-assurance-device" (Section 5), augments the "ietf-service-assurance" module by adding support for the device subservice. Additional subservice types might be added following a similar approach.
Il secondo modulo YANG, "ietf-service-assurance-device" (Sezione 5), aumenta il modulo "ietf-service-assurance" aggiungendo il supporto per il sottoservizio dispositivo. Tipi di sottoservizi aggiuntivi potrebbero essere aggiunti seguendo un approccio simile.
The third YANG module, "ietf-service-assurance-interface" (Section 6), augments the "ietf-service-assurance" module as well by adding support for the interface subservice.
Il terzo modulo YANG, "ietf-service-assurance-interface" (Sezione 6), aumenta anche il modulo "ietf-service-assurance" aggiungendo il supporto per il sottoservizio interfaccia.
We provide additional examples in the appendix. The module "example-service-assurance-device-acme" (Appendix A) augments the "ietf-service-assurance-device" module to customize it for devices of the fictional Acme Corporation. Additional vendor-specific parameters might be added following a similar approach. We also provide the modules "example-service-assurance-ip-connectivity" and "example-service-assurance-is-is" (Appendix B) to model the example in Figure 2 from Section 3.1 of [RFC9417].
Forniamo ulteriori esempi nell'appendice. Il modulo "example-service-assurance-device-acme" (Appendice A) aumenta il modulo "ietf-service-assurance-device" per personalizzarlo per i dispositivi della fittizia Acme Corporation. Parametri specifici del venditore aggiuntivi potrebbero essere aggiunti seguendo un approccio simile. Forniamo anche i moduli "example-service-assurance-ip-connectivity" e "example-service-assurance-is-is" (Appendice B) per modellare l'esempio in Figura 2 dalla Sezione 3.1 di [RFC9417].