Mengunggah metrik ke Azure Monitor

  • Artikel

Secara berkala, Anda dapat mengekspor metrik pemantauan lalu mengunggahnya ke Azure. Ekspor dan pengunggahan data juga membuat dan memperbarui pengontrol data, instans terkelola SQL, dan sumber daya server PostgreSQL di Azure.

Dengan layanan data Azure Arc, Anda dapat mengunggah metrik ke Azure Monitor secara opsional sehingga Anda dapat mengagregasi dan menganalisis metrik, log, meningkatkan pemberitahuan, mengirim notifikasi, atau memicu tindakan otomatis.

Mengirim data Anda ke Azure Monitor juga memungkinkan Anda menyimpan data metrik di luar situs dan dalam skala besar, memungkinkan penyimpanan data jangka panjang untuk analitik tingkat lanjut.

Jika Anda memiliki beberapa situs yang memiliki layanan data Azure Arc, Anda bisa menggunakan Azure Monitor sebagai lokasi pusat untuk mengumpulkan semua log dan metrik di seluruh situs.

Mengunggah metrik untuk pengontrol data Azure Arc dalam mode langsung

Dalam mode terhubung langsung, unggahan metrik hanya dapat disiapkan dalam mode otomatis. Pengunggahan metrik otomatis ini dapat disiapkan baik selama penyebaran pengontrol data Azure Arc atau pasca penyebaran. Identitas terkelola ekstensi layanan data Arc digunakan untuk mengunggah metrik. Identitas terkelola harus memiliki peran Penerbit Metrik Pemantauan yang ditetapkan untuknya.

Catatan

Jika pengunggahan metrik otomatis dinonaktifkan selama penyebaran pengontrol Data Azure Arc, Anda harus terlebih dahulu mengambil identitas terkelola ekstensi pengontrol data Arc dan memberikan peran Penerbit Metrik Pemantauan sebelum mengaktifkan pengunggahan otomatis. Ikuti langkah-langkah di bawah ini untuk mengambil identitas terkelola dan memberikan peran yang diperlukan.

Contoh dalam artikel ini menggunakan tanda kurung sudut < ... > untuk mengidentifikasi nilai yang perlu Anda ganti sebelum menjalankan skrip. Ganti tanda kurung dan nilai di dalam tanda kurung.

(1) Mengambil identitas terkelola dari ekstensi pengontrol data Arc

$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group <resource group>  --cluster-name <connectedclustername> --cluster-type connectedClusters --name <name of extension> | convertFrom-json).identity.principalId
#Example
$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group myresourcegroup  --cluster-name myconnectedcluster --cluster-type connectedClusters --name ads-extension | convertFrom-json).identity.principalId

(2) Menetapkan peran untuk identitas terkelola

Jalankan perintah di bawah ini untuk menetapkan peran Penerbit Metrik Pemantauan:

az role assignment create --assignee $Env:MSI_OBJECT_ID --role 'Monitoring Metrics Publisher' --scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME"

Pengunggahan metrik otomatis dapat diaktifkan sebagai berikut:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics true
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics true

Untuk menonaktifkan pengunggahan metrik otomatis ke Azure Monitor, jalankan perintah berikut:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics false
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics false

Mengunggah metrik untuk pengontrol data Azure Arc dalam mode tidak langsung

Dalam mode terhubung tidak langsung, perwakilan layanan digunakan untuk mengunggah metrik.

Prasyarat

Sebelum melanjutkan, pastikan Anda telah membuat perwakilan layanan yang diperlukan dan menetapkannya ke peran yang sesuai. Untuk detailnya, lihat:

Mengatur variabel lingkungan dan mengonfirmasi

Atur URL otoritas SPN dalam variabel lingkungan:

$Env:SPN_AUTHORITY='https://login.microsoftonline.com'

Jika perlu, pastikan bahwa semua variabel lingkungan yang diperlukan diatur:

$Env:SPN_TENANT_ID
$Env:SPN_CLIENT_ID
$Env:SPN_CLIENT_SECRET
$Env:SPN_AUTHORITY

Mengunggah metrik ke Azure Monitor

Untuk mengunggah metrik untuk SQL Managed Instance yang diaktifkan oleh Azure Arc dan PostgreSQL dengan dukungan Azure Arc, jalankan perintah CLI berikut:

  1. Ekspor semua metrik ke file yang ditentukan:

Catatan

Mengekspor informasi penggunaan/penagihan, metrik, dan log menggunakan perintah az arcdata dc export perlu melewati verifikasi SSL untuk saat ini. Anda akan diminta untuk melewati verifikasi SSL atau Anda dapat mengatur variabel lingkungan AZDATA_VERIFY_SSL=no untuk menghindari permintaan. Tidak ada cara untuk mengonfigurasi sertifikat SSL untuk API ekspor pengontrol data saat ini.

az arcdata dc export --type metrics --path metrics.json --k8s-namespace arc

  1. Unggah metrik ke Azure Monitor:

    az arcdata dc upload --path metrics.json

    Catatan

    Tunggu setidaknya 30 menit setelah instans data dengan dukungan Azure Arc dibuat untuk pengunggahan pertama.

    Pastikan upload metrik segera setelah export karena Azure Monitor hanya menerima metrik selama 30 menit terakhir. Pelajari selengkapnya.

Jika selama ekspor Anda melihat kesalahan yang menunjukkan "Gagal mendapatkan metrik", pastikan pengumpulan data diatur ke true dengan menjalankan perintah berikut:

az arcdata dc config show  --k8s-namespace arc --use-k8s

Lihat di bawah "bagian keamanan"

 "security": {
      "allowDumps": true,
      "allowNodeMetricsCollection": true,
      "allowPodMetricsCollection": true,
    },

Pastikan properti allowNodeMetricsCollection dan allowPodMetricsCollection diatur ke true.

Lihat metrik di Portal

Begitu metrik diunggah, Anda dapat melihatnya dari portal Azure.

Catatan

Harap diingat bahwa dibutuhkan beberapa menit agar data yang diunggah diproses sebelum Anda bisa melihat metrik di portal.

Untuk melihat metrik Anda, navigasikan ke portal Azure. Kemudian, cari instans database Anda berdasarkan nama di bilah pencarian:

Anda dapat melihat pemanfaatan CPU pada halaman Ringkasan atau jika Anda ingin metrik lebih rinci, Anda bisa mengklik metrik dari panel navigasi sebelah kiri

Pilih sql server atau postgres sebagai namespace metrik.

Pilih metrik yang ingin Anda visualisasikan (Anda juga dapat memilih beberapa).

Ubah frekuensi menjadi 30 menit terakhir.

Catatan

Anda hanya dapat mengunggah metrik selama 30 menit terakhir saja. Azure Monitor akan menolak metrik yang lebih lama dari 30 menit.

Mengotomatiskan pengunggahan (opsional)

Jika ingin mengunggah metrik dan log secara terjadwal, Anda dapat membuat skrip dan menjalankannya di pengatur waktu setiap beberapa menit. Berikut ini contoh pengotomatisan unggahan menggunakan skrip shell Linux.

Di editor teks/kode favorit Anda, tambahkan skrip berikut ke file dan simpan sebagai file yang dapat dieksekusi skrip seperti .sh (Linux/Mac), .cmd, , .batatau .ps1.

az arcdata dc export --type metrics --path metrics.json --force  --k8s-namespace arc
az arcdata dc upload --path metrics.json

Buatlah file skrip tersebut dapat dieksekusi

chmod +x myuploadscript.sh

Jalankan skrip setiap 20 menit:

watch -n 1200 ./myuploadscript.sh

Anda juga dapat menggunakan penjadwal tugas seperti cron atau Windows Task Scheduler, atau orchestrator seperti Ansible, Puppet, atau Chef.

Panduan umum tentang mengekspor dan mengunggah penggunaan, metrik

Membuat, membaca, memperbarui, dan menghapus (CRUD) operasi pada layanan data Azure Arc-enabled dicatat untuk tujuan penagihan dan pemantauan. Ada layanan latar belakang yang memantau operasi CRUD ini dan menghitung konsumsi dengan tepat. Perhitungan aktual penggunaan atau konsumsi terjadi secara terjadwal dan dilakukan di latar belakang.

Unggah penggunaan hanya sekali per hari. Saat informasi penggunaan diekspor dan diunggah beberapa kali dalam periode 24 jam yang sama, hanya inventaris sumber daya yang diperbarui di portal Azure tetapi bukan penggunaan sumber daya.

Untuk mengunggah metrik, monitor Azure hanya menerima data 30 menit terakhir (Pelajari selengkapnya). Panduan untuk mengunggah metrik adalah mengunggah metrik segera setelah membuat file ekspor sehingga Anda dapat melihat tampilan seluruh himpunan data di portal Azure. Misalnya, jika Anda mengekspor metrik pada pukul 14.00 dan menjalankan perintah unggah pada pukul 14.50. Karena Azure Monitor hanya menerima data selama 30 menit terakhir, Anda mungkin tidak melihat data apa pun di portal.

Konten terkait

Unggah log ke Azure Monitor

Mengunggah data penggunaan, metrik, dan log ke Azure Monitor

Unggah data tagihan ke Microsoft Azure dan lihat di portal Microsoft Azure

Melihat sumber daya pengontrol data Azure Arc di portal Azure