Melihat log peristiwa keanggotaan grup multicast

Halaman ini memberikan informasi tentang log yang tersedia untuk memantau peristiwa keanggotaan grup multicast, seperti bergabung dengan IGMP, dan menjelaskan cara mengaktifkan dan melihatnya.

Anda dapat menggunakan log ini untuk membantu Anda memahami aktivitas dalam grup multicast, seperti saat konsumen multicast bergabung dan saat mereka keluar, atau jumlah konsumen multicast dalam grup.

Tentang log peristiwa keanggotaan grup

Google Cloud menulis log peristiwa keanggotaan grup untuk multicast ke Cloud Logging.

Tabel ini memberikan ringkasan log yang tersedia untuk setiap jenis resource, termasuk project yang menerima log. Untuk mengetahui informasi selengkapnya tentang peristiwa yang dicatat dan format log, lihat bagian berikut.

Resource Deskripsi log
Rentang grup multicast

Log peristiwa keanggotaan grup untuk semua konsumen multicast dari rentang grup.

Log ini hanya tersedia di project administrator multicast.

Anda dapat mengonfigurasi logging pada rentang grup multicast global dan aktivasi rentang grup multicast zonal. Lihat Mengaktifkan logging untuk rentang grup multicast.
Aktivasi konsumen grup multicast

Log peristiwa keanggotaan grup untuk konsumen multicast di jaringan VPC konsumen multicast tertentu yang diaktifkan untuk rentang grup dan zona.

Log ini tersedia di project yang berisi resource konsumen multicast, yang dapat berupa project administrator multicast atau project konsumen multicast terpisah, bergantung pada topologi domain multicast.

Lihat Mengaktifkan logging untuk aktivasi konsumen grup multicast.

Peristiwa yang dicatat dalam log

Bagian ini menjelaskan peristiwa keanggotaan grup yang dicatat untuk multicast di Cloud Logging.

Saat konsumen multicast mengirim laporan keanggotaan IGMP untuk bergabung dengan grup, pesan log yang dihasilkan adalah sebagai berikut:

  • Bergabung dengan IGMP yang berhasil akan menghasilkan dua pesan log: pesan IGMP join request received yang diikuti dengan IGMP consumer joined.
  • Bergabung dengan IGMP yang gagal akan menghasilkan dua pesan log: pesan IGMP join request received yang diikuti dengan IGMP join request rejected due to *.
  • Untuk konsumen multicast yang telah berhasil bergabung ke grup, permintaan bergabung IGMP keepalive menghasilkan satu pesan IGMP join request received.

Untuk mengetahui daftar lengkap peristiwa yang dicatat ke dalam log dan deskripsinya, lihat tabel berikut.

Acara Deskripsi
IGMP join request received

Bidang kontrol Google Cloud menerima permintaan bergabung. Pesan ini tidak mengonfirmasi bahwa proses bergabung telah berhasil diselesaikan.

Setiap permintaan bergabung dicatat, termasuk permintaan tetap aktif yang dikirim konsumen multicast secara berkala sebagai bagian dari protokol IGMP.
IGMP consumer joined

Bidang kontrol Google Cloud berhasil menambahkan konsumen multicast ke grup. Setelah peristiwa ini disebarkan ke infrastruktur multicast untuk domain, konsumen multicast mulai menerima traffic multicast.

Peristiwa ini selalu didahului oleh peristiwa IGMP join request received.
IGMP consumer left

Bidang kontrol Google Cloud menerima permintaan keluar IGMP eksplisit dari konsumen multicast dan menerapkan permintaan tersebut.
IGMP consumer timed out

Bidang kontrol Google Cloud menghapus konsumen multicast dari grup karena konsumen multicast berhenti merespons dengan permintaan keep-alive.
Consumer removed due to configuration change

Bidang Google Cloud kontrol menghapus konsumen multicast dari grup karena endpoint konsumen dihapus. Misalnya, instance atau project konsumen mungkin telah dihapus.
IGMP join request rejected due to full tree

Bidang kontrol Google Cloud menerima permintaan bergabung, tetapi menolak permintaan karena grup multicast sudah mencapai kapasitas penuh.
IGMP join request rejected due to missing quota

Google Cloud Control plane menerima permintaan bergabung, tetapi menolak permintaan karena jaringan VPC konsumen multicast sudah menggunakan semua kuotanya untuk VM konsumen multicast per jaringan VPC.
IGMP join request rejected due to unknown reason

Bidang kontrol Google Cloud menerima permintaan bergabung, tetapi menolak permintaan karena kegagalan yang tidak memiliki alasan khusus.
IGMP entitlement rejected

Bidang Google Cloud kontrol menerima permintaan bergabung, tetapi menolak permintaan karena konfigurasi konsumen multicast yang diperlukan belum selesai, seperti dalam kasus berikut:

  • Konfigurasi jaringan VPC konsumen multicast belum selesai.
  • Konfigurasi jaringan VPC konsumen multicast belum disebarkan ke infrastruktur multicast untuk domain.
  • Konsumen multicast tidak dikonfigurasi untuk IGMP.

Peristiwa ini hanya tersedia di log untuk resource aktivasi konsumen grup multicast.
Consumer network activated

Jaringan VPC konsumen multicast diaktifkan untuk rentang grup multicast. Hal ini sesuai dengan pembuatan resource aktivasi konsumen grup multicast.

Peristiwa ini hanya tersedia untuk administrator multicast di log untuk resource rentang grup multicast.
Consumer network deactivated

Jaringan VPC konsumen multicast dinonaktifkan untuk rentang grup multicast. Hal ini berarti resource aktivasi konsumen grup multicast dihapus atau statusnya diubah menjadi INACTIVE.

Peristiwa ini hanya tersedia untuk administrator multicast di log untuk resource rentang grup multicast.

Format log untuk rentang grup multicast

Bagian ini menjelaskan format log peristiwa keanggotaan grup yang tersedia di project administrator multicast yang berisi resource rentang grup dan domain multicast.

Log ini ditulis untuk peristiwa keanggotaan bagi semua konsumen multicast dari rentang grup multicast tertentu. Anda dapat mengonfigurasi logging pada resource aktivasi rentang grup multicast global dan rentang grup multicast zonal seperti yang dijelaskan dalam Mengaktifkan logging untuk rentang grup multicast.

Jenis resource yang dimonitor dan nama log Cloud Logging adalah sebagai berikut:

  • Jenis resource: networkservices.googleapis.com/MulticastGroupRange
  • Nama log: networkservices.googleapis.com%2Fmulticast_memberships

Format log berbeda-beda, bergantung pada jenis peristiwa yang dicatat dalam log. Lihat tabel di setiap tab berikut untuk mengetahui detailnya.

Peristiwa IGMP

Jika peristiwa yang dicatat adalah peristiwa IGMP, log akan mencakup kolom berikut:

Kolom Jenis Deskripsi
consumerIp string Alamat IPv4 internal utama konsumen multicast. Contoh: 10.0.0.1.
consumerLocation string Zona VPC konsumen multicast. Contoh: us-east5-a.
consumerNetwork Resource Jaringan VPC konsumen multicast. Hanya ID bilangan bulat yang diisi. Contoh: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Project Project yang berisi jaringan VPC konsumen multicast. Hanya nomor project yang diisi. Contoh: 
      consumerProject {
       number: "5678"
      }
consumerResource Resource Instance VM konsumen multicast. Hanya ID bilangan bulat yang diisi. Contoh: 
      consumerResource {
       id: "1111"
      }
consumerResourceProject Project Project yang berisi instance VM konsumen multicast. Ini dapat berbeda dengan project yang berisi jaringan VPC konsumen multicast, seperti saat menggunakan VPC Bersama. Hanya nomor project yang diisi. Contoh: 
      consumerResourceProject {
       number: "4321"
      }
eventDescription string Salah satu peristiwa yang dijelaskan dalam Peristiwa yang dicatat. Contoh: IGMP consumer joined.
eventTime string Stempel waktu peristiwa dalam format teks RFC 3339. Contoh: 2024-10-21T06:46:42.990162973Z.
multicastDomain string Nama domain multicast. Contoh: my-domain-name.
multicastGroupRange string Nama rentang grup multicast. Contoh: my-group-range-name.
multicastIp string Alamat IP grup multicast. Contoh: 224.0.0.1.

Pengaktifan/penonaktifan

Jika peristiwa yang dicatat adalah aktivasi atau penonaktifan jaringan VPC konsumen multicast, log mencakup kolom berikut:

Kolom Jenis Deskripsi
consumerLocation string Zona tempat jaringan VPC konsumen multicast diaktifkan. Contoh: us-east5-a.
consumerNetwork Resource Jaringan VPC konsumen multicast. Hanya ID bilangan bulat yang diisi. Contoh: 
      consumerNetwork {
       id: "1234"
      }
consumerProject Project Project yang berisi jaringan VPC konsumen multicast. Hanya nomor project yang diisi. Contoh: 
      consumerProject {
       number: "5678"
      }
eventDescription string Salah satu peristiwa yang dijelaskan dalam Peristiwa yang dicatat. Contoh: Consumer network activated.
eventTime string Stempel waktu peristiwa dalam format teks RFC 3339. Contoh: 2024-10-21T06:46:42.990162973Z.
multicastDomain string Nama domain multicast. Contoh: my-domain-name.
multicastGroupRange string Nama rentang grup multicast. Contoh: my-group-range-name

ID bilangan bulat digunakan untuk resource konsumen multicast, seperti project, jaringan, dan instance, untuk menjaga privasi.

Format log untuk aktivasi konsumen grup multicast

Bagian ini menjelaskan format log peristiwa keanggotaan grup yang tersedia di project yang berisi resource konsumen multicast. Project dapat berupa project administrator multicast, atau project konsumen multicast terpisah, bergantung pada topologi domain multicast.

Log ini ditulis untuk peristiwa keanggotaan bagi konsumen multicast di jaringan VPC tertentu yang diaktifkan untuk rentang grup dan zona multicast. Anda dapat mengonfigurasi logging pada resource aktivasi konsumen grup multicast zonal seperti yang dijelaskan dalam Mengaktifkan logging untuk aktivasi konsumen grup multicast.

Jenis resource yang dimonitor dan nama log Cloud Logging adalah sebagai berikut:

  • Jenis resource: networkservices.googleapis.com/MulticastGroupConsumerActivation
  • Nama log: networkservices.googleapis.com%2Fmulticast_memberships

Log ini mencakup kolom berikut:

Kolom Jenis Deskripsi
consumerIp string Alamat IPv4 internal utama konsumen multicast. Contoh: 10.0.0.1.
consumerLocation string Zona konsumen multicast. Contoh: us-east5-a.
consumerNetwork Resource Jaringan VPC konsumen multicast. Contoh: 
        consumerNetwork {
          name: "my-network"
          id: "1234"
        }
consumerProject Project Project yang berisi jaringan VPC konsumen multicast. Contoh: 
        consumerProject {
          id: "my-project"
          number: "5678"
        }
consumerResource Resource Instance VM konsumen multicast. Contoh: 
        consumerResource {
          name: "my-instance"
          id: "1111"
        }
consumerResourceProject Project Project yang berisi instance VM konsumen multicast. Ini dapat berbeda dengan project yang berisi jaringan VPC konsumen multicast, seperti saat menggunakan VPC Bersama. Contoh: 
        consumerResourceProject {
          id: "my-instance-project"
          number: "4321"
        }
eventDescription string Salah satu peristiwa yang dijelaskan dalam Peristiwa yang dicatat. Contoh: IGMP consumer joined.
eventTime string Stempel waktu peristiwa dalam format teks RFC 3339. Contoh: 2024-10-21T06:46:42.990162973Z.
multicastConsumerAssociation string Nama pengaitan konsumen multicast antara jaringan VPC konsumen multicast dan domain. Contoh: my-consumer-association-name.
multicastGroupConsumerActivation string Nama aktivasi konsumen grup multicast. Contoh: my-group-consumer-activation-name.
multicastIp string Alamat IP grup multicast. Contoh: 224.0.0.1.

Tidak seperti log rentang grup multicast, log aktivasi konsumen grup multicast menggunakan ID string untuk project dan jaringan karena log hanya tersedia untuk project yang berisi resource konsumen multicast.

Referensi format kolom

Project

Kolom Jenis Deskripsi
number string (uint64) ID bilangan bulat project yang dibuat secara otomatis. Contoh: 5678.
id string ID project yang ditetapkan pengguna. Contoh: my-project.

Resource

Kolom Jenis Deskripsi
id string (uint64) ID bilangan bulat resource yang dibuat secara otomatis. Contoh: 1111.
name string Nama yang ditetapkan pengguna untuk resource. Contoh: my-instance.

Mengaktifkan logging peristiwa keanggotaan grup

Bagian berikut menjelaskan cara mengaktifkan logging peristiwa keanggotaan grup untuk rentang grup multicast atau jaringan VPC konsumen multicast tertentu.

Mengaktifkan logging untuk rentang grup multicast

Bagian ini menjelaskan cara administrator multicast dapat mengonfigurasi pencatatan peristiwa keanggotaan grup untuk rentang grup multicast yang ada.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi logging saat membuat rentang grup multicast baru, lihat Membuat rentang grup multicast. Logging peristiwa keanggotaan tidak diaktifkan secara default.

Anda dapat mengonfigurasi logging peristiwa keanggotaan di kedua resource berikut:

  • Rentang grup multicast: Konfigurasi logging rentang grup global berlaku untuk semua aktivasi rentang grup.
  • Aktivasi rentang grup multicast: Konfigurasi logging aktivasi rentang grup zonal menggantikan konfigurasi rentang grup global.

gcloud

  • Untuk mengaktifkan atau menonaktifkan logging untuk rentang grup multicast, gunakan perintah network-services multicast-group-ranges update.

    gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
    --location=global \
    [--enable-logging | --no-enable-logging]

    Ganti kode berikut:

    • GROUP_RANGE_NAME: nama rentang grup multicast
    • --[no-]enable-logging: menentukan apakah logging peristiwa keanggotaan diaktifkan.
      • Untuk mengaktifkan logging, gunakan --enable-logging.
      • Untuk menonaktifkan logging, gunakan --no-enable-logging.

  • Untuk mengaktifkan atau menonaktifkan logging untuk aktivasi rentang grup multicast, gunakan perintah network-services multicast-group-range-activations update.

    gcloud network-services multicast-group-range-activations update GROUP_RANGE_ACTIVATION_NAME \
    --location=ZONE \
    [--enable-logging | --no-enable-logging]

    Ganti kode berikut:

    • GROUP_RANGE_ACTIVATION_NAME: nama aktivasi rentang grup multicast
    • ZONE: zona aktivasi rentang grup multicast
    • --[no-]enable-logging: menentukan apakah logging peristiwa keanggotaan diaktifkan.
      • Untuk mengaktifkan logging, gunakan --enable-logging.
      • Untuk menonaktifkan logging, gunakan --no-enable-logging.

API

  • Untuk mengaktifkan atau menonaktifkan logging untuk rentang grup multicast, gunakan metode multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    Ganti kode berikut:

    • PROJECT_ID: ID project
    • GROUP_RANGE_NAME: nama rentang grup multicast
    • LOGGING_ENABLED: menentukan apakah logging peristiwa keanggotaan diaktifkan.
      • Untuk mengaktifkan logging, tetapkan ke true.
      • Untuk menonaktifkan logging, tetapkan ke false.

  • Untuk mengaktifkan atau menonaktifkan logging untuk aktivasi rentang grup multicast, gunakan metode multicastGroupRangeActivations.patch.

    PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/ZONE/multicastGroupRangeActivations/GROUP_RANGE_ACTIVATION_NAME?updateMask=logConfig
{
  "logConfig": {"enabled": "LOGGING_ENABLED"}
}

    Ganti kode berikut:

    • PROJECT_ID: ID project
    • GROUP_RANGE_ACTIVATION_NAME: nama aktivasi rentang grup multicast
    • ZONE: zona aktivasi rentang grup multicast
    • LOGGING_ENABLED: menentukan apakah logging peristiwa keanggotaan diaktifkan.
      • Untuk mengaktifkan logging, tetapkan ke true.
      • Untuk menonaktifkan logging, tetapkan ke false.

Mengaktifkan logging untuk aktivasi konsumen grup multicast

Bagian ini menjelaskan cara administrator jaringan konsumen multicast dapat mengonfigurasi pencatatan peristiwa keanggotaan grup untuk jaringan VPC mereka.

Untuk jaringan VPC tertentu yang Anda izinkan untuk menggunakan traffic multicast, Anda dapat mengonfigurasi pencatatan peristiwa keanggotaan pada aktivasi konsumen grup multicast yang sesuai.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi logging saat membuat aktivasi konsumen grup multicast baru, lihat Mengizinkan jaringan VPC menggunakan traffic multicast. Logging peristiwa keanggotaan tidak diaktifkan secara default.

gcloud

Untuk mengaktifkan atau menonaktifkan logging untuk aktivasi konsumen grup multicast, gunakan perintah network-services multicast-group-consumer-activations update.

  gcloud network-services multicast-group-consumer-activations update GROUP_CONSUMER_ACTIVATION_NAME \
      --location=ZONE \
      [--enable-logging | --no-enable-logging]

Ganti kode berikut:

  • GROUP_CONSUMER_ACTIVATION_NAME: nama aktivasi konsumen grup multicast
  • ZONE: zona aktivasi konsumen grup multicast
  • --[no-]enable-logging: menentukan apakah logging peristiwa keanggotaan diaktifkan.
    • Untuk mengaktifkan logging, gunakan --enable-logging.
    • Untuk menonaktifkan logging, gunakan --no-enable-logging.

API

Untuk mengaktifkan atau menonaktifkan logging untuk aktivasi konsumen grup multicast, gunakan metode multicastGroupConsumerActivations.patch.

  PATCH https://networkservices.googleapis.com/v1beta1/projects/PROJECT_ID/locations/ZONE/multicastGroupConsumerActivations/GROUP_CONSUMER_ACTIVATION_NAME?updateMask=logConfig
  {
    "logConfig": {"enabled": "LOGGING_ENABLED"}
  }

Ganti kode berikut:

  • PROJECT_ID: ID project
  • GROUP_CONSUMER_ACTIVATION_NAME: nama aktivasi konsumen grup multicast
  • ZONE: zona aktivasi konsumen grup multicast
  • LOGGING_ENABLED: menentukan apakah logging peristiwa keanggotaan diaktifkan.
    • Untuk mengaktifkan logging, tetapkan ke true.
    • Untuk menonaktifkan logging, tetapkan ke false.

Melihat log peristiwa keanggotaan grup

Bagian ini menjelaskan cara melihat log peristiwa keanggotaan grup untuk multicast.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Logs Explorer.

Konsol

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

    Buka Logs Explorer

  2. Untuk melihat log peristiwa keanggotaan grup multicast, pilih salah satu jenis resource yang dipantau berikut dari daftar Semua resource:

    • Jika Anda adalah administrator multicast dan ingin melihat log peristiwa keanggotaan grup untuk semua konsumen multicast dalam grup, pilih Rentang Grup Multicast.
    • Jika Anda adalah administrator jaringan VPC konsumen multicast dan ingin melihat log peristiwa keanggotaan grup untuk jaringan Anda, pilih Aktivasi Konsumen Grup Multicast.

Langkah berikutnya