Siapkan logging

Halaman ini memberikan informasi tentang cara Cloud Network Insights berintegrasi dengan AppNeta untuk pembuatan alarm dan cara alarm ini dikirim ke Google Cloud untuk analisis, melihat, dan membuat kebijakan pemberitahuan.

Tugas logging dan pemberitahuan dibagi antara Google Cloud dan AppNeta. Logging Cloud Network Insights melacak kapan metrik yang dikumpulkan oleh Titik Pemantauan melanggar batas yang Anda konfigurasi dengan aturan alarm di AppNeta.

Buat alarm dan aturan alarm di AppNeta untuk membuat log alarm. Log alarm dan log peristiwa kemudian diekspor ke Cloud Logging. Selanjutnya, Anda dapat menggunakan kebijakan pemberitahuan untuk mengirim pemberitahuan dan notifikasi saat terjadi insiden jaringan.

Sebelum memulai

Anda harus men-deploy Titik Pemantauan sebelum dapat membuat aturan alarm.

Alarm di AppNeta

Alarm dan aturan alarm dibuat di AppNeta. Alarm memberi tahu Anda saat ada masalah di jaringan Anda. Jika metrik yang Anda lacak, seperti latensi, melebihi batas yang ditetapkan dalam interval tertentu, hal itu merupakan pelanggaran aturan alarm. Anda dapat memilih untuk memicu alarm setelah satu pelanggaran atau setelah beberapa pelanggaran selama interval yang ditetapkan.

Misalnya, jika latensi melebihi 160 milidetik dua kali dalam 3 menit, Anda dapat menyetel alarm untuk memicu peringatan. Alarm ini dikirim ke Google Cloud sebagai log. Setelah log tiba di Cloud Logging, Anda dapat mengirim pemberitahuan tentang log tersebut dan memberi tahu tim Anda.

Untuk mengetahui informasi selengkapnya tentang alarm, lihat Ringkasan Alarm atau Alarm – Praktik Terbaik dalam dokumentasi AppNeta.

Membuat aturan alarm di AppNeta

Membuat aturan alarm yang menentukan batas performa.

  1. Buka konsol Google Cloud dan buka Network Intelligence > Cloud Network Insights > Kebijakan Pemberitahuan.

    Buka Alert Policies

  2. Klik Create Alarm Rules untuk membuka halaman Alarm Rule Edit di AppNeta.

  3. Tentukan aturan yang menentukan metrik, nilai minimum, strategi pelanggaran, dan tingkat keparahan. Anda dapat menggunakan atau menyesuaikan aturan default.

Setelah alarm dipicu, log alarm akan dikirim ke Cloud Logging. Setelah log dikirim ke Google Cloud, Anda dapat membuka Cloud Network Insights dan menetapkan kebijakan pemberitahuan.

Untuk mengetahui informasi selengkapnya tentang cara membuat aturan alarm, lihat Aturan Alarm dalam dokumentasi AppNeta.

Lihat log di Google Cloud

Cloud Network Insights mengekspor log mendetail di Cloud Logging untuk membantu Anda menganalisis dan memecahkan masalah performa jaringan dan peristiwa penting. Anda dapat mengakses log ini menggunakan Logs Explorer.

  1. Di konsol Google Cloud , buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Membuat kueri untuk memberi tahu informasi yang relevan.

Log Cloud Network Insights menggunakan salah satu ID log berikut:

  • Log alarm: networkmanagement.googleapis.com/insights_alarm
  • Log peristiwa: networkmanagement.googleapis.com/insights_event

Untuk mengetahui informasi selengkapnya, lihat Membuat dan menyimpan kueri menggunakan bahasa kueri Logging.

Harga

Semua log Cloud Network Insights ditulis ke Cloud Logging. Tidak ada biaya terpisah dari Cloud Network Insights untuk layanan ini. Namun, log ini dapat menimbulkan biaya penyimpanan tambahan, bergantung pada ukuran log yang ditulis dan disimpan.

Untuk mengetahui informasi tentang harga Cloud Logging, lihat Harga Google Cloud Observability: Cloud Logging.

Detail log

Meskipun detail spesifik untuk setiap jenis log terdapat dalam kolom jsonPayload, beberapa kolom LogEntry standar lainnya sangat penting untuk membuat kueri dan memahami log.

Log alarm

  • ID Log: networkmanagement.googleapis.com/insights_alarm
  • Dipicu: Dibuat saat kondisi aturan alarm terpenuhi.
  • Resource Labels: Menjelaskan resource yang dimonitor yang terkait dengan log. Hal ini mencakup:
    • type - Jenis resource, dapat berupa salah satu dari berikut ini:
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
      • networkmanagement.googleapis.com/WebPath
    • labels - Pasangan nilai kunci yang mengidentifikasi instance resource tertentu, seperti resource_container (project ID), location, network_monitoring_provider_id, dan path_id atau monitoring_point_id.
  • Kolom JSON Utama: Log alarm memberikan informasi tentang alarm yang dipicu.
  • Pemetaan Tingkat Keparahan: Tingkat keparahan dicatat secara berbeda antara AppNeta dan Google Cloud.
    Tingkat keparahan AppNeta Tingkat keparahan log Google Cloud
    Kritis KRITIS
    Berat ERROR
    Ringan PERINGATAN
    Peringatan PEMBERITAHUAN

Kolom log alarm

jsonPayload log alarm berisi kolom berikut.

Kolom Jenis Deskripsi
alarm_id string ID unik untuk alarm di AppNeta.
alarm_severity enum Tingkat keparahan alarm. Dapat berupa CRITICAL, MAJOR, MINOR, atau WARNING.
alarm_type enum Jenis alarm. Jenis QUALITY_OF_SERVICE didukung.
cleared_reason string Alasan alarm dihapus. Hanya dibuat jika state = "CLEARED" (jika tidak, akan dihilangkan atau null). Nilai string umum mencakup alarm-rule-no-longer-violated, stale, rule-deleted, dan duplicate.
cleared_time timestamp Waktu saat alarm dihapus. Kolom ini akan kosong jika log alarm memiliki status RAISED atau UPDATED.
description string Deskripsi alarm yang dapat dibaca manusia.
first_violation_time timestamp Waktu saat kondisi alarm pertama kali dilanggar.
item objek Entity yang terkait dengan alarm. Lihat Struktur Item Umum untuk mengetahui detailnya.
noise_conditions array string Mengidentifikasi kondisi filter derau yang menandai alarm ini untuk pasangan aturan dan item tertentu. Alarm dievaluasi berdasarkan nilai minimum frekuensi 24 jam dan periode burst jangka pendek.

Dapat berisi salah satu atau kedua nilai berikut:

  • frequent-detection: Dipicu saat kemunculan alarm pada item yang sama mencapai nilai minimum 24 jam (default: 5 alarm).
  • burst-detection: Dipicu saat beberapa alarm terjadi dalam rentang waktu yang dikonfigurasi (default: lebih dari 1 alarm per 60 menit).

Menampilkan array kosong atau dihilangkan sepenuhnya jika alarm tidak dianggap berisik.

provider_link string Hyperlink ke alarm di UI AppNeta.
raised_time timestamp Waktu alarm diaktifkan.
receiveTimestamp string Waktu pembuatan alarm di Google Cloud.
rule string Nama aturan alarm yang memicu alarm.
state enum Status alarm. Dapat berupa RAISED, UPDATED (detail alarm telah diperbarui di AppNeta, tetapi belum dihapus), atau CLEARED.
timestamp string Waktu pembuatan alarm di AppNeta.

Log peristiwa

  • ID Log: networkmanagement.googleapis.com/insights_event
  • Pemicu: Dibuat saat terjadi perubahan struktural (misalnya, Route Change, MTU Change, atau Monitoring Point Offline).
  • Tingkat keparahan: Selalu INFO.
  • Kolom JSON Utama: Log peristiwa memberikan informasi tentang peristiwa yang dipicu.

Kolom log peristiwa

jsonPayload log peristiwa berisi kolom berikut.

Kolom Jenis Deskripsi
event_detail objek Detail khusus untuk jenis peristiwa. Nilai ini dapat berupa route_change_event, mtu_change_event, qos_change_event, atau forwarding_loss_clear_event. Objek kosong akan ditampilkan untuk peristiwa yang tidak memiliki detail lebih lanjut. Lihat Kolom detail peristiwa untuk mengetahui detailnya.
event_id string ID unik untuk peristiwa ini.
event_type enum Jenis peristiwa. Dapat berupa MONITORING_POINT_OFFLINE, MONITORING_POINT_ONLINE, ROUTE_CHANGE, MTU_CHANGE, QOS_CHANGE, atau FORWARDING_LOSS_CLEAR.
item objek Entitas yang terkait dengan peristiwa. Lihat Struktur item umum untuk mengetahui detailnya.
receiveTimestamp string Waktu pembuatan peristiwa di Google Cloud.
timestamp string Waktu peristiwa dibuat di AppNeta.

Kolom detail peristiwa

Objek event_detail berisi detail khusus untuk jenis peristiwa. Bergantung pada event_type, objek ini berisi salah satu objek bertingkat berikut:

Objek kosong ditampilkan untuk peristiwa tanpa detail lebih lanjut.

Peristiwa perubahan MTU (mtu_change_event)

Objek ini mencatat detail setiap kali ukuran MTU diubah.

Kolom Jenis Deskripsi
new_mtu int32 MTU yang baru diukur.
previous_mtu int32 MTU sebelumnya, jika ada (dihilangkan saat memulai).
mtu_exceeded objek hop Hop yang berisi detail (seperti alamat IP) node yang melaporkan error packet-too-big. Lihat Hop untuk mengetahui detail selengkapnya.

Peristiwa perubahan QoS (qos_change_event)

Objek ini melaporkan pemetaan ulang QoS di semua jalur yang terdeteksi.

Kolom Jenis Deskripsi
configured_qos int32 QoS yang dikonfigurasi di setelan tugas.
remapped_qos int32 QoS yang diubah terdeteksi di jalur.
ip_address string Alamat IP hop tempat perubahan QoS terdeteksi, jika diketahui.

Peristiwa penghapusan kerugian penerusan (forwarding_loss_clear_event)

Objek ini melaporkan bahwa paket hilang berkelanjutan yang dimulai pada hop jaringan tertentu (kehilangan penerusan) telah teratasi dan penerusan normal telah dilanjutkan. Peristiwa ini mencatat kapan penerusan normal dilanjutkan dan stempel waktu awal yang dicurigai. Timbulnya kerugian penerusan dipantau menggunakan alarm AppNeta.

Kolom Jenis Deskripsi
protocol string Protokol pemantauan (seperti TCP, UDP, dan ICMP).
first_hop objek hop Hop pertama tempat kehilangan penerusan dimulai. Lihat Hop untuk mengetahui detail selengkapnya.
initial_loss_suspected_time timestamp Waktu saat kehilangan penerusan pertama kali dicurigai.

Peristiwa perubahan rute (route_change_event)

Objek ini mencatat perbedaan jumlah hop atau urutan alamat IP yang diketahui antara traceroute yang berurutan.

Kolom Jenis Deskripsi
previous_route_change_time timestamp Stempel waktu traceroute yang pertama kali mendeteksi rute sebelumnya.
protocol string Protokol yang digunakan untuk traceroute (seperti TCP, UDP, dan ICMP).
hop_count int32 Jumlah total hop dalam rute.
target_ip string Alamat IP target traceroute.
route_changes array objek Array dari semua perubahan yang terdeteksi. Setiap objek berisi string route_change_type dan objek details. Lihat Detail perubahan rute.

Detail perubahan rute

Objek details di dalam array route_changes bergantung pada route_change_type:

  • incomplete_route atau complete_route
    • terminal_hop (objek hop): Hop terakhir yang berhasil dijangkau (atau hop terakhir jika selesai).
    • terminal_network (objek jaringan): Informasi jaringan untuk hop terminal.
  • route_loop
    • first_hop (objek hop): Hop pertama dalam loop rute yang terdeteksi.
    • last_hop (objek hop): Hop terakhir dalam loop rute yang terdeteksi.
    • loop_span (int32): Jumlah hop yang terlibat dalam loop.
  • target_ip_change
    • previous_target_ip (string): Alamat IP target yang diamati dalam traceroute sebelumnya.
    • new_target_ip (string): Alamat IP target saat ini.
  • sequence_change
    • last_common_hop (objek hop): Hop umum terakhir antara traceroute sebelumnya dan saat ini.
    • previous_next_hop (objek hop): Perangkat next-hop sebelumnya dalam urutan.
    • new_next_hop (objek hop): Perangkat next-hop baru dalam urutan.
    • previous_hop_count (int32): Jumlah total hop di traceroute sebelumnya.
    • hop_count (int32): Jumlah total hop dalam traceroute saat ini.
  • network_change
    • previous_asns (array int32): Urutan Jaringan ASN untuk jalur.
    • new_asns (array int32): Urutan baru Jaringan ASN untuk jalur.
  • isp_change
    • previous_isp (objek jaringan): ISP yang diamati dalam traceroute sebelumnya.
    • new_isp (objek jaringan): ISP saat ini yang diamati.

Sub-objek umum

Objek hop dan jaringan ditampilkan untuk beberapa kolom.

Hop

Objek hop menjelaskan hop jaringan tertentu.

Kolom Jenis Deskripsi
hop_number int32 Nomor hop di traceroute.
ip_address string Alamat IP hop.
hostname string Nama host yang di-resolve untuk alamat IP hop.

Jaringan

Objek jaringan menjelaskan jaringan tempat tindakan terjadi.

Kolom Jenis Deskripsi
asn int32 Nomor Sistem Otonom (ASN) jaringan.
display_name string Nama jaringan (seperti nama ISP atau nama organisasi).

Struktur item umum

Kolom item dalam jsonPayload log Alarm dan log peristiwa berisi detail tentang entitas terkait. Strukturnya bergantung pada jenis item.

NetworkPathItem

Kolom Jenis Deskripsi
destination string Alamat IP atau nama host tujuan.
destination_monitoring_point MonitoringPointItem Detail MonitoringPointItem tujuan (hanya untuk jalur MonitoringPoint-ke-MonitoringPoint).
display_name string Nama tampilan yang ditentukan pengguna untuk Jalur Jaringan.
monitoring_policy_display_name string Nama tampilan kebijakan pemantauan.
monitoring_policy_id string ID kebijakan pemantauan.
network_protocol string Protokol jaringan yang digunakan, seperti TCP, UDP, atau ICMP.
provider_tags array objek Tag yang ditentukan di AppNeta untuk jalur.
source_monitoring_point MonitoringPointItem Detail MonitoringPointItem sumber.

WebPathItem

Kolom Jenis Deskripsi
destination string URL tujuan.
display_name string Nama tampilan yang ditentukan pengguna untuk Jalur Web.
monitoring_policy_display_name string Nama tampilan kebijakan pemantauan.
monitoring_policy_id string ID kebijakan pemantauan.
provider_tags array Tag yang ditentukan di penyedia untuk jalur.
source_monitoring_point objek Detail MonitoringPoint sumber.

MonitoringPointItem

Kolom Jenis Deskripsi
display_name string Nama tampilan Monitoring Point yang ditentukan pengguna.
host objek Detail host Titik Pemantauan.
id string ID unik Titik Pemantauan.
provider_tags array Tag yang ditentukan di penyedia untuk Titik Pemantauan.

MonitoringPointHost

Kolom Jenis Deskripsi
cloud_instance_id string ID instance dari penyedia cloud.
cloud_project_id string Project ID Google Cloud .
cloud_provider string Penyedia Cloud seperti GCP, AWS, atau AZURE.
cloud_region string Region cloud endpoint, misalnya, us-central1.
cloud_virtual_network_ids array string ID jaringan virtual cloud yang terlihat oleh pengguna.
cloud_zone string Zona cloud endpoint, misalnya, us-central1-a.
labels map Label yang ditentukan pengguna yang dikonfigurasi pada instance VM.
os string Sistem operasi host Titik Pemantauan.