Bagikan melalui

Pemberitahuan Sumber Daya Azure - Peristiwa Sumber Daya Kesehatan di Azure Event Grid (Pratinjau)

  • Artikel

Topik sistem HealthResources menyediakan informasi kesehatan yang akurat, andal, dan komprehensif, memungkinkan pemahaman yang lebih mendalam tentang beragam masalah layanan yang memengaruhi sumber daya Azure Anda yaitu, komputer virtual instans tunggal (VM), Virtual Machine Scale Set VMS, dan Virtual Machine Scale Sets. Sumber Daya Kesehatan menawarkan dua jenis peristiwa untuk dikonsumsi: AvailabilityStatusChanged dan ResourceAnnotated.

Artikel ini menyediakan properti dan skema untuk peristiwa Sumber Daya Kesehatan Pemberitahuan Sumber Daya Sumber Daya Azure. Untuk pengenalan skema peristiwa secara umum, lihat Skema peristiwa Azure Event Grid. Selain itu, Anda dapat menemukan sampel peristiwa yang dihasilkan dan tautan ke artikel terkait tentang cara membuat topik sistem untuk jenis topik ini.

Tipe peristiwa

Sumber Daya Kesehatan menawarkan dua jenis peristiwa untuk dikonsumsi:

Jenis peristiwa Deskripsi
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Dinaikkan saat status ketersediaan VM instans tunggal, set skala komputer virtual, atau VM dalam set skala komputer virtual berubah.

Informasi ini memberikan wawasan tentang setiap kali VM instans tunggal Anda, VM dalam set skala komputer virtual, atau set skala komputer virtual itu sendiri tidak tersedia karena masalah layanan Azure. Untuk informasi selengkapnya tentang berbagai status kesehatan, lihat Gambaran umum Azure Resource Health - Azure Service Health.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Dinaikkan ketika kesehatan VM, set skala komputer virtual, atau VM dalam set skala komputer virtual, dipengaruhi oleh ketersediaan yang memengaruhi gangguan. Platform ini memancarkan konteks mengapa gangguan telah terjadi untuk membantu Anda dalam merespons dengan tepat.

Informasi ini membantu Anda menyimpulkan status ketersediaan sumber daya Anda dengan memberikan informasi penting tentang alasan dan penyebab perubahan ketersediaan. Dengan menggunakan data ini, Anda dapat mengambil langkah-langkah mitigasi yang lebih cepat dan lebih tepat sasaran. Untuk informasi selengkapnya tentang berbagai anotasi yang dipancarkan, lihat Anotasi Kesehatan komputer virtual Resource Health.

Kontrol Akses Berbasis Peran

Saat ini, peristiwa ini secara eksklusif dipancarkan di cakupan langganan Azure. Ini menyiratkan bahwa entitas yang membuat langganan peristiwa untuk jenis topik ini menerima pemberitahuan di seluruh langganan Azure ini. Untuk alasan keamanan, sangat penting untuk membatasi kemampuan untuk membuat langganan peristiwa pada topik ini kepada prinsipal dengan akses baca di seluruh langganan Azure. Untuk mengakses data melalui topik sistem ini, selain izin umum yang diperlukan oleh Event Grid, izin khusus Pemberitahuan Sumber Daya Azure berikut diperlukan: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.

Skema peristiwa

Berikut adalah skemanya:

{
    "id": string,
    "source": string,
    "subject": string,
    "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged | Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
    "time ": string, 
    "data": {
        "resourceInfo": {
            "id": string,
            "name": string,
            "type": string,
            "properties": { 
                <<Different for AvailabilityStatusChanged event and ResourceAnnotated event>>            
            }
        },
        "operationalInfo":{
			"resourceEventTime": date-time
		},
        "apiVersion": string 
    }, 
    "specversion": string
}

Sebuah peristiwa memiliki data tingkat atas berikut ini:

Properti Tipe Deskripsi
id String Pengidentifikasi unik peristiwa
source String Langganan Azure tempat topik sistem ini sedang dibuat.
subject String Jalur yang ditentukan penerbit ke sumber daya dasar tempat peristiwa ini dipancarkan.
type String Jenis kejadian terdaftar dari jenis topik sistem ini
time String
Format: 2022-11-07T18:43:09.2894075Z		 Waktu kejadian dibuat berdasarkan Waktu Universal Terkoordinasi (UTC) milik penyedia
data Objek Berisi data peristiwa khusus untuk penyedia sumber daya. Untuk informasi selengkapnya, lihat tabel berikutnya.
specversion String Versi spesifikasi skema CloudEvents.

Objek data memiliki properti berikut:

Properti Tipe Deskripsi
resourceInfo Objek Data khusus untuk sumber daya. Untuk informasi selengkapnya, lihat tabel berikutnya.
apiVersion String Versi API dari properti sumber daya.
operationalInfo Objek Detail informasi operasional yang berkaitan dengan sumber daya.

Objek resourceInfo memiliki properti berikut:

Properti Tipe Deskripsi
id String Jalur yang ditentukan publisher ke subjek peristiwa
name String Bidang ini menunjukkan Event-id. Selalu mengambil nilai bagian terakhir dari id bidang .
type String Jenis peristiwa yang sedang dipancarkan. Dalam konteks ini, baik atau Microsoft.ResourceHealth/AvailabilityStatusesMicrosoft.ResourceHealth/ResourceAnnotated.
properties Objek Payload sumber daya. Untuk informasi selengkapnya, lihat tabel berikutnya.

Objek operationalInfo memiliki properti berikut:

Properti Tipe Deskripsi
resourceEventTime DateTime Tanggal dan waktu saat sumber daya diperbarui.

Di properties dalam data objek berbeda untuk AvailabilityStatusChanged peristiwa dan ResourceAnnotated .

Properti untuk peristiwa AvailabilityStatusChanged

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "previousAvailabilityState": string,
                "availabilityState": string
            }

Untuk peristiwa tersebut AvailabilityStatusChanged , properties objek memiliki properti berikut:

Properti Tipe Deskripsi
targetResourceId String Sumber daya dasar tempat informasi ketersediaan dipancarkan.
targetResourceType String Jenis sumber daya dasar.
occurredTime String Waktu ketika peristiwa aktual ini dipancarkan.
previousAvailabilityState String Status ketersediaan sebelumnya.
availabilityState String Status ketersediaan saat ini. Untuk daftar nilai, lihat Status Ketersediaan - Dapatkan Menurut Sumber Daya - REST API (Azure Resource Health).

Properti untuk peristiwa ResourceAnnotated

            "properties": {
                "targetResourceId": string,
                "targetResourceType": string,
                "occurredTime": string,
                "annotationName": string,
                "reason": string,
                "summary": string,
                "context": string,
                "category": string,
            }

Untuk peristiwa tersebut ResourceAnnotated , properties objek memiliki properti berikut:

Properti Tipe Deskripsi
targetResourceId String Sumber daya dasar yang informasi anotasinya sedang dipancarkan.
targetResourceType String Jenis sumber daya dasar.
occurredTime String Tanda waktu saat anotasi dipancarkan oleh platform Azure sebagai respons terhadap peristiwa yang memengaruhi ketersediaan.
annotationName String Nama anotasi. Untuk daftar anotasi dan deskripsi yang sesuai, lihat Anotasi Kesehatan komputer virtual Resource Health - Azure Service Health.
reason String Pernyataan singkat tentang mengapa ketersediaan sumber daya telah berubah atau dipengaruhi.
summary String Pernyataan terperinci tentang aktivitas dan menyebabkan ketersediaan sumber daya berubah atau dipengaruhi.
context String Menentukan apakah ketersediaan sumber daya dipengaruhi karena Azure atau aktivitas yang disebabkan pengguna.
category String Menentukan apakah ketersediaan sumber daya dipengaruhi karena aktivitas yang direncanakan atau tidak direncanakan. Properti ini hanya berlaku untuk Platform-Initiated peristiwa.

Contoh kejadian

Peristiwa AvailabilityStatusChanged

Contoh berikut memperlihatkan skema peristiwa yang dimodifikasi dengan key-value:

{
  "id": "1fb6fa94-d965-4306-abeq-4810f0774e97",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/availabilityStatuses/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/availabilityStatuses",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "previousAvailabilityState": "Unavailable",
        "availabilityState": "Available"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2023-12-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

Peristiwa ResourceAnnotated

Contoh berikut memperlihatkan skema peristiwa yang dimodifikasi dengan key-value:

{
  "id": "8945cf9b-e220-496e-ab4f-f3a239318995",
  "source": "/subscriptions/{subscription-id}",
  "subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
  "data": {
    "resourceInfo": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}/providers/Microsoft.ResourceHealth/resourceAnnotations/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ResourceHealth/resourceAnnotations",
      "properties": {
        "targetResourceId": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/virtualMachines/{vm-name}",
        "targetResourceType": "Microsoft.Compute/virtualMachines",
        "occurredTime": "2023-07-24T19:20:37.9245071Z",
        "annotationName": "VirtualMachineDeallocationInitiated",
        "reason": "Stopping and deallocating",
        "summary": "This virtual machine is stopped and deallocated as requested by an authorized user or process.",
        "context": "Customer Initiated",
        "category": "Not Applicable"
      }
    },
    "operationalInfo": {
      "resourceEventTime": "2023-07-24T19:20:37.9245071Z"
    },
    "apiVersion": "2022-08-01"
  },
  "type": "Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated",
  "specversion": "1.0",
  "time": "2023-07-24T19:20:37.9245071Z"
}

Hubungi kami

Jika Anda memiliki pertanyaan atau umpan balik tentang fitur ini, jangan ragu untuk menghubungi kami di arnsupport@microsoft.com.

Untuk membantu Anda dengan lebih baik dengan umpan balik tertentu tentang peristiwa tertentu, berikan informasi berikut:

Untuk peristiwa yang hilang:

  • Nama jenis topik sistem
  • Perkiraan tanda waktu dalam UTC ketika operasi dijalankan
  • ID sumber daya dasar tempat pemberitahuan dibuat
  • Navigasikan ke sumber daya Anda di portal Azure dan pilih tampilan JSON di sudut kanan jauh. ID sumber daya adalah bidang pertama pada halaman tampilan JSON.
  • Jenis peristiwa yang diharapkan
  • Operasi dijalankan (misalnya, VM dimulai atau dihentikan, Akun penyimpanan dibuat dll.)
  • Deskripsi masalah yang dihadapi (misalnya, VM dimulai dan tidak ada peristiwa Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged yang dihasilkan)
  • Jika memungkinkan, berikan ID korelasi operasi yang dijalankan

Untuk kejadian yang tertunda atau memiliki konten yang tidak terduga

  • Nama jenis topik sistem
  • Seluruh konten pemberitahuan tidak termasuk data.resourceInfo.properties
  • Deskripsi masalah yang dihadapi dan nilai bidang yang terkena dampak

Pastikan Anda tidak memberikan informasi yang dapat diidentifikasi pengguna akhir saat berbagi data ini.

Langkah berikutnya

Lihat Berlangganan Pemberitahuan Sumber Daya Azure - Peristiwa Sumber Daya Kesehatan.