Perbaru insight Kontainer untuk mengaktifkan metrik

Artikel
07/27/2022
4 menit untuk membaca

Insight Kontainer saat ini memperkenalkan dukungan untuk mengumpulkan metrik dari Azure Kubernetes Services (AKS) dan node serta pod kluster Kubernetes yang didukung Azure Arc dan menulisnya ke penyimpanan metrik Azure Monitor. Dengan dukungan ini, Anda dapat menyajikan perhitungan agregat tepat waktu (rata-rata, jumlah, maksimum, minimum, jumlah) dalam bagan kinerja, bagan kinerja pin di dasbor portal Microsoft Azure, dan memanfaatkan peringatan metrik.

Catatan

Fitur ini saat ini tidak mendukung kluster Azure Red Hat OpenShift.

Fitur ini memungkinkan skenario berikut:

Namespace layanan metrik	Metrik	Deskripsi
Insights.container/nodes	cpuUsageMillicores, cpuUsagePercentage, memoryRssBytes, memoryRssPercentage, memoryWorkingSetBytes, memoryWorkingSetPercentage, cpuUsageAllocatablePercentage, memoryWorkingSetAllocatablePercentage, memoryRssAllocatablePercentage, nodesCount, diskUsedPercentage,	Sebagai metrik simpul, metrik-metrik ini termasuk host sebagai dimensi. Mereka juga menyertakan nama node sebagai nilai untuk dimensi host.
insights.container/pods	PodCount, menyelesaikanJobsCount, memulai ulangContainerCount, oomKilledContainerCount, podReadyPercentage	Sebagai metrik pod, metrik ini menyertakan yang berikut sebagai dimensi - ControllerName, namespace layanan Kubernetes, nama, fase.
Insights.container/containers	cpuExceededPercentage, memoryRssExceededPercentage, memoryWorkingSetExceededPercentage, cpuThresholdViolated, memoryRssThresholdViolated, memoryWorkingSetThresholdViolated
Insights.container/persistentvolumes	pvUsageExceededPercentage, pvUsageThresholdViolated

Untuk mendukung kemampuan ini, fitur ini mencakup agen kontainer ini:

Versi microsoft/oms:ciprod05262020 untuk AKS
Version microsoft/oms:ciprod09252020 for Azure Arc-enabled Kubernetes clusters

Penerapan baru AKS secara otomatis menyertakan konfigurasi ini dan kemampuan pengumpulan metrik. Anda dapat memperbarui kluster Anda untuk mendukung fitur ini dari portal Microsoft Azure, Azure PowerShell, atau Azure CLI. Dengan Azure PowerShell dan Azure CLI, Anda dapat mengaktifkan fitur untuk setiap kluster atau untuk semua kluster dalam langganan Anda.

Salah satu proses menetapkan peran Penerbit Metrik Pemantauan ke perwakilan layanan kluster atau Pengguna yang ditetapkan MSI untuk add-on pemantauan sehingga data yang dikumpulkan oleh agen dapat diterbitkan ke sumber daya kluster Anda. Data yang dikumpulkan agen dari agen kemudian dapat dipublikasikan ke sumber daya kluster Anda.

Pemantauan Metrik Publisher memiliki izin hanya untuk mendorong metrik ke sumber daya. Itu tidak dapat mengubah status apa pun, memperbarui sumber daya, atau membaca data apa pun. Untuk informasi selengkapnya tentang peran tersebut, lihat peran Penerbit Metrik Pemantauan. Persyaratan peran Penerbit Metrik Pemantauan tidak berlaku untuk kluster Kubernetes yang didukung Azure Arc.

Penting

Kluster Kubernetes yang diaktifkan Azure Arc sudah memiliki versi agen minimum yang diperlukan, sehingga pembaruan tidak diperlukan. Penetapan peran Penerbit Metrik Pemantauan ke prinsipal layanan cluster atau MSI yang ditetapkan pengguna untuk add-on pemantauan terjadi secara otomatis saat Anda menggunakan portal Azure, Azure PowerShell, atau Azure CLI.

Prasyarat

Sebelum Memperbarui kluster, konfirmasikan hal berikut:

Metrik kustom hanya tersedia di subset wilayah Azure. Lihat daftar wilayah yang didukung.
Anda adalah anggota peranPemilik pada sumber daya kluster AKS untuk mengaktifkan pengumpulan metrik performa kustom simpul dan Pod. Persyaratan ini tidak berlaku untuk kluster Kubernetes yang didukung Azure Arc.

Jika Anda memilih untuk menggunakan Azure CLI, pertama-tama Anda perlu menginstal dan menggunakan CLI secara lokal. Anda harus menjalankan Azure CLI versi 2.0.59 atau yang lebih baru. Untuk mengidentifikasi versi Anda, jalankan az --version. Jika Anda perlu memasang atau meningkatkan Azure CLI, lihat Memasang Azure CLI.

Perbarui satu kluster menggunakan portal Microsoft Azure

Untuk memperbarui kluster AKS yang ada yang dipantau oleh wawasan Kontainer:

Pilih cluster untuk melihat kesehatannya dari tampilan multi-cluster di Azure Monitor atau langsung dari cluster dengan memilih Insights dari panel kiri.
Di spanduk yang muncul di bagian atas panel, pilih Aktifkan untuk memulai pembaruan.

Proses ini dapat memakan waktu beberapa detik untuk menyelesaikannya. Anda dapat melacak kemajuannya di bawah Pemberitahuan dari menu.

Memperbarui semua kluster dengan menggunakan Azure CLI

Untuk memperbarui semua kluster dalam langganan Anda dengan menggunakan Bash di Azure CLI, jalankan perintah berikut. Edit nilai untuk subscriptionId menggunakan nilai dari halaman Gambaran Umum AKS untuk kluster AKS.

az login
az account set --subscription "Subscription Name"
curl -sL https://aka.ms/ci-md-onboard-atscale | bash -s subscriptionId

Perubahan konfigurasi dapat memakan waktu beberapa menit hingga selesai. Setelah selesai, pesan seperti yang berikut muncul dan menyertakan hasilnya:

completed role assignments for all AKS clusters in subscription: <subscriptionId>

Perbarui satu kluster menggunakan portal Microsoft Azure

Untuk memperbarui kluster tertentu di langganan Anda menggunakan Azure CLI. Edit nilai untuk subscriptionId, resourceGroupName, dan clusterName menggunakan nilai pada halaman Gambaran umum AKS untuk kluster AKS. Nilai clientIdOfSPN dikembalikan saat Anda menjalankan perintah az aks show.

az login
az account set --subscription "<subscriptionName>"
az aks show -g <resourceGroupName> -n <clusterName> 
az role assignment create --assignee <clientIdOfSPN> --scope <clusterResourceId> --role "Monitoring Metrics Publisher"

Untuk mendapatkan nilai clientIdOfSPNOrMsi, Anda dapat menjalankan perintah az aks show seperti yang ditunjukkan pada contoh di bawah ini. Jika objek servicePrincipalProfile memiliki nilai objectid yang valid, Anda dapat menggunakannya. Jika tidak, jika diatur ke msi, Anda perlu memasukkan ID Objek dari addonProfiles.omsagent.identity.objectId.

az login
az account set --subscription "<subscriptionName>"
az aks show -g <resourceGroupName> -n <clusterName> 
az role assignment create --assignee <clientIdOfSPNOrMsi> --scope <clusterResourceId> --role "Monitoring Metrics Publisher"

Catatan

Jika Anda ingin melakukan penetapan peran dengan akun pengguna Anda, gunakan --assignee parameter seperti yang ditunjukkan dalam contoh. Jika Anda ingin melakukan penetapan peran dengan nama perwakilan layanan (SPN), gunakan --assignee-object-id parameter dan --assignee-principal-type bukan --assignee parameter.

Memperbarui semua kluster menggunakan Azure PowerShell

Untuk memperbarui semua kluster dalam langganan Anda dengan menggunakan Azure PowerShell:

Unduh skrip mdm_onboarding_atscale.ps1 dan simpan ke folder lokal dari repositori GitHub kami.
Jalankan perintah berikut. Edit nilai untuk subscriptionId menggunakan nilai dari halaman Gambaran Umum AKS untuk kluster AKS.
```
.\mdm_onboarding_atscale.ps1 subscriptionId
```
Perubahan konfigurasi dapat memakan waktu beberapa menit hingga selesai. Setelah selesai, pesan seperti yang berikut muncul dan menyertakan hasilnya:
```
Completed adding role assignment for the aks clusters in subscriptionId :<subscriptionId>
```

Perbarui satu kluster dengan menggunakan Azure PowerShell

Untuk memperbarui kluster tertentu dengan menggunakan Azure PowerShell:

Unduh skrip mdm_onboarding_atscale.ps1 dan simpan ke folder lokal dari repositori GitHub kami.
Jalankan perintah berikut. Edit nilai untuk subscriptionId, resourceGroupName, dan clusterName menggunakan nilai pada halaman Gambaran umum AKS untuk kluster AKS.
```
.\mdm_onboarding.ps1 subscriptionId <subscriptionId> resourceGroupName <resourceGroupName> clusterName <clusterName>
```
Perubahan konfigurasi dapat memakan waktu beberapa menit hingga selesai. Setelah selesai, pesan seperti yang berikut muncul dan menyertakan hasilnya:
```
Successfully added Monitoring Metrics Publisher role assignment to cluster : <clusterName>
```

Verifikasi pembaruan

Setelah memulai pembaruan menggunakan salah satu metode yang dijelaskan sebelumnya, Anda dapat menggunakan penjelajah metrik Azure Monitor dan memverifikasi dari namespace layanan Metrik yang dicantumkan oleh insight. Jika ya, Anda dapat melanjutkan dan mulai menyiapkan peringatan metrik atau menyematkan bagan Anda ke dasbor.