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 pembuatan kebijakan pemberitahuan.

Tugas pencatatan log dan pemberitahuan dibagi antara Google Cloud dan AppNeta. Pencatatan log Cloud Network Insights melacak saat 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. Kemudian, 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 akan memberi tahu Anda jika ada masalah di jaringan Anda. Jika metrik yang Anda lacak, seperti latensi, melampaui batas yang ditetapkan dalam interval tertentu, hal tersebut merupakan pelanggaran aturan pemberitahuan. Anda dapat memilih untuk memicu alarm setelah satu pelanggaran atau setelah beberapa pelanggaran selama interval yang ditetapkan.

Misalnya, jika latensi melebihi 160 md 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 mengirimkan 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

Buat aturan alarm yang menentukan batas performa.

  1. Buka konsol Google Cloud , lalu buka Network Intelligence > Cloud Network Insights > Alert Policies.

    Buka Kebijakan Pemberitahuan

  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.

Melihat 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. Buat kueri untuk mendapatkan pemberitahuan tentang informasi yang relevan.

Log Cloud Network Insights menggunakan salah satu opsi berikut untuk logName:

  • 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 mengkueri dan memahami log.

Log alarm

  • Nama Log: networkmanagement.googleapis.com/insights_alarm
  • Dipicu: Dibuat saat kondisi aturan alarm terpenuhi.
  • Label Resource: Menjelaskan resource yang dipantau yang terkait dengan log. Hal ini mencakup hal berikut:
    • type - Jenis resource, dapat berupa salah satu dari berikut ini:
      • networkmanagement.googleapis.com/NetworkMonitoringProvider
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
    • 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_time timestamp Waktu alarm dimatikan. 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 Entitas yang terkait dengan alarm. Lihat Struktur Item Umum untuk mengetahui detailnya.
provider_link string Hyperlink ke alarm di UI AppNeta.
raised_time timestamp Waktu alarm berbunyi.
receiveTimestamp string Waktu alarm dibuat dalam 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 alarm dibuat di AppNeta.

Log aktivitas

  • Nama Log: networkmanagement.googleapis.com/insights_event
  • Pemicu: Dibuat saat perubahan struktural terjadi (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, atau qos_change_event. Objek kosong akan ditampilkan untuk peristiwa yang tidak memiliki detail lebih lanjut. Lihat Kolom detail acara 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, atau QOS_CHANGE.
item objek Entitas yang terkait dengan peristiwa. Lihat Struktur item umum untuk mengetahui detailnya.
receiveTimestamp string Waktu acara dibuat di Google Cloud.
timestamp string Waktu acara dibuat di AppNeta.

Kolom detail acara

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 merekam detail setiap kali ukuran MTU diubah.

Kolom Jenis Deskripsi
new_mtu int32 MTU yang baru diukur.
previous_mtu int32 MTU sebelumnya, jika ada (dihapus saat startup).

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 perubahan rute (route_change_event)

Objek ini merekam perbedaan jumlah hop atau urutan alamat IP yang diketahui di antara traceroute 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 lompatan dalam rute.
target_ip string Alamat IP target traceroute.
route_changes array objek Array 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 di 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 dalam 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 di 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 Jumlah lompatan 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 Peristiwa berisi detail tentang entity 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 yang ditentukan pengguna untuk Titik Pemantauan.
host objek Detail host Poin 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 Google Cloud Project ID.
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.