NETCONF & YANG API Orchestration
Giya
Gipatik
2023-07-07
GAWAS 4.2
Pasiuna
Katuyoan Niini nga Dokumento
Kini nga dokumentasyon naghulagway kung unsaon pag-integrate ang Paragon Active Assurance sa usa ka network service orchestrator pinaagi sa Control Center NETCONF & YANG API. Hands-on nga exampGihatag ang mga panguna nga buluhaton nga nahilambigit, lakip ang: paghimo ug pag-deploy sa mga Virtual Test Agents, pagpadagan sa mga pagsulay ug pag-monitor, ug pagkuha sa mga resulta gikan niini nga mga kalihokan.
Niini nga dokumento, ang libre nga magamit nga Python NETCONF client ncclient gigamit sa papel sa orkestra.
Mga kombensiyon
Ang mosunod nga mga minubo gigamit niini nga dokumento:
| Minubo | Kahulugan |
| CLI | Interface sa Command Line |
| EM | Element Manager |
| ES | Nasayop Ikaduha |
| MEP | MEG (Maintenance Entity Group) End Point (ITU-T Y.1731 definition) o Maintenance End Point (Cisco definition) |
| NFV | Pag-function sa Network sa Virtualization |
| NFVO | Network Function Virtualization Orchestrator |
| NSD | Deskriptor sa Serbisyo sa Network |
| RPC | Layo nga Pamaagi sa Tawag |
| SIP | Session Initiation Protocol |
| SLA | Kasabutan sa Level sa Serbisyo |
| S-VNFM | Espesyal nga VNF Manager |
| VNF | Virtual Network Function |
| vTA | Virtual nga Ahente sa Pagsulay |
Mga Nota bahin sa Paatras nga Pagkaangay
Sa mga bersyon 2.35.4/2.36.0 sa NETCONF & YANG API, ang validation sa pipila ka mga hangyo gihimo nga mas estrikto sa pagsunod sa NETCONF standard. Kini nagpasabut nga ang code sa kliyente nga gibase sa mga daan nga bersyon niini nga giya mahimo nang isalikway.
Kay example, sa miaging Python exampAng code, walay namespace attribute nga gihatag. Ang namespace karon kinahanglan nga ihatag sa hangyo XML bisan kanus-a nimo gusto nga usbon ang usa ka kapanguhaan sa ConfD.
Mga Kinahanglanon ug Pagpangandam
Pag-instalar sa ConfD
Ang ConfD (usa ka produkto gikan sa Tail-f) gigamit isip tigpataliwala tali sa Paragon Active Assurance system ug NETCONF. Ang ConfD nagkonektar sa Paragon Active Assurance configuration ug operational data ngadto sa NETCONF & YANG API.
Ang ConfD kinahanglan nga na-install kauban ang software sa Control Center, ingon nga gihulagway sa Giya sa Pag-install.
Pag-verify Nga Nagdagan ang ConfD
Aron mapamatud-an nga ang ConfD nagdagan ug nagdagan, padagana ang mando
ssh -s @localhost -p 830 netconf
aron masusi nga ang ConfD motubag sa port 830. Sa sugo, mao ang gihubit sa netconf user create
sugo sa Giya sa Pag-instalar, seksyon sa Pag-instalar sa ConfD. Ihatag ang password nga gihubit sa parehas nga mando.
Sa output, pamatud-i nga ang Control Center module gilakip. Ang output kinahanglan adunay usa ka linya sama sa mosunod:
http://ncc.netrounds.com?module=netrounds-ncc&rebisyon=2017-06-15
Pag-synchronize sa Configuration Database sa Control Center
Sa katapusan, kinahanglan natong i-update ang database sa configuration pinaagi sa NETCONF. Buhaton nato kini dinhi pinaagi sa Python library nga gitawag ug ncclient (NETCONF Client). Bisan pa, ang buluhaton mahimo usab nga matuman sa usa ka lahi nga programming language basta mogamit kini sa NETCONF/YANG protocol.
Ang tahas sa ncclient mao ang paglihok isip kliyente ngadto sa ConfD server nga nag-host sa NETCONF/YANG API.
Angayan nga ipunting nga ang ncclient wala’y kalabutan sa bisan unsang paagi sa Control Center (kaniadto "Netrounds Control Center"), bisan kung ang ngalan nagsugod sa "ncc".
Ania kung giunsa ang pag-install sa ncclient:
- I-download ang software gikan sa https://github.com/ncclient/ncclient.
- Pagdalagan kini nga sugo: pip install ncclient
Mahimo na nato karon ang pag-synchronize sama sa mosunod. Timan-i pag-ayo nga kini kinahanglan nga buhaton sa usa ka bulag nga kompyuter, ug dili sa server sa Control Center mismo:
#
# NOTA:
# Kini nga script naglihok isip kliyente padulong sa ConfD nga nagdagan sa NCC server.
# Gamiton niini ang NETCONF/YANG API para sa komunikasyon.
NOTA: Kini nga pamaagi gikinahanglan usab kung ang Test Agents na-install ug narehistro nga independente sa NETCONF. Tan-awa ang nota sa seksyon nga “Overview of Test Agent Orchestration” sa pahina 17 para sa dugang nga impormasyon.
Pag-set up sa Daghang NETCONF nga kontrolado nga Paragon Active Assurance Accounts
Ang mga lakang sa ubos gikinahanglan lamang kung gusto nimo nga magbutang ug dugang nga Paragon Active Assurance nga mga account nga kontrolado sa NETCONF, dugang sa account nga gi-configure sa ingon niini nga paagi sa Giya sa Pag-install, seksyon nga "Pag-install sa ConfD".
Alang sa matag ingon nga account, ipadayon ingon sa mosunod:
- Sa Control Center, pag-log in sa account ug pag-navigate sa Account> Permissions.
- Idugang ang user "confd@netrounds.com", ug ihatag kini nga ConfD user admin permiso sa GUI pinaagi sa pag-klik sa Imbita nga buton.
- I-synchronize ang database sa configuration sa Control Center sama sa gihulagway sa seksyon nga "Pag-synchronize sa Configuration Database uban sa Control Center" sa pahina 4.
Mahimo nimong makontrol ang daghang mga account sa Paragon Active Assurance nga adunay parehas nga tiggamit sa ConfD.
NOTA: Sa higayon nga magsugod ka sa pagkontrolar sa usa ka Paragon Active Assurance account pinaagi sa ConfD, DILI ka magbuhat ug mga kausaban niini nga account pinaagi sa web GUI bahin sa bisan unsang Paragon Active Assurance nga mga bahin nga "config" (tan-awa ang kapitulo nga "Supported Features sa Paragon Active Assurance" sa pahina 9). Kung buhaton nimo, ang pagkawala sa pag-sync ang moresulta.
Pasiuna sa NETCONF Orchestration API
Tapos naview
Ang ikatulo nga partido nga NFVO o orkestra sa serbisyo kasagaran ang sangkap nga nagpasiugda sa mga sesyon sa pagsulay ug pag-monitor gamit ang Control Center API. Gikuha usab niini nga orkestra ang mga resulta sa pagsukod gikan sa mga kalihokan sa Test Agent. Ang mga KPI sa Pagganap mahimong makuha sa mga Sistema sa Pagdumala sa Pagganap sa ikatulo nga partido, samtang ang mga panghitabo - sa higayon nga ma-trigger sa mga paglapas sa threshold nga gitakda sa Control Center - mahimong ipadala sa mga sistema sa Pagdumala sa Fault nga ikatulo nga partido.
Sa pag-summarize, ang numero sa ubos nagpakita kung giunsa ang Paragon Active Assurance nakig-uban sa ubang mga sistema sa ikatulo nga partido sa talan-awon sa OSS.
- NFVO/Service Orchestrator: Gisugo ang VNF Manager nga i-deploy ang mga vTA ug i-configure ang Paragon Active Assurance ngadto sa service chain. Kung ma-aktibo na ang serbisyo, gigamit sa orkestra ang API padulong sa Control Center aron ma-trigger ang mga pagsulay sa pagpaaktibo sa serbisyo ug makuha ang mga resulta sa pass/fail. Kung mapasa ang mga pagsulay, gamiton sa orkestra ang API padulong sa Control Center aron masugdan ang aktibo nga pagmonitor sa serbisyo. Ang mga KPI gikan sa pagmonitor padayon nga makuha sa orkestra o sa usa ka bulag nga plataporma sa Pagdumala sa Pagganap.
- Control Center: I-deploy, timbangan, ug tapuson ang vTA ingon sa gisugo sa NFVO o service orchestrator.
- Sistema sa Pagdumala sa Pagganap o Sistema sa Pagdumala sa Kalidad sa Serbisyo: Nagbasa sa mga KPI gikan sa aktibong pagmonitor pinaagi sa Control Center API.
- Sistema sa Fault Management: Nakadawat ug NETCONF, SNMP, o mga pahibalo sa email gikan sa Control Center kung ang mga SLA nalapas.
Kahulugan sa mga Konsepto sa Paragon Active Assurance
- Mga Ahente sa Pagsulay: Ang mga sangkap nga naghimo sa mga pagsukod (alang sa mga pagsulay ingon man mga monitor) sa usa ka Paragon Active Assurance nga sistema. Ang mga Ahente sa Pagsulay naglangkob sa software nga adunay katakus sa paghimo, pagdawat, ug pag-analisar sa tinuud nga trapiko sa network.
- Ang matang sa Test Agent nga gihisgutan niini nga dokumento mao ang Virtual Test Agent (vTA), usa ka virtual network function (VNF) nga gipakatap sa usa ka hypervisor. Ang ubang mga matang sa Test Agent anaa usab.
- Adunay duha ka sukaranan nga matang sa pagsukod sa Paragon Active Assurance, mga pagsulay ug mga monitor.
- Pagsulay: Ang usa ka pagsulay naglangkob sa usa o daghang mga lakang, nga ang matag usa adunay piho nga gidugayon. Ang mga lakang gipatuman nga sunud-sunod. Ang matag lakang mahimong maglakip sa pagdagan sa daghang mga buluhaton nga dungan.
- Monitor: Ang usa ka monitor walay espesipikong gidugayon apan nagpatuman sa walay kataposan. Sama sa usa ka lakang sa usa ka pagsulay, ang usa ka monitor mahimong magpatuman sa daghang mga dungan nga buluhaton.
- Template: Kung ang Paragon Active Assurance kontrolado sa usa ka orkestra, ang mga pagsulay ug mga monitor kanunay nga gipatuman pinaagi sa mga templates diin ang pagsulay o monitor gipasabut. Ang mga setting sa parameter mahimong ipasa isip mga input sa template sa runtime.
Workflow alang sa Automation
Panahon sa Disenyo
Sa oras sa pagdesinyo, nag-andam ka og mga sukod pinaagi sa paghimo og mga templates para sa mga pagsulay ug mga monitor sa Paragon Active Assurance. Kon sa unsang paagi himoon kana gikobrehan sa kapitulo “Pagsulay ug Pag-monitor sa mga Template” sa panid 15.
Runtime
Sa runtime, imong gi-set up ang imong mga device ug gihimo ang aktuwal nga mga sukod.
- Usa ka overview sa tanan exampAng gihatag makaplagan sa kapitulo “Examples of Controlling Paragon Active Assurance pinaagi sa NETCONF & YANG API” sa pahina 15.
- Giunsa ang pag-deploy ug pag-configure sa Mga Ahente sa Pagsulay naagian sa kapitulo nga "Examples: Mga Ahente sa Pagsulay” sa panid 16.
- Giunsa ang pag-import sa mga butang sa imbentaryo sama sa TWAMP Ang mga reflector ug mga channel sa IPTV naagian sa kapitulo nga "Examples: Inventory Items” sa pahina 29.
- Giunsa ang pag-configure sa mga alarma gipatin-aw sa kapitulo nga "Examples: Mga Alarm” sa panid 35.
- Giunsa pagpadagan ang mga pagsulay ug pag-monitor pinaagi sa pagpatuman sa mga template sa Paragon Active Assurance pinaagi sa NETCONF gihulagway sa mga kapitulo nga "Examples: Mga Pagsulay” sa panid 43 ug “Examples: Monitors” sa panid 54.
Gisuportahan nga mga Feature sa Paragon Active Assurance
Ang tanang matang sa pagsulay ug monitor sa Paragon Active Assurance mahimong mabuhat ug ipatuman pinaagi sa paggamit sa mga templates. Sa unsa nga paagi sa pagbuhat niini gitabonan sa in-app nga tabang ubos sa "Mga Pagsulay ug mga monitor"> "Paghimo og mga templates".
Ang paghimo sa mga account sa Paragon Active Assurance dili suportado karon; bisan pa, usa o daghang mga gitakda nang daan nga mga account ang na-set up para sa tiggamit.
Ang mga lamesa sa ubos nagdetalye kung unsa nga mga bahin sa Paragon Active Assurance ang magamit sa kini nga pagpagawas, ug kung giunsa kini nga mga bahin girepresentar sa YANG.
Pagpasabot sa YANG Constructs
Alang sa kasayon, ang mga kahulugan gihatag dinhi sa mga pagtukod sa YANG nga gitumong sa feature table.
- Config (config=true): Data sa pag-configure, gikinahanglan aron mabag-o ang usa ka sistema gikan sa usa ka estado ngadto sa lain.
- State (config=false): State data: dugang nga datos sa usa ka sistema nga dili configuration data, sama sa read-only status information ug nakolekta nga estadistika.
- RPC: Usa ka Remote Procedure Call, nga gigamit sulod sa NETCONF protocol.
- Pagpahibalo: Mga pahibalo sa panghitabo nga gipadala gikan sa usa ka NETCONF server ngadto sa usa ka kliyente sa NETCONF.
Mga Talaan sa Paragon Active Assurance Features Anaa alang sa Orkestrasyon
Kapanguhaan: Pag-monitor
YANG dalan:/accounts/account/monitors
| Feature | Subfeature | pagtukod sa YANG |
| Paghimo / pagbag-o / pagtangtang sa monitor | Base sa monitor template | Config |
| Pagsugod / paghunong sa monitor | – | Config |
| Pag-monitor sa mga templates | Ilista ang kasamtangan nga mga template sa monitor nga adunay mga input | Estado |
| Mga pahibalo sa NETCONF | Nausab ang kahimtang sa alarma | Pagpahibalo |
| Pag-monitor sa mga resulta | SLA/ES counter para sa taas nga lebel (%) SLA/ES counter para sa lebel sa buluhaton (%) |
Estado |
Dili sama sa mga pagsulay (itandi ang Resource: Mga pagsulay sa ubos), ang mga monitor wala magsugod sa usa ka RPC kondili pinaagi sa paghimo sa monitor configuration.
Kapanguhaan: Mga Pagsulay
YANG dalan: /accounts/account/tests
| Feature | Subfeature | pagtukod sa YANG |
| Pagsugod sa pagsulay | Base sa pagsulay template | RPC |
| Pagdumala sa mga pagsulay | Ilista ang mga pagsulay nga adunay status | Estado |
| Mga template sa pagsulay | Ilista ang kasamtangan nga mga template sa pagsulay nga adunay mga input | Estado |
| Mga pahibalo sa NETCONF | Nausab ang kahimtang sa pagsulay | Pagpahibalo |
| Mga resulta sa pagsulay | Pagkuha sa kahimtang sa lakang sa pagsulay (pass, mapakyas, sayup,…) | Estado |
Kapanguhaan: Mga Ahente sa Pagsulay
YANG mga dalan:
- /accounts/account/test-agents (Config)
- /accounts/account/registered-test-agents (State)
Ang mga Ahente sa Pagsulay ubos sa /accounts/account/test-agents mao ang mga na-configure sa usa ka account. Kini ra nga mga Ahente sa Pagsulay ang mahimong ma-configure ug magamit sa mga pagsulay ug monitor pinaagi sa NETCONF sa orkestra.
Human nimo ma-configure ang usa ka Test Agent ug kini narehistro sa account, ang Test Agent makita ubos sa /accounts/account/registered-test-agents. Imong makita ang tanang rehistradong Test Agents gamit ang “get” command sa NETCONF (itandi ang kapitulo Examples: Mga Ahente sa Pagsulay).
Ubos sa /accounts/account/registered-test-agents mahimo usab nimo pangitaon ang Test Agents nga wala pa ma-configure. Ang bisan unsang mga Ahente sa Pagsulay kinahanglan nga ma-configure sa dili pa kini magamit.
Sa usa ka senaryo sa orkestrasyon, kasagaran girekomenda nga imong buhaton ang tanan nga pag-configure sa imong Paragon Active Assurance account pinaagi sa NETCONF. Gisiguro niini nga ang mga ahente sa pagsulay ug mga rehistrado nga ahente sa pagsulay dili magkalainlain.
| Feature | Subfeature | pagtukod sa YANG |
| Pre-paghimo Test Agent sa server | – | Config |
| I-configure ang offline nga Test Agent | (Giduso sa Control Center ang config sa Test Agent pag online) |
Config |
| Gamita ang anaa/externally configured Test Agents | Gamit sa pagsulay/monitor | Config |
| I-configure ang mga interface | Config | |
| Pagkuha og status | Estado | |
| I-configure ang Test Agent (Test Appliance lang) | I-configure ang NTP | Config |
| I-configure ang mga taytayan | Config | |
| I-configure ang mga interface sa VLAN | Config | |
| Ipasabut ang mga yawe sa SSH | Config | |
| IPv6 | Config | |
| Mga gamit | Pag-reboot | RPC |
| Update | RPC | |
| Mga pahibalo sa NETCONF | Nausab ang status sa online | Pagpahibalo |
| Status | Pagkuha sa kahimtang sa sistema (uptime, paggamit sa memorya, load average, bersyon) |
Estado |
Kapanguhaan: Imbentaryo
YANG dalan: /accounts/account/twamp- mga reflector
Gisuportahan ang NETCONF Capabilities
Ang talaan sa ubos nagpunting sa IETF RFCs nga naghulagway sa mga kapabilidad sa NETCONF nga gigamit alang sa katuyoan sa Paragon Active Assurance orchestration.
- ietf-netconf.yang
- IETF RFC 6241, Network Configuration Protocol (NETCONF), https://tools.ietf.org/html/rfc6241
- Ang gisuportahan ra nga pamaagi sa pagdumala sa sayup mao ang rollback-on-error.
- Ang gisuportahan ra nga tindahan sa datos mao ang pagdagan sa pagsulat.
- ietf-netconf-notifications.yang
- IETF RFC 5277, Mga Notipikasyon sa Hitabo sa NETCONF, https://tools.ietf.org/html/rfc5277
Test ug Monitor Templates
Ang mga templates alang sa mga tipo sa pagsulay ug monitor kinahanglan nga i-set up nga mano-mano pinaagi sa Paragon Active Assurance front-end user interface. Sa unsa nga paagi sa pagbuhat niini gitabonan sa in-app nga tabang ubos sa "Mga Pagsulay ug mga monitor"> "Paghimo og mga templates".
Examples sa Pagkontrol sa Paragon Active Assurance pinaagi sa NETCONF & YANG API
Sa sunod nga mga kapitulo, gituohan nga ang angay nga mga template sa pagsulay ug monitor gihubit sumala sa mga panudlo nga gihatag sa kapitulo nga "Mga Template sa Pagsulay ug Pag-monitor" sa panid 15.
Mga Himan nga Gigamit sa Examples
Tanang exampAng mga les sa sunod nga mga kapitulo natukod gamit ang mosunod nga libre nga magamit nga mga himan:
- Pang: Gigamit sa paghanduraw ug pag-browse sa mga modelo sa YANG.
- Anaa sa https://github.com/mbj4668/pyang (clone gikan sa git ug pagdagan sa python setup.py install).
- Python NETCONF client "ncclient": Gigamit sa pagpakigsulti sa Control Center gamit ang NETCONF.
- Anaa sa https://github.com/ncclient/ncclient (pagpadagan sa pip install ncclient).
Ang netrounds-ncc.yang data model makita sa /opt/netrounds-confd sa higayon nga ma-install ang ConfD sumala sa Giya sa Pag-install).
Tapos naview sa Pangunang mga Buluhaton nga Gibuhat
(Ang ubang dugang nga mga buluhaton gipakita usab sa mosunod.)
- “Paghimo ug pagdeploy ug bag-ong Test Agent” sa panid 16
- “Paghimo og mga butang sa imbentaryo (eg reflector)” sa pahina 29
- “Pag-set up sa mga template sa alarma ug asa ipadala ang mga alarma” sa pahina 35
- “Paghimo ug pagpadagan sa usa ka pagsulay” sa pahina 45
- “Pagkuha sa mga resulta sa pagsulay” sa panid 50
- “Pagsugod ug monitor (naglakip sa setup sa mga alarma)” sa pahina 60
- “Pagkuha sa status sa SLA para sa monitor” sa pahina 67
- “Pagtrabaho uban sa tags”Sa panid 71
Examples: Mga Ahente sa Pagsulay
Tapos naview sa Test Agent Orchestration
Ang Mga Ahente sa Pagsulay sa Paragon Active Assurance giisip nga "konfigurasyon" sa konteksto sa orkestra. Nagpasabot kini nga ang paghimo, pagkontrol, ug pagtangtang sa mga Ahente sa Pagsulay kinahanglan buhaton pinaagi sa orkestra ug NETCONF kaysa pinaagi sa Paragon Active Assurance GUI.
IMPORTANTE: Kung ang usa ka Test Agent gi-install sa usa ka technician ug narehistro sa Control Center nga wala una gibuhat pinaagi sa NETCONF & YANG API, ang Test Agent dili maglungtad sa configuration database, ug ang sistema mawala sa sync. Aron mahibal-an sa ConfD ang Test Agent sa kini nga kaso, kinahanglan nga maghimo usa ka bag-ong pag-synchronize sa Control Center, ingon nga detalyado sa seksyon nga "Pag-synchronize sa Database sa Configuration sa Control Center" sa panid 4.
Ang Orchestration of Virtual Test Agents (vTAs) kinahanglan nga buhaton sa mosunod nga mga lakang:
- Paghimo sa Virtual Test Agent, lakip ang iyang interface configuration, gamit ang NETCONF & YANG interface sa Control Center. Ang ngalan sa Test Agent mao ang talagsaon nga yawe niini.
- I-deploy ang vTA sa usa ka virtualization platform. Sunda ang mga instruksyon sa online nga tabang ubos sa Test Agents > Installation. Ang sukaranan nga pagsumpo sa interface nga nagtugot sa vTA nga makonektar sa Control Center, ingon man mga kredensyal alang sa pag-authenticate, gihatag sa vTA gamit ang data sa user sa cloud-init.
Kung na-boot na ang vTA, awtomatiko kini nga magkonektar sa Control Center gamit ang usa ka naka-encrypt nga koneksyon sa OpenVPN. Gipadala ang usa ka pahibalo sa NETCONF tungod kay ang bili sa parameter sa pagsulay-agent-statuschange sa vTA nausab na karon sa "online".
NOTA: Tungod kay ang ngalan sa vTA mao ang identifier niini sa Control Center, kini nga ngalan kinahanglan nga parehas sa gipasabut sa Control Center sa "lakang 1" sa panid 17. - Sa higayon nga ang vTA konektado ug mapamatud-an sa Control Center, ang interface configuration iduso ngadto sa vTA. Kini ang interface configuration nga gihatag sa "lakang 1" sa pahina 17 sa dihang ang vTA gihimo sa Control Center.
- Human ang vTA makaalagad sa iyang katuyoan, kuhaa ang vTA.
Paghimo ug Pagbutang ug Bag-ong Ahente sa Pagsulay
Kinahanglan una namong maghimo ug Test Agent gamit ang NETCONF & YANG interface sa Control Center. Kung ang usa ka Ahente sa Pagsulay gihimo sa kini nga paagi, wala’y kinahanglan nga pag-synchronize sa Control Center.
Ang modelo nga YANG alang sa usa ka Test Agent sama sa gihulagway sa ubos. Nakuha kini isip output gikan sa command
pyang -f tree netrounds-ncc.yang
Ang bug-os nga modelo sa YANG gihatag sa "Apendise: Kahoy nga Istruktura sa Bug-os nga Modelo sa YANG" sa panid 81, nga adunay usab usa ka leyenda nga nagpatin-aw sa mga kombensiyon nga gigamit niini ug uban pang mga ilustrasyon sa modelo sa YANG sa karon nga dokumento.
Nagpadayon kami sa mosunod nga mga lakang, nga detalyado sa mga musunud:
- Sa sinugdanan, ang Paragon Active Assurance account nga "demo" walay Test Agents sa imbentaryo niini.
- Usa ka Test Agent nga gitawag og "vta1" gihimo gamit ang ncclient. Niini nga stage, wala pay tinuod nga Test Agent (nga mao, wala pa kini nasugdan).
- Ang Test Agent kay gipakatap sa OpenStack. (Ang pagbutang sa kana nga plataporma gipili dinhi ingon usa ka posibilidad sa uban.)
- Ang Test Agent nagkonektar sa Control Center account nga "demo" ug andam na alang sa paggamit.
Lakang 1: Sa sinugdanan, walay Test Agents sa account nga "demo". Tan-awa ang screenshot sa ubos gikan sa Control Center GUI.
Lakang 2: Usa ka Test Agent ang gihimo sa Control Center gamit ang Python NETCONF nga kliyente nga "ncclient". Sa ubos mao ang ncclient code alang sa paghimo og Test Agent nga adunay usa ka pisikal nga interface nga adunay DHCP address:
import argparse
gikan sa ncclient import manager
parser = argparse.ArgumentParser(deskripsyon='Pagsulay sa paghimo sa Test Agent')
parser.add_argument('–host', help='Ang hostname diin makita ang ConfD', gikinahanglan=Tinuod)
parser.add_argument('–port', help='The port to connect to ConfD', required=True)
parser.add_argument('–username', help='Ang username aron makonektar sa ConfD', gikinahanglan=Tinuod)
parser.add_argument('–password', help='Password sa ConfD account', gikinahanglan=Tinuod)
parser.add_argument('–netrounds-account', help='Ang mubo nga ngalan sa NCC account', gikinahanglan=Tinuod)
parser.add_argument('–test-agent-name', help='Ngalan sa Test Agent', gikinahanglan=Tinuod)
args = parser.parse_args()
uban ang manager.connect(host=args.host, port=args.port, username=args.username,
password=args.password, hostkey_verify=False) ingon m:
# Paghimo Test Agent sa Control Center
xml = """
)print m.edit_config(target='nagdagan', config=xml)
NOTA: Ang kodigo nga nag-una sa manager.connect(…) wala iapil sa sunod nga exampang mga snippet sa code.
Ang NTP server gi-configure sa eth0, ug ang eth0 mao usab ang management interface (nga mao, ang interface nga nagkonektar sa Control Center).
Ang Aplikasyon sa Test Agent dili karon motugot sa pag-configure sa mga interface. Tungod niini nga rason, gikan sa bersyon 2.34.0 sa unahan, posible nga tangtangon ang interface configuration sa YANG schema. Busa ang katugbang nga XML gipasayon sa niini nga kaso:
Kung nahimo na ang Test Agent, anaa kini sa database sa configuration ug sa Control Center. Tan-awa ang screenshot sa ubos sa imbentaryo sa Test Agent, nga nagpakita sa Test Agent "vta1":
Lakang 3: Panahon na nga i-deploy ang Test Agent "vta1" sa OpenStack.
Ang Test Agent mogamit sa cloud-init user data aron makuha ang impormasyon kon unsaon pagkonektar sa Control Center. Sa partikular, ang teksto sa datos sa tiggamit file adunay mosunod nga mga sulod (Timan-i nga ang mga linya sa #cloud-config ug netrounds_test_agent kinahanglan nga anaa, ug nga ang nahabilin nga mga linya kinahanglan nga mag-indent):
Alang sa dugang nga kasayuran, palihug tan-awa ang dokumento Giunsa ang Pag-deploy sa mga Virtual Test Agents sa OpenStack.
Kung na-deploy na ang Test Agent ug konektado na sa Control Center, ang configuration iduso gikan sa Control Center ngadto sa Test Agent.
Lakang 4: Ang Test Agent kay online na sa Control Center ug nakuha na ang configuration niini. Ang Test Agent andam na nga gamiton sa mga pagsulay ug pagmonitor. Tan-awa kini nga mga seksyon:
- “Pagsugod ug Pagsulay” sa panid 45
- “Pagsugod ug Monitor” sa panid 60
Paglista sa mga Ahente sa Pagsulay sa Imong Paragon Active Assurance Account
Sa ubos kay exampAng ncclient nga Python code para sa paglista sa Test Agents sa Paragon Active Assurance account:
Ang pagpadagan niini nga code naghatag og output sama niana sa ubos:
Pagtangtang sa usa ka Ahente sa Pagsulay
Human makompleto ang usa ka pagsulay, mahimong may kalabotan sa pipila ka mga kaso sa paggamit ang pagtangtang sa Ahente sa Pagsulay.
Sa ubos usa ka snippet sa code nga nagpakita kung giunsa kini buhaton sa ncclient:
Mga Notipikasyon sa NETCONF
Sa ubos, among gipresentar ang usa ka yano nga example script para sa pagpaminaw sa tanang umaabot nga NETCONF notifications gikan sa Control Center. Kini nga mga pahibalo ipadala sa matag higayon nga mahitabo ang pipila ka mga panghitabo, sama sa usa ka Test Agent nga mag-offline o usa ka pagsulay nga gisugdan sa user nga nahuman. Pinasukad sa kasayuran nga gidala sa mga pahibalo, ang mga tiggamit mahimo’g mag-assign sa awtomatiko nga pag-follow-up nga mga aksyon sa orkestra.
Kung ang script sa ibabaw gipatuman, ang kliyente sa NC magpakita sa nadawat nga pahibalo sa structured XML. Pangitaa ang exampang output sa ubos, nga nagpakita sa usa ka Test Agent nga nag-offline nga wala damha.
2017-02-03T15:09:55.939156+00:00</eventTime>
<test-agent-status-change xmlns=’http://ncc.netrounds.com'>
demo
HW1
offline
Examples: Mga Butang sa Imbentaryo
Paghimo (pag-import) ug pagdumala sa mga butang sa imbentaryo sama sa TWAMP reflectors ug Y.1731 MEPs gibuhat sa usa ka susama nga paagi sama sa Test Agents. Sa ubos mao ang XML ug NETCONF code para sa pagpasabot sa maong mga entidad sa Paragon Active Assurance pinaagi sa NETCONF & YANG API ug para sa pagkuha sa mga listahan sa mga butang nga gipasabot.
Paghimo og TWAMP Reflector
Paghimo ug Y.1731 MEP
Paghimo usa ka IPTV Channel
Paghimo og Ping Host
Paghimo og SIP Account
Pagbawi sa mga Butang sa Imbentaryo
Sa ubos mao ang Python code alang sa pagkuha sa tanan nga mga butang sa imbentaryo nga gihubit sa usa ka account. (Ang tanan nga matang sa mga butang sa imbentaryo gikuha sa usa ka lakaw dinhi aron malikayan ang pipila ka pagbalik-balik sa dokumento. Natural, ang bisan unsang subset sa mga butang sa imbentaryo mahimong makuha pinaagi sa pagbiya sa pipila ka mga linya ubos sa account sa ubos.)
Ang pagpadagan niini nga code naghatag og output sama niana sa ubos:
Examples: Mga alarma
Ang mga template sa alarma ug mga kaubang butang (mga manager sa SNMP, mga lista sa email sa alarma) gihimo ug gidumala sa parehas nga paagi sama sa mga butang sa imbentaryo. Kini nga kapitulo naglangkob sa XML ug NETCONF code alang sa pagtino sa maong mga entidad sa Paragon Active Assurance pinaagi sa NETCONF & YANG API ug alang sa pagkuha sa mga listahan sa mga butang nga gihubit.
Mga Listahan sa Email sa Alarm
Paghimo ug Alarm Email List
Pagkuha sa Tanang Alarm Email Lists
Mga SNMP Manager
Paghimo og SNMP Manager
Pagbawi sa Tanang SNMP Managers
Mga Template sa Alarm
Paghimo ug Alarm Template
Pagkuha sa Tanang Alarm Templates
Examples: SSH Keys
Mahimo nimong idugang ang SSH public key sa usa ka Test Agent pinaagi sa NETCONF & YANG API. Gamit ang katugbang nga pribado nga yawe mahimo ka dayon mag-log in sa Test Agent pinaagi sa SSH.
Ang kompleto nga lista sa magamit nga mga operasyon sa mga yawe sa SSH mao ang mosunod:
- Pagdugang og SSH key
- Usba ang usa ka SSH key
- Susiha ang usa ka SSH key
- Ilista ang mga yawe sa SSH
- Pagtangtang sa usa ka SSH key.
Sa ubos, gipakita ang mga operasyon sa pagdugang ug pagtangtang.
Pagtangtang sa SSH Key
Kung gusto nimong papason ang usa ka SSH key, gamita ang mosunud nga mando:
Examples: Mga pagsulay
Gituohan dinhi nga ang Mga Ahente sa Pagsulay (sama sa kadaghanan nga gikinahanglan alang sa mga pagsulay) gibuhat sumala sa seksyon nga "Paghimo ug Pag-deploy sa Bag-ong Ahente sa Pagsulay" sa panid 17.
YANG Model nga Dalan para sa mga Pagsulay
| butang | YANG model nga dalan: /accounts/account/tests … |
| mga pagsulay | /. |
| pagsulay [id] | /pagsulay |
| id | /test/id |
| ngalan | /test/ngalan |
| kahimtang | /test/status |
| oras sa pagsugod | /pagsulay/oras sa pagsugod |
| katapusan-panahon | /pagsulay/katapusan nga panahon |
| report-url | /test/report-url |
| mga lakang | /pagsulay/mga lakang |
| lakang [id] | /pagsulay/lakang/lakang |
| ngalan | /test/steps/step/name |
| id | /test/steps/step/id |
| oras sa pagsugod | /test/steps/step/start-time |
| katapusan-panahon | /test/steps/step/end-time |
| kahimtang | /test/steps/step/status |
| status-mensahe | /test/steps/step/status-message |
| mga templates | /templates |
| template [ngalan] | /templates/template |
| ngalan | /templates/template/name |
| paghulagway | /templates/template/deskripsyon |
| mga parametro | /templates/template/parameters |
| parameter [key] | /templates/template/parameters/parameter |
| yawe | /templates/template/parameters/parameter/key |
| tipo | /templates/template/parameters/parameter/type |
Kinahanglanon para sa Test Orchestration
- Aron makasugod ug pagsulay pinaagi sa NETCONF gamit ang NC client, gikinahanglan nga magtukod una ug test template gamit ang Control Center GUI ingon nga detalyado sa in-app nga tabang ubos sa "Mga Pagsulay ug monitor" > "Paghimo og mga templates". Ang tanang field nga gipiho sa maong template isip "Template input" gikinahanglan isip parameters sa XML kung mag-orkestra sa pagsugod sa test template.
- Ang pagpadagan sa mga pagsulay sa Paragon Active Assurance giisip nga "estado" sa konteksto sa orkestra. Ang datos sa estado mao ang dili masulat nga datos nga wala gitipigan sa database sa pagsumpo, sukwahi sa datos sa pagsumpo nga gihisgutan sa seksyon nga "Overview of Test Agent Orchestration” sa pahina 17. Kini nagpasabot nga ang mga kausaban sa mga pagsulay o templates sa Control Center GUI dili magpahinabog bisan unsang isyu nga may kalabotan sa pag-sync tali sa Control Center ug sa configuration database.
- Aron makakuha og report-URL diha mismo sa mga test report, kinahanglan nimo nga sigurohon ang Control Center URL husto nga gi-configure. Gihimo kini sa file /opt/netrounds-confd/settings.py. Pinaagi sa default ang Control Center host name makuha gamit ang socket.gethostname(): tan-awa sa ubos. Kung dili kini makahatag sa husto nga resulta, kinahanglan nimo nga itakda ang host name (o ang tibuok URL) sa mano-mano niini file.
# URL sa Control Center nga walay trailing slash.
# Kini para sa exampgigamit sa test report-url.
HOSTNAME = socket.gethostname()
NETROUNDS_URL = 'https://%s' % HOSTNAME
Pagsugod ug Pagsulay
Sama sa gihulagway sa seksyon nga "Paghimo ug Pag-deploy sa usa ka Bag-ong Ahente sa Pagsulay" sa panid 17, padagana ang command pang -f tree netrounds-ncc.yang
gikan sa direktoryo /opt/netrounds-confd/ aron ma-output ang model nga YANG. Sa kini nga modelo, ang RPC alang sa pagsugod sa usa ka pagsulay gamit ang kliyente sa NC ingon sa mosunod:
Para sa mga pagpatin-aw, tan-awa ang seksyon “Leyenda” sa panid 81 sa Apendise.
Ang mosunod nga mga lakang gipakita sa ubos:
- Ang mga Ahente sa Pagsulay narehistro na sa Paragon Active Assurance account, apan wala pay nasugdan nga mga pagsulay.
- Ang gikinahanglan nga mga parameter sa pag-input giila sa template sa pagsulay nga pagdagan.
- Ang 60 segundos nga pagsulay sa HTTP gisugdan gamit ang ncclient.
Lakang 1: Sa sinugdanan, walay pagsulay nga gisugdan sa Paragon Active Assurance account. Tan-awa ang screenshot sa ubos gikan sa Control Center GUI.
Lakang 2: Ang template nga atong gamiton sa pagsugod sa pagsulay niini nga exampAng le usa ka template sa pagsulay sa HTTP. Kini adunay duha ka mandatory input field (Mga kliyente ug URL) nga among gipiho sa paghimo sa template sa Control Center GUI.
Atong ipasabot kini nga mga parametro (taliwala sa uban) sa XML configuration nga gipahibalo sa configuration database sa atong NETCONF manager (ncclient).
Lakang 3: Ang pagsulay sa HTTP gisugdan gamit ang ncclient.
Sa ubos kay example code diin ang gikinahanglan nga impormasyon sa configuration ug mga parametro gipiho alang sa HTTP test template. Depende kung giunsa pagkatukod ang template, ang mga detalye dinhi mahimong magkalainlain.
Alang sa matag parameter, ang kinahanglan nga ihatag ang attribute. Ang yawe parehas sa mga parameter
Variable nga ngalan sa Control Center. Mahimo nimong susihon ang mga variable nga ngalan sama sa mosunod:
- I-klik ang Mga Pagsulay sa side bar ug pilia ang Bag-ong Pagkasunod-sunod sa Pagsulay.
- I-klik ang Akong Mga Template.
- I-klik ang Edit link sa ubos sa template sa interes.
- I-klik ang Edit input button sa ibabaw nga tuo nga suok.
Sa among example, ug sa default, ang variable nga mga ngalan kay gamay ra nga bersyon sa mga ngalan nga gipakita sa Control Center ("url" vs. "URL”, ug uban pa). Bisan pa, sa Control Center GUI, mahimo nimong ilisan ang ngalan sa mga variable sa bisan unsang gusto nimo.
Gawas sa yawe, ang matag parametro kinahanglan nga adunay espesipiko nga tipo: alang sa example, para sa URL.
Palihug timan-i nga kinahanglan nimo pag-usabview ang kompleto nga modelo sa YANG aron makuha ang tibuuk nga kasayuran sa mga tipo. Alang sa mga interface sa Test Agent ang tipo adunay mas komplikado nga istruktura, ingon nga ebidensya sa ilawom sa code sa ubos.
Mahimo na namong ipadagan ang script gamit ang ncclient. Kung ang tanan tama, ang pagsulay sugdan ug ang pagpatuman niini ipakita sa Control Center:
Kung ang pagsulay malampuson nga gisugdan, ang Control Center motubag gamit ang test ID. Niining example, ang test ID kay 3:
Ang test ID makita usab sa URL alang sa pagsulay sa Control Center GUI. Niining example, nga URL mao ang https://host/demo/testing/3/.
Pagkuha sa mga Resulta sa Pagsulay
Ang labing prangka nga paagi aron makuha ang mga resulta sa pagsulay mao ang pagtudlo sa ID sa pagsulay.
Sa ubos mao ang Python code alang sa pagkuha sa mga resulta gikan sa ibabaw nga HTTP test nga adunay ID = 3:
uban sa manager. Sumpaysumpaya(host=args.host, port=args.port, username=args.username,password=args.password, hostkey_verify=False) kay m:
Ang output tan-awon sama niini:
Pag-eksport ug Pag-import sa mga Test Template
Ang mga template sa pagsulay mahimong ma-eksport sa JSON nga format ug i-reimport sa kana nga format ngadto sa Control Center. Mapuslanon kini kung gusto nimo gamiton ang mga template sa pagsulay sa lahi nga pag-install sa Control Center. (Ang una nga paghimo sa mga templates labing maayo nga pagdumala pinaagi sa Control Center GUI.)
Sa ubos mao ang code alang sa paghimo sa export ug import.
Pag-eksport sa mga Template sa Pagsulay
# Pagkuha json config gikan sa tubag
gamut = ET.gikan sa string(tubag._raw)
json_config = gamut [0].teksto
print json_config
Ang template anaa sa json_config nga butang.
Pag-import sa mga Template sa Pagsulay
Ang usa ka JSON config object nga naghupot sa mga template sa pagsulay mahimong ma-reimport sa Control Center sama sa mosunod.
Examples: Mga monitor
Kini nga seksyon nagtuo nga ang mga Ahente sa Pagsulay (sama sa kadaghan nga gikinahanglan sa mga monitor) gibuhat sumala sa seksyon nga "Paghimo ug Pag-deploy sa usa ka Bag-ong Ahente sa Pagsulay" sa panid 17.
YANG Model nga Dalan para sa mga Monitor
| butang | YANG model nga dalan: /accounts/account/monitors … |
| mga monitor | /. |
| monitor [ngalan] | /monitor |
| ngalan | /monitor/ngalan |
| paghulagway | /monitor/paghulagway |
| nagsugod | /monitor/nagsugod |
| template | /monitor/template |
| alarm-configs | /monitor/alarm-configs |
| butang | YANG model nga dalan: /accounts/account/monitors/monitor/alarm-configs... |
| alarm-config[identifier] | / alarm-config |
| tigpaila | /alarm-config/identifier |
| template | /alarm-config/template |
| /alarm-config/email | |
| snmp | /alarm-config/snmp |
| thr-es-kritikal | /alarm-config/thr-es-critical |
| thr-es-critical-clear | /alarm-config/thr-es-critical-clear |
| thr-es-major | /alarm-config/thr-es-major |
| thr-es-major-clear | /alarm-config/thr-es-major-clear |
| thr-es-minor | /alarm-config/thr-es-minor |
| thr-es-minor-clear | /alarm-config/thr-es-minor-clear |
| thr-es-pasidaan | /alarm-config/thr-es-warning |
| thr-es-warning-klaro | /alarm-config/thr-es-warning-clear |
| walay-data-kagrabe | /alarm-config/no-data-severity |
| walay-data-timeout | /alarm-config/no-data-timeout |
| aksyon | /alarm-config/action |
| gidak-on sa bintana | /alarm-config/window-size |
| agwat | /alarm-config/interval |
| ipadala-lamang-kausa | /alarm-config/send-only-once |
| snmp-trap-per-stream | /alarm-config/snmp-trap-per-stream |
| butang | YANG model nga dalan: /accounts/account/monitors … |
| mga parametro | /monitor/parameter |
| butang | YANG model nga dalan: /accounts/account/monitors/monitor/parameters... |
| parameter [key] | /parameter |
| yawe | /parameter/key |
| (matang sa bili) | /parameter |
| (integer) | /parameter |
| integer | /parameter/integer |
| :( lutaw) | /parameter |
| lutaw | /parameter/float |
| :( pisi) | /parameter |
| butang | YANG model nga dalan: /accounts/account/monitors/monitor/parameters... |
| hilo | /parameter/string |
| (test-agent-interface) | /parameter |
| pagsulay-agent-interface | /parameter/test-agent-interfaces |
| test-agent-interface [“1” sa panid 58 | /parameter/test-agent-interfaces/ |
| asoy | /parameter/test-agent-interfaces/test-agent-interface/account |
| ahente sa pagsulay | /parameter/test-agent-interfaces/test-agent-interface/test-agent |
| interface | /parameter/test-agent-interfaces/test-agent-interface/interface |
| ip-bersyon | /parameter/test-agent-interfaces/test-agent-interface/ip-version |
| :( twamp- mga reflector) | /parameter |
| twamp- mga reflector | /parameter/twamp- mga reflector |
| twamp-reflector [ngalan] | /parameter/twamp-mga reflector/twamp- reflector |
| ngalan | /parameter/twamp-mga reflector/twamp-reflector/ngalan |
| :(y1731-meps) | /parameter |
| y1731-meps | /parameter/y1731-meps |
| y1731-mep[ngalan] | /parameter/y1731-meps/y1731-mep |
| ngalan | /parameter/y1731-meps/y1731-mep/ngalan |
| :(sip-accounts) | /parameter |
| sip-accounts | /parameter/sip-accounts |
| sip-account[“2” sa panid 58] | /parameter/sip-accounts/sip-account |
| asoy | /parameter/sip-accounts/sip-account/account |
| ahente sa pagsulay | /parameter/sip-accounts/sip-account/test-agent |
| interface | /parameter/sip-accounts/sip-account/interface |
| sip-address | /parameter/sip-accounts/sip-account/sip-address |
| :(iptv-channels) | /parameter |
| iptv-channels | /parameter/iptv-channels |
| iptv-channel[ngalan] | /parameter/iptv-channels/iptv-channel |
| ngalan | /parameter/iptv-channels/iptv-channel/ngalan |
- account test-agent interface
- account test-agent interface sip-address
| butang | YANG model nga dalan: /accounts/account/monitors … |
| kahimtang | /monitor/status |
| katapusan-15-minutos | /monitor/status/last-15-minutos |
| kahimtang | /monitor/status/last-15-minutes/status |
| kahimtang-bili | /monitor/status/last-15-minutes/status-value |
| katapusang takna | /monitor/status/katapusang oras |
| kahimtang | /monitor/status/last-hour/status |
| kahimtang-bili | /monitor/status/last-hour/status-value |
| katapusan-24-oras | /monitor/status/last-24-hours |
| kahimtang | /monitor/status/last-24-hours/status |
| kahimtang-bili | /monitor/status/last-24-hours/status-value |
| mga templates | /templates |
| template [ngalan] | /templates/template |
| ngalan | /templates/template/name |
| paghulagway | /templates/template/deskripsyon |
| mga parametro | /templates/template/parameters |
| parameter [key] | /templates/template/parameters/parameter |
| yawe | /templates/template/parameters/parameter/key |
| tipo | /templates/template/parameters/parameter/type |
Kinahanglanon alang sa Monitor Orchestration
Sa dili ka pa magsugod sa usa ka monitor pinaagi sa NETCONF gamit ang ncclient, kinahanglan nimo nga maghimo usa ka template sa monitor sa Control Center GUI ingon nga gipatin-aw sa tabang sa in-app sa ilawom sa "Mga Pagsulay ug monitor"> "Paghimo mga template". Ang tanan nga mga natad nga gipiho nga "Template input" sa kana nga template kinahanglan nga mga parameter sa XML kung mag-orkestra sa pagsugod sa template.
Pagkuha Mga Parameter sa Input gikan sa Mga Template sa Monitor
Sa ubos, duha ka templates ang gipakita. Ang una alang sa pag-monitor sa UDP tali sa duha nga mga interface sa Test Agent, ug ang ikaduha alang sa HTTP gamit ang usa ka interface sa Test Agent.
Aron mahibal-an ang input parameter sa usa ka template, i-klik ang kahon nga nagrepresentar sa template. Alang sa template sa HTTP, ang mga parameter mahimong ingon niini:
Kinahanglan namon nga ipasabut kini nga mga parameter sa sunod nga lakang sa pagsugod sa usa ka monitor.
Pagsugod sa usa ka Monitor
Gamit ang Mga Ahente sa Pagsulay nga among gihubit ug gipakatap sa seksyon nga "Paghimo ug Pag-deploy og Bag-ong Ahente sa Pagsulay" sa panid 17, makasugod kami usa ka monitor gikan sa template nga "HTTP" sama sa gipakita sa ubos.
Alang sa matag parameter, ang kinahanglan nga ihatag ang attribute. Ang yawe parehas sa ngalan sa Variable sa parameter sa Control Center. Mahimo nimong susihon ang mga variable nga ngalan sama sa mosunod:
- I-klik ang Monitoring sa side bar ug pilia ang New Monitor.
- I-klik ang Akong Mga Template.
- I-klik ang Edit link sa ubos sa template sa interes.
- I-klik ang Edit input button sa ibabaw nga tuo nga suok.
Sa among example, ug sa default, ang variable nga mga ngalan kay gamay ra nga bersyon sa mga ngalan nga gipakita sa Control Center ("url" vs. "URL”, ug uban pa). Bisan pa, sa Control Center GUI, mahimo nimong ilisan ang ngalan sa mga variable sa bisan unsang gusto nimo.
Gawas sa yawe, ang matag parametro kinahanglan nga adunay espesipiko nga tipo: alang sa example, para sa URL. Palihug timan-i nga ang bug-os nga kasayuran sa tipo sa parameter makita sa modelo nga YANG. Alang sa mga interface sa Test Agent ang tipo adunay mas komplikado nga istruktura, ingon nga ebidensya sa code sa ubos.
Sa exampAng mosunod, walay alarma nga nalangkit sa monitor. Kay exampsa mga alarma, adto sa seksyon nga “Pagsugod sa Monitor gamit ang Alarm” sa pahina 62.
Pagsugod sa usa ka Monitor nga adunay Alarm
Sa pag-asoy sa usa ka alarma sa usa ka monitor, mahimo nimong itudlo ang usa ka template sa alarma nga gihubit, o mahimo nimong ihatag ang tibuuk nga pag-configure sa alarma sa paghimo sa monitor. Hatagan namo ug usa ka example sa matag pamaagi sa ubos.
Pag-set up sa usa ka Monitor Alarm pinaagi sa Pagtudlo sa usa ka Alarm Template
Aron magamit ang usa ka template sa alarma, kinahanglan nimo mahibal-an ang ID niini. Alang niini, kuhaa una ang tanan nimong mga template sa alarma sama sa gihulagway sa seksyon nga "Pagkuha sa Tanan nga Mga Template sa Alarm" sa pahina 39 ug timan-i ang ngalan sa may kalabutan nga template. Mahimo nimong i-refer ang maong template sama sa mosunod:
Pag-set up ug Monitor Alarm pinaagi sa Pag-configure Niini Directly
Sa laing paagi, mahimo nimong i-set up ang usa ka alarma alang sa usa ka monitor pinaagi sa paghatag sa tibuuk nga pag-configure niini sa paghimo sa monitor, nga wala maghisgot sa usa ka template sa alarma. Gihimo kini sama sa gipakita sa mosunod nga example.
Pagbawi sa Nagdagan nga mga Monitor
Aron makuha ang tanan nga mga monitor nga karon nagpatuman, padagana kini nga script:
uban sa manager. connect(host=args.host, port=args.port, username=args. user name, password=args.password, hostkey_verify=False) kay m:
Ang output usa ka lista sa tanan nga nagdagan nga monitor sama sa gipakita sa ubos:
Pagbawi sa SLA Status para sa usa ka Monitor
Ania kung giunsa pagkuha ang kahimtang sa SLA alang sa usa ka monitor. Niining exampug, among gibawi ang SLA status para sa monitor nga “Network Quality” sulod sa tulo ka agwat sa panahon: ang kataposang 15 ka minuto, ang kataposang oras, ug ang kataposang 24 ka oras.
Ang output tan-awon sama niini:
Mga Notipikasyon sa NETCONF
Ang mga abiso sa NETCONF alang sa mga monitor na-trigger sa mga paglapas sa SLA. Mahitabo kini kung ang SLA alang sa monitor moubos sa ubos sa SLA threshold (“Maayo” o “Dawaton”) sulod sa gihatag nga window sa oras, nga default sa katapusang 15 ka minuto. Kinahanglang hinumdoman nga ang mga abiso sa paglapas sa SLA dali nga makita pagkahuman naapektuhan ang usa ka serbisyo sa usa ka isyu, samtang ang kahimtang sa SLA mobalik sa "Maayo" pagkahuman sa 15 minuto, ug kung wala nay mga paglapas nga mahitabo.
Ang bintana sa oras mahimong usbon pinaagi sa pag-edit sa setting nga SLA_STATUS_WINDOW (bili sa mga segundo) sa /etc/netrounds/netrounds.conf.
Pag-eksport ug Pag-import sa mga Template sa Monitor
Gihimo kini sa eksakto nga paagi sama sa mga template sa pagsulay; itandi ang seksyon nga "Pag-eksport ug Pag-import sa mga Test Template" sa pahina 52. Ang mga snippet sa code sa ubos nag-ilustrar kon unsaon pag-eksport ug pag-import og mga templates alang sa mga monitor.
Pag-eksport sa mga Template sa Monitor
Pag-import sa mga Template sa Monitor
Tags nga gihubit sa Paragon Active Assurance mahimong magamit sa:
- mga monitor
- monitor templates
- Mga Ahente sa Pagsulay
- TWAMP mga reflector
- Mga host sa ping.
Kay example, mahimo nimo tag usa ka monitor nga adunay parehas tag isip usa ka subset sa Test Agents nga magpadagan sa monitor. Kini nga bahin labi ka makatabang kung ikaw adunay daghang mga monitor ug mga template nga gipasabut.
Kung nagbutang ka usa ka alarma nga adunay SNMP traps para sa usa ka monitor, nan ang SNMP traps i-assign sa parehas tags isip monitor, kon aduna man.
Pagmugna Tags
Sa ubos gipakita namon kung giunsa paghimo ang usa ka tag nga adunay ngalan ug kolor sama sa gipasabut sa XMLtag> substruktura.
Pag-assign a Tag
Sa pag-assign sa usa ka tag sa usa ka kapanguhaan, idugang nimo kini isip bag-otag> elemento ubos satags> elemento alang niana nga kapanguhaan.
Ania kung giunsa ang pag-assign sa usa ka tag sa usa ka Ahente sa Pagsulay:
Sa pag-assign sa usa ka tag sa usa ka TWAMP reflector, buhata ang mosunod:
Pag-assign a tag sa usa ka monitor gidumala sa parehas nga paagi:
Sa laing paagi, mahimo nimong i-assign ang usa ka naa na tag sa bisan hain niini nga mga matang sa kapanguhaan sa paghimo sa kapanguhaan, pinaagi sa paglakip satags> elemento nga naglangkob sa tag sa pangutana.
Pag-update a Tag
Pag-update sa anaa na tag uban sa bag-ong mga hiyas susama sa paghimo sa usa ka tag:
Pag-unassign a Tag
Sa pag-unassign a tag gikan sa usa ka kapanguhaan, idugang ang attribute nc: operation = "delete" satag> elemento nga iya sa kapanguhaan. Sa ubos, gi-unassign namo ang a tag gikan sa monitor.
Pagtangtang a Tag
Aron mapapas ang a tag gikan sa Control Center, ang attribute nc: operation = "delete" gigamit pag-usab, apan niining panahona gigamit sa tag mismo, gihubit ubos .
Pag-troubleshoot
Problema: Orchestrator ug Paragon Active Assurance Out of Sync
Ang orkestra ug Paragon Aktibo nga Assurance mahimong mawala sa pag-sync alang sa example kung ang mga pagbag-o sa configuration nahimo sa Control Center GUI, o kung ang pag-apply sa usa ka configuration dili malampuson ug ang pagbalik sa miaging estado napakyas.
Sa kaso sa usa ka pakyas nga rollback, ang NETCONF server dili na modawat sa configuration kausaban; kini motubag uban sa usa ka mensahe sa sayop nga nag-ingon nga ang pag-configure kay naka-lock hangtod balik sa pag-sync. Aron makabalik sa pag-sync ug pag-abli sa mga pagbag-o sa configuration, kinahanglan nimo nga ipadagan ang command rpc sync-from-ncc nga nag-synchronize sa tanang configuration gikan sa Control Center ngadto sa configuration database.
NOTA: Ang confd@netrounds.com user (o bisan unsa nga na-configure) kinahanglan nga adunay superuser nga mga pribilehiyo alang sa tanan nga malampuson nga ma-sync. Mahimo kini nga makab-ot gamit ang command ncc user-update confd@netrounds.com -is-superuser Kung ang user dili usa ka superuser, usa ka pasidaan ang makita nga nag-ingon nga dili tanan mahimong ma-sync, apan ang tanan nga mahimo nga madumala nahimo.
NOTA: Kung gitipigan usab sa imong orkestra ang pag-configure, kinahanglan nimo nga i-synchronize usab kana tungod kay ang gihangyo nga pag-configure (ang pag-configure nga gipaabut sa orkestra nga naa sa Control Center) wala pa magamit.
Problema: Initial Sync (sync-from-ncc) Napakyas Tungod sa Dili Gisuportahan nga mga Kapanguhaan
Kung mosulay ka sa pagpadagan sa rpc sync-from-ncc sa usa ka account nga adunay configuration nga gihimo sa Control Center GUI, mahimo ka nga adunay mga problema kung ang account adunay dili suportadong mga kapanguhaan. Girekomenda nga magsugod ka sa usa ka walay sulod nga account ug buhaton ang tanan nga pag-configure niini pinaagi sa NETCONF. Kung dili, kung makasugat ka og mga isyu sa mga panagsumpaki sa kapanguhaan, kinahanglan nimong tangtangon ang nagkasumpaki nga mga kapanguhaan gikan sa account.
Problema: NETCONF commands napakyas sa ncclient.operations.rpc.RPCError: application communication failure
Ang NETCONF server dili ibalik ang koneksyon sa Control Center server awtomatik kung ang Control Center gi-restart. Aron ibalik ang koneksyon sa Control Center, i-restart ang proseso sa NETCONF: sudo systemctl restart netrounds-confd
Mga Pahinumdom sa Mga Aplikasyon sa Test Agent ug Mga Appliances sa Ahente sa Pagsulay
Test Agent Applications sa ConfD
Taliwala sa mga Ahente sa Pagsulay, ang (mas bag-o) nga Aplikasyon sa Ahente sa Pagsulay medyo lahi sa (karaan) nga Appliance sa Ahente sa Pagsulay.
Ang mga Aplikasyon sa Test Agent wala karon nagsuporta sa configuration sa interface. Busa, ang YANG schema nagtugot sa pagpiho sa usa ka walay sulod nga interface configuration alang sa maong Test Agents. Tan-awa ang “kini nga tudling” sa pahina 23 para sa usa ka example.
Kung gi-synchronize ang database sa ConfD sa Control Center gamit ang sync-from-ncc command, gusto nimo nga ang interface configuration magpabilin nga walay sulod ug dili ma-overwritten sa makita sa Control Center. Busa kinahanglan nimo nga gamiton ang usa ka espesyal nga bandila -without_interface_config uban niana nga sugo sa dihang nagtrabaho uban sa Test Agent Applications.
Walay sulod nga Interface Configuration para sa Test Agent Appliance
Sama sa gihisgutan sa ibabaw, ang Test Agent Application wala mosuporta sa interface configuration, ug busa posible nga i-omit ang mga interface sa YANG schema.
Apan adunay usab mga kaso sa paggamit diin mahimo nimong tangtangon ang pagsumpo sa interface gikan sa usa ka Test Agent Appliance. Usa ka exampKini mahimo nga usa ka orkestrasyon nga senaryo diin ikaw nagtuyok sa usa ka Test Agent gamit ang cloud-init, ug gusto nimo nga ang interface configuration gikan didto gamiton, imbes nga tugutan ang ConfD nga i-overwrite kini samtang ang Test Agent moabut online.
Mga Pagbag-o sa YANG Schema Mahitungod sa Dili Matino nga mga Interface
Tungod kay ang usa ka walay sulod nga interface configuration gitugotan na karon (gikan sa bersyon 2.34.0 sa unahan), kini mao ang posible nga sa pagtino sa bisan unsa nga interface ngalan ingon nga input sa usa ka buluhaton nga nagdagan ingon nga bahin sa usa ka pagsulay o monitor.
Kini gikinahanglan aron makagamit sa Test Agent Application, tungod kay alang niini walay mga ngalan sa interface nga gihubit sa ConfD. Hinumdumi, bisan pa, nga kini nagpasabut usab nga mahimo ka makasinati mga problema kung sa aksidente imong gi-configure ang usa ka pagsulay o monitor aron magamit ang usa ka wala na nga interface. Busa palihug hinumdomi kini.
Mga Limitasyon Kung Nagparehistro sa Usa ka Ahente sa Pagsulay Gibuhat sa ConfD
Kung maghimo ug Test Agent pinaagi sa REST o NETCONF/YANG API, dili nato mahibal-an daan kung unsang klase kini: Test Agent Appliance o Test Agent Application. Kini mahimong tin-aw lamang human narehistro ang Test Agent.
Kung narehistro na ang Test Agent ug nahimo nang usa sa mga konkretong tipo, dili ka tugutan nga irehistro kini pag-usab isip lahi nga klase sa Test Agent. Kini nagpasabot nga dili ka tugotan nga una kining irehistro isip Test Agent Appliance, unya irehistro kini pag-usab isip Test Agent Application, o vice versa. Kung kinahanglan nimo ang usa ka Test Agent sa usa ka lahi nga tipo, kinahanglan nimo nga maghimo usa ka bag-ong Test Agent.
Apendise: Kahoy nga Istruktura sa Bug-os nga Modelo sa YANG
Niini nga apendise, ang seksyon nga "Legend" sa panid 81 nagpatin-aw sa syntax sa YANG model tree structure nga namugna gamit ang command pyang -f tree.
Ang seksyon nga "YANG Model Tree Structure" sa panid 82 naghatag sa output gikan sa command nga gipadapat sa netrounds-ncc.yang. Ang mga bahin niini nga output gikopya sa ubang dapit sa dokumento.
leyenda
Modelong Kahoy nga Istruktura sa YANG
Ang Juniper Networks, ang logo sa Juniper Networks, Juniper, ug Junos kay mga rehistradong marka sa pamatigayon sa Juniper Networks, Inc. sa Estados Unidos ug uban pang mga nasud. Ang tanan nga uban pang mga marka sa pamatigayon, mga marka sa serbisyo, mga rehistradong marka, o mga rehistradong marka sa serbisyo kay gipanag-iya sa ilang tagsa-tagsa ka tag-iya. Ang Juniper Networks walay responsibilidad sa bisan unsang mga sayop niini nga dokumento. Ang Juniper Networks adunay katungod sa pag-usab, pag-usab, pagbalhin, o pag-usab niini nga publikasyon nga walay pahibalo. Copyright © 2023 Juniper Networks, Inc. Tanang katungod gigahin.
Mga Dokumento / Mga Kapanguhaan
 |
Juniper NETWORKS NETCONF & YANG API Software [pdf] Giya sa Gumagamit NETCONF YANG API Software, YANG API Software, API Software, Software |