Menghitung VPN situs FTD yang aktif: angka mana yang Anda maksud?

Sebelum menulis tugas Ansible, jawab pertanyaan yang lebih kecil: apa yang sedang dihitung? Peer terkonfigurasi, sesi IKE, asosiasi keamanan IPsec, dan catatan status terowongan termonitor adalah empat unit berbeda, dan regenerasi kunci atau beberapa jaringan terlindungi membuat totalnya menyimpang. Jika dasbor dan playbook tidak sepakat, biasanya keduanya menghitung hal yang berbeda, bukan salah satunya keliru.

Empat hal yang disebut orang sebagai aktif

Peer terkonfigurasi adalah objek topologi: ia ada karena seseorang mendefinisikannya. Sesi IKE adalah hubungan bidang kendali yang bisa hidup tanpa ada lalu lintas yang mengalir. SA IPsec adalah asosiasi bidang data untuk pasangan pemilih tertentu, dan satu terowongan dapat membawa beberapa. Status terowongan termonitor adalah putusan operasional platform itu sendiri, yang biasanya paling dekat dengan maksud operator saat mengatakan terowongannya hidup.

Hanya yang terakhir merupakan dasar wajar untuk hitungan operasional. Yang pertama adalah inventaris konfigurasi, dan melaporkannya sebagai aktif adalah cara dasbor menampilkan hijau untuk peer yang mati sejak Selasa. Tentukan unit mana yang dibutuhkan konsumen angka itu, lalu beri label metrik dengan unit tersebut pada namanya sendiri.

Keputusan satu: bidang manajemen mana?

Jika perangkat dikelola FDM, permukaan yang relevan adalah FTD REST API. Jika dikelola FMC, API itu bukan pengganti yang setara, dan objeknya berada di balik API milik FMC. Pastikan ini sebelum menulis satu permintaan pun, karena bidang yang salah mengembalikan galat masuk akal yang terlihat seperti masalah izin.

Untuk armada, jawabannya juga menentukan di mana hitungan itu berada: per perangkat melalui FDM, atau per domain melalui FMC. Itu cakupan berbeda dan menghasilkan angka berbeda untuk armada yang sama.

Keputusan dua: sumber daya mana yang menjawab?

Untuk contoh yang dibatasi versi, referensi objek FMC 7.3 API mendokumentasikan sumber daya GET di bawah jalur health:

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

Sumber daya status terowongan mendukung filter perangkat dan status, termasuk TUNNEL_UP. Itu memberi Anda sumber daya operasional nyata untuk diperiksa pada versi tersebut, bukan tebakan tentang nama bidang.

Pastikan ketersediaan, izin, parameter permintaan, dan skema respons di API Explorer FMC yang terpasang sebelum menerapkan parser. Dokumentasi satu versi adalah titik awal, bukan kontrak untuk versi yang Anda jalankan.

Tulis kontrak hitungan

Nyatakan metrik dalam satu kalimat: catatan terowongan operasional unik untuk satu perangkat dan domain yang dimaksud yang statusnya dilaporkan TUNNEL_UP. Lalu dokumentasikan bagaimana perangkat redundan dan beberapa catatan untuk satu situs logis direpresentasikan, karena kedua kasus itu menentukan apakah angka Anda cocok dengan angka di rapat.

Jangan diam-diam mengubah unit dari catatan terowongan menjadi situs jarak jauh. Jika bisnis menginginkan situs, petakan catatan ke situs secara eksplisit dan terbitkan pemetaannya. Hitungan yang diam-diam mendefinisikan ulang dirinya lebih buruk daripada tidak ada hitungan, karena tak seorang pun bisa tahu kapan ia berubah.

Perlakukan sumber daya ringkasan sebagai kemudahan hanya setelah Anda memastikan apa yang diringkasnya. Ia mungkin mengagregasi persis yang Anda butuhkan, atau menjawab pertanyaan yang sedikit berbeda. Baca skemanya sekali, catat perbedaannya, dan gunakan sumber daya status jika ringkasannya tidak dapat dijelaskan. Ringkasan yang tidak Anda pahami adalah angka yang tidak dapat Anda pertahankan dalam tinjauan.

Biarkan alur kerja mempertahankan ketidakpastian

Gunakan HTTPS API yang disetujui, validasi sertifikat, jauhkan token dari keluaran tugas, dan ambil cakupan dengan filter dan penomoran halaman yang didukung versi. Lalu validasi skema sebelum menghitung apa pun.

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

Ini pseudokode alur kerja, bukan playbook yang teruji. Ambil nama bidang sebenarnya dari API yang terpasang alih-alih mengarang kunci JSON bernama active.

Aturan pentingnya adalah perilaku saat gagal: galat otorisasi, sumber daya tak didukung, sampel basi, atau kumpulan halaman tak lengkap harus menghasilkan unknown atau error, tidak pernah nol yang sukses. Nol yang berarti saya tidak bisa bertanya adalah jenis kesalahan paling mahal.

Validasi terhadap pandangan platform itu sendiri

Bandingkan hasil pertama dengan tampilan pemantauan VPN versi itu untuk perangkat dan saat yang sama. Ketika keduanya berbeda, cari tahu unit mana yang dipakai masing-masing sebelum mengubah playbook.

Pertahankan konteks non-rahasia untuk setiap eksekusi: cakupan, stempel waktu, unit metrik, dan jumlah catatan. referensi objek FMC 7.3 API adalah sumber jalur sumber daya di atas, dan API Explorer pada penerapan Anda sendiri adalah sumber untuk segala hal lainnya.