Melihat log agen di Azure Kubernetes Fleet Manager

2025-06-17

Artikel ini menunjukkan cara memeriksa log agen Armada dari kluster hub dan anggota di Azure Kubernetes Fleet Manager. Jika Anda memiliki Armada dengan mode kluster hub yang diaktifkan, Azure Kubernetes Fleet Manager menginstal agen Armada di kluster hub dan kluster anggota untuk memfasilitasi komunikasi dan mengatur operasi di seluruh Armada, untuk mendukung orkestrasi beban kerja Armada dan kemampuan penyeimbangan beban. Agen ini menghasilkan log yang memberikan wawasan tentang:

Status kesehatan dan konektivitas agen
Perubahan konfigurasi orkestrasi beban kerja dan pembaruan operasi
Perubahan konfigurasi penyeimbangan beban dan pembaruan operasi

Dan Anda dapat mengambil log ini untuk tujuan pemantauan, pemecahan masalah, dan/atau audit.

Mengonfigurasi pengaturan diagnostik pada sumber daya yang relevan

Log agen armada diimplementasikan sebagai log sumber daya di Azure Monitor, khususnya:

Log agen Armada yang terkait dengan klaster Armada hub diimplementasikan sebagai bagian dari log sumber daya untuk sumber daya Armada.
- Dua agen dipasang pada kluster hub Armada, umumnya dikenal sebagai agen hub Armada, yang meliputi:
  - fleet-hub-agent: agen Armada yang mengelola keanggotaan kluster dan memproses tugas orkestrasi beban kerja di sisi kluster hub (misalnya, penjadwalan, meluncurkan perubahan).
  - fleet-hub-net-controller-manager: agen Armada yang memproses tugas penyeimbangan beban di sisi kluster hub.
Log agen armada untuk kluster anggota Armada diimplementasikan sebagai bagian dari log sumber daya untuk sumber daya kluster AKS.
- Tiga agen dipasang pada kluster anggota Armada, umumnya dikenal sebagai agen anggota Armada, yang meliputi:
  - fleet-member-agent: agen Armada yang mendaftarkan kluster anggota ke kluster hub dan memproses tugas orkestrasi beban kerja di sisi kluster anggota (misalnya, menerapkan manifes, deteksi penyimpangan, pengambilalihan).
  - fleet-member-net-controller-manager: agen Armada yang memproses tugas penyeimbangan beban di sisi kluster anggota.
  - fleet-mcs-controller-manager: agen Armada yang memfasilitasi layanan multi-kluster.

Log sumber daya tidak akan dikumpulkan dan disimpan hingga Anda membuat pengaturan diagnostik untuk mengarahkannya ke satu atau lebih lokasi. Azure Monitor mendukung berbagai lokasi yang dapat Anda gunakan, seperti akun penyimpanan Azure atau ruang kerja Analitik Log; untuk daftar lokasi yang tersedia dan batasannya, lihat halaman Tujuan Pengaturan Diagnostik Azure Monitor .

Untuk mengumpulkan log agen Armada, buat pengaturan diagnostik untuk sumber daya yang sesuai. Tergantung pada kasus penggunaan Armada Anda, Anda dapat memilih untuk mengumpulkan log dari satu atau beberapa agen Armada tertentu saja. Pendekatan yang paling mudah adalah menggunakan portal Microsoft Azure; lihat langkah-langkah untuk instruksi lebih lanjut. Anda juga dapat menggunakan Azure CLI, PowerShell, Azure Resource Manager, REST API, atau Azure Policy untuk menyiapkan hal-hal; untuk informasi selengkapnya, lihat Membuat Pengaturan Diagnostik.

Penting

Mungkin ada biaya besar saat mengumpulkan log agen Armada. Disarankan agar Anda

mengumpulkan log hanya dari agen Armada yang paling relevan
baca dokumen Pengoptimalan biaya dan Azure Monitor untuk strategi guna mengurangi biaya pemantauan Anda.

Mengonfigurasi pengaturan diagnostik pada sumber daya Armada untuk log agen pusat Armada

Masuk ke portal Azure.
Di kotak pencarian, masukkan Kubernetes Fleet Manager dan pilih Kubernetes Fleet Manager dari hasil pencarian.
Dalam daftar semua sumber daya Armada, temukan Armada dari mana Anda ingin mengumpulkan log agen pusat Armada. Klik nama Armada. Anda mungkin perlu menyesuaikan kondisi filter untuk menemukan sumber daya Armada yang Anda inginkan.
Pilih Pengaturan diagnostik di bawah Pemantauan pada menu sumber daya.
Pilih Tambahkan pengaturan diagnostik.
Masukkan nama untuk pengaturan diagnostik.
Untuk kategori log, pastikan bahwa setidaknya salah satu dari dua kategori, fleet-hub-agent dan fleet-hub-net-controller-manager, dipilih. Anda juga dapat memilih kategori log lain sesuai kebutuhan.
Untuk detail tujuan, pilih tujuan yang Anda inginkan. Opsi lainnya muncul yang meminta informasi tujuan tambahan kepada Anda. Untuk informasi selengkapnya, lihat Membuat Pengaturan Diagnostik.
Pilih Simpan.

Setelah beberapa saat, pengaturan baru muncul di daftar pengaturan diagnostik Anda untuk sumber daya ini. Log dialirkan ke tujuan yang ditentukan saat data baru dihasilkan. Mungkin diperlukan beberapa saat antara ketika agen mengirim log dan ketika log tersebut muncul di tujuan pilihan Anda.

Mengonfigurasi pengaturan diagnostik pada sumber daya kluster AKS anggota untuk log agen anggota Armada

Masuk ke portal Azure.
Di kotak pencarian, masukkan Layanan Kubernetes dan pilih Layanan Kubernetes dari hasil pencarian.
Dalam daftar semua sumber daya kluster AKS, temukan kluster AKS yang telah Anda gabungkan ke Armada Anda sebagai kluster anggota dan dari mana Anda ingin mengumpulkan log agen anggota Armada. Klik pada nama kluster AKS. Anda mungkin perlu menyesuaikan kondisi filter untuk menemukan sumber daya kluster AKS yang Anda inginkan.
Pilih Pengaturan diagnostik di bawah Pemantauan pada menu sumber daya.
Pilih Tambahkan pengaturan diagnostik.
Masukkan nama untuk pengaturan diagnostik.
Untuk kategori log, pastikan bahwa setidaknya salah satu dari tiga kategori, , fleet-member-agent, fleet-member-net-controller-managerdan fleet-mcs-controller-manager, dipilih. Anda juga dapat memilih kategori log lain sesuai kebutuhan.
Untuk detail tujuan, pilih tujuan yang Anda inginkan. Opsi lainnya muncul yang meminta informasi tujuan lainnya kepada Anda. Untuk informasi selengkapnya, lihat Membuat Pengaturan Diagnostik. Jika Anda berencana menggunakan ruang kerja Analitik Log sebagai tujuan, sumber daya kluster AKS mendukung mode Diagnostik Azure dan mode khusus sumber daya. Untuk perbedaan antara dua mode, lihat penjelasan di halaman Kirim ke Ruang Kerja Log Analytics.
Pilih Simpan.

Setelah beberapa saat, pengaturan baru muncul di daftar pengaturan diagnostik Anda untuk sumber daya ini. Log dialirkan ke tujuan yang ditentukan saat data baru dihasilkan. Mungkin perlu waktu cukup lama antara ketika agen memancarkan log dan ketika muncul di tujuan pilihan Anda.

Melihat log agen Armada

Untuk melihat log agen Armada di tujuan pilihan Anda, lihat Mengirim log sumber daya Azure ke ruang kerja Analitik Log, Azure Event Hubs, atau Azure Storage.

Nota

Jika Anda menggunakan ruang kerja Analitik Log sebagai tujuan:

dengan mode Diagnostik Azure, log agen anggota Armada dapat ditemukan dalam tabel AzureDiagnostics.
dengan mode khusus sumber daya, log agen anggota Armada dapat ditemukan di tabel AKSControlPlane.

Memahami log agen Armada

Log agen armada ditulis dalam klog format yang tidak terstruktur; formatnya adalah

[IWEF]yyyymmdd hh:mm:ss.uuuuuu threadid file:line msg kvs

Lokasi:

[IWEF] adalah tingkat log.
- I mewakili tingkat info.
- W mewakili tingkat warning.
- E mewakili tingkat error.
- F mewakili tingkat fatal.
yyyymmdd adalah tahun (yyyy), bulan (mm), dan hari (dd) ketika log dipancarkan.
hh:mm:ss.uuuuuu adalah tanda waktu (hh selama berjam-jam, mm selama menit, ss untuk detik, dan uuuuuu untuk mikrodetik) ketika log dipancarkan.
threadid adalah ID utas (PID/TID) dari proses/utas agen Armada.
file:line adalah nama file dan nomor baris kode sumber yang memancarkan log.
msg adalah pesan log.
kvs adalah daftar pasangan kunci-nilai (misalnya, work=123) yang menyediakan informasi tambahan, seperti objek API yang melibatkan pesan log.

Anda mungkin ingin membandingkan pesan log dengan kode sumber agen Armada untuk lebih memahami pesan log dalam konteksnya. Untuk agen fleet-hub-agent Fleet dan fleet-member-agent, lihat repositori GitHub KubeFleet; untuk fleet-hub-net-controller-manager, fleet-member-net-controller-manager, dan fleet-mcs-controller-manager, lihat repositori GitHub Azure Fleet Networking.

Kueri Kusto yang berguna

Daftar kueri Kusto berikut yang mungkin membantu Anda mencari log agen Armada dengan lebih mudah di ruang kerja Analitik Log:

Nota

Contoh mengasumsikan bahwa Anda menggunakan mode Diagnostik Azure saat mengumpulkan log agen anggota Armada. Jika Anda mengaktifkan mode khusus sumber daya, gunakan AKSControlPlane tabel sebagai gantinya untuk contoh kueri yang berlaku.

Ambil 1.000 entri log terbaru dari semua agen hub Armada.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category in ("fleet-hub-agent", "fleet-hub-net-controller-manager")
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru dari semua agen anggota Armada.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category in ("fleet-member-agent", "fleet-member-net-controller-manager", "fleet-mcs-controller-manager")
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada mengelola keanggotaan kluster di sisi kluster hub.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "v1beta1/member_controller.go"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada memproses ClusterResourcePlacement objek API.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "clusterresourceplacement/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada menjadwalkan beban kerja.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "scheduler/" or log_s contains "framework/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada memproses pembaruan bergulir.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "rollout/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada memproses pembaruan bertahap.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "updaterun/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang bagaimana Armada menyinkronkan beban kerja ke kluster anggota.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "workgenerator/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang bagaimana Fleet melaporkan keanggotaan kluster dari sisi kluster anggota.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-agent"
| where log_s contains "v1beta1/member_controller.go"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang bagaimana Armada menerapkan manifes ke kluster anggota tertentu.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-agent"
| where log_s contains "workapplier/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Fleet mengelola ekspor/impor endpoint untuk kapabilitas jaringan di sisi kluster hub.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-net-controller-manager"
| where log_s contains "endpointsliceexport/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada mengelola ekspor/impor layanan untuk kemampuan jaringan di sisi kluster hub.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-net-controller-manager"
| where log_s contains "serviceimport/" or log_s contains "internalserviceimport/" or log_s contains "internalserviceexport/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada mengelola sumber daya terkait Azure Traffic Manager untuk kemampuan jaringan.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-net-controller-manager"
| where log_s contains "trafficmanagerbackend/" or log_s contains "trafficmanagerprofile/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang bagaimana Fleet mengelola ekspor/impor endpoint untuk kapabilitas jaringan di sisi member cluster.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-net-controller-manager"
| where log_s contains "endpointslice/" or log_s contains "endpointsliceexport/" or log_s contains "endpointsliceimport/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Fleet mengelola ekspor/impor layanan untuk kemampuan jaringan di sisi kluster anggota.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-net-controller-manager"
| where log_s contains "serviceexport/" or log_s contains "serviceimport/"
| order by TimeGenerated desc
| take 1000

Ambil 1.000 entri log terbaru tentang cara Armada mengelola layanan multi-kluster untuk kemampuan jaringan.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-mcs-controller-manager"
| where log_s contains "multiclusterservice/"
| order by TimeGenerated desc
| take 1000