Aktive FTD-side-VPN's telle: hokker getal bedoelst do?

Foardatst de Ansible-taak skriuwst, beächtet in lytser fraach: wat wurdt teld? In konfigurearre peer, in IKE-sesje, in IPsec-feiligensassoasje en in monitord tunnelstatus-record binne fjouwer ferskillende ienheden, en kaaifernijing of ferskate beskerme netwurken meitsje har totalen útinoar rinne. As it dashboard en it playbook it net iens binne, telle se meastentiids ferskillende dingen ynstee dat ien fan beide ferkeard is.

Fjouwer dingen dy't minsken aktyf neame

In konfigurearre peer is in topology-objekt: it bestiet om't immen it definiearre hat. In IKE-sesje is in relaasje op it kontrôleflak dy't oan wêze kin wylst gjin ferkear streamt. In IPsec-SA is de assosjaasje op it dataflak foar in bepaald selektpear, en ien tunnel kin ferskate drage. In monitorde tunnelstatus is it eigen operasjonele oardiel fan it platfoarm, dat meastentiids it tichtst by is wat in operator bedoelt as er seit dat de tunnel oan is.

Allinnich de lêste is in ridlike basis foar in operasjonele telling. De earste is in konfiguraasje-ynventaris, en it as aktyf rapportearje is hoe't in dashboard grien lit sjen foar in peer dy't sûnt tiisdei del is. Beslis hokker ienheid de konsumint fan it getal nedich hat, en labelje dan de metrik mei dy ienheid yn har eigen namme.

Beslissing ien: hokker behearflak?

As it apparaat troch FDM beheard wurdt, is de FTD REST API it relevante oerflak. As it troch FMC beheard wurdt, is dy API gjin ferwikselbere ferfanging, en de objekten wenje efter FMC syn eigen API. Befêstigje dit foardatst ien oanfraach skriuwst, want it ferkearde flak jout in leauweardige flater werom dy't op in tastimmingsprobleem liket.

Foar in float beslút it antwurd ek wêr't de telling heart: per apparaat fia FDM, of per domein fia FMC. Dat binne ferskillende omfangen en se leverje ferskillende getallen foar deselde float.

Beslissing twa: hokker boarne antwurdet?

Foar in ferzje-bûn foarbyld dokumintearret de FMC 7.3 API-objektreferinsje GET-boarnen ûnder it health-paad:

/api/fmc_config/v1/domain/{domainUUID}/health/tunnelstatuses
/api/fmc_config/v1/domain/{domainUUID}/health/tunnelsummaries

De tunnelstatus-boarne stipet apparaat- en statusfilters, wêrûnder TUNNEL_UP. Dat jout dy in echte operasjonele boarne om foar dy ferzje te besjen, ynstee fan in gissing oer in fjildnamme.

Befêstigje beskikberens, tastimmingen, oanfraachparameters en it antwurdskema yn de API Explorer fan 'e útrôle FMC foardatst in parser ymplemintearrest. Dokumintaasje foar ien ferzje is in útgongspunt, gjin kontrakt foar dy'tsto draaist.

Skriuw it telkontrakt

Sis de metrik yn ien sin: unike operasjonele tunnelrecords foar ien bedoeld apparaat en domein waans rapporteare status TUNNEL_UP is. Dokumintearje dan hoe't redundante apparaten en meardere records foar ien logyske side fertsjintwurdige wurde, want dy twa gefallen beslisse oft dyn getal oerienkomt mei dat yn 'e gearkomste.

Feroarje de ienheid net stil fan tunnelrecord nei fiere side. As it bedriuw siden wol, mapje records dan eksplisyt oan siden en publisearje de mapping. In telling dy't himsels stil opnij definiearret is slimmer as gjin telling, want nimmen kin sizze wannear't it feroare is.

Behannelje de gearfettingsboarne as in gemak pas nei'tst befêstige hast wat it gearfettet. It kin krekt agregarje watsto nedich hast, of it kin in subtil oar fraach beantwurdzje. Lês it skema ien kear, skriuw it ferskil op, en brûk de statusboarne as de gearfetting net útlein wurde kin. In gearfetting dy'tsto net begrypst is in getal datsto net ferdigenje kinst yn in resinsje.

Lit de wurkstream ûnwisens behâlde

Brûk de goedkarde HTTPS API, falidearje it sertifikaat, hâld tokens bûten de taakútfier, en helje de omfang mei it filter en de sidearring dy't de ferzje stipet. Falidearje dan it skema foardatst wat berekkenst.

fetch intended domain/device runtime records
validate response, completeness and freshness
deduplicate by the documented tunnel identity
count records matching the approved up-state definition
report count with scope, timestamp and metric unit

Dat is pseudokoade fan in wurkstream, gjin testen playbook. Nim de werklike fjildnammen út 'e ynstallearre API ynstee fan in JSON-kaai mei de namme active te betinken.

De wichtige regel is falgedrach: in autorisaasjeflater, in net-stipe boarne, in ferâldere stekproef of in ûnfolsleine siden-set moatte unknown of error jaan, nea in suksesfolle nul. In nul dy't betsjut dat ik net freegje koe is it djoerste soart ferkeard.

Falidearje tsjin 'e eigen werjefte fan it platfoarm

Fergelykje it earste resultaat mei de VPN-monitoarwerjefte fan 'e ferzje foar itselde apparaat en itselde momint. As se ferskille, sykje dan út hokker ienheid elk brûkt foardatst it playbook feroarjest.

Bewarje net-geheim kontekst foar elke run: omfang, tiidstimpel, metrik-ienheid en recordtal. De FMC 7.3 API-objektreferinsje is de boarne foar de boppesteande boarnepaaden, en de API Explorer op dyn eigen útrôl is de boarne foar al it oare.