Aracılığıyla paylaş

Azure Kaynak Bildirimleri - Azure Event Grid'de Sistem Durumu Kaynakları olayları (Önizleme)

  • Makale

HealthResources sistem konusu doğru, güvenilir ve kapsamlı sistem durumu bilgileri sağlayarak Azure kaynaklarınızı etkileyen çeşitli hizmet sorunlarının daha iyi anlaşılmasını sağlar; tek örnekli sanal makineler (VM),Sanal Makine Ölçek Kümesi VMS ve Sanal Makine Ölçek Kümeleri. Sistem Durumu Kaynakları, tüketim için iki olay türü sunar: AvailabilityStatusChanged ve ResourceAnnotated.

Bu makale, Azure Kaynak Bildirimleri Sistem Durumu Kaynakları olaylarının özelliklerini ve şemasını sağlar. Genel olarak olay şemalarına giriş için bkz . Azure Event Grid olay şeması. Ayrıca, oluşturulan olayların örneklerini ve bu konu türü için sistem konusunun nasıl oluşturulacağıyla ilgili bir makalenin bağlantısını bulabilirsiniz.

Olay tipleri

Sistem Durumu Kaynakları tüketim için iki olay türü sunar:

Olay türü Açıklama
Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged Tek bir örnek VM'nin, sanal makine ölçek kümesinin veya sanal makine ölçek kümesindeki vm'nin kullanılabilirlik durumu değiştiğinde yükseltilir.

Bu bilgiler tek örnekli VM'lerinizin, sanal makine ölçek kümelerindeki VM'lerinizin veya sanal makine ölçek kümelerinizin Azure hizmet sorunları nedeniyle kendilerinin kullanılamadığı tüm zamanlara ilişkin içgörü sağlar. Çeşitli sistem durumu hakkında daha fazla bilgi için bkz. Azure Kaynak Durumu genel bakış - Azure Hizmet Durumu.

Microsoft.ResourceNotifications.HealthResources.ResourceAnnotated Bir VM'nin, sanal makine ölçek kümesinin veya sanal makine ölçek kümesindeki bir VM'nin sistem durumu kesintileri etkileyen kullanılabilirlik tarafından etkilendiğinde yükseltilir. Platform, uygun şekilde yanıt verme konusunda size yardımcı olmak için kesintinin neden oluştuğuna ilişkin bağlamı yayar.

Bu bilgiler, kullanılabilirlikteki değişikliklerin nedenleri ve nedenleri hakkında önemli bilgiler sağlayarak kaynaklarınızın kullanılabilirlik durumunu çıkarsamanıza yardımcı olur. Bu verileri kullanarak daha hızlı ve daha hedefli azaltma önlemleri alabilirsiniz. Yayılan çeşitli ek açıklamalar hakkında daha fazla bilgi için bkz. Kaynak Durumu sanal makine Sistem Durumu Ek Açıklamaları.

Rol tabanlı erişim denetimi

Şu anda bu olaylar yalnızca Azure aboneliği kapsamında yayılıyor. Bu konu türü için olay aboneliğini oluşturan varlığın bu Azure aboneliği boyunca bildirim aldığı anlamına gelir. Güvenlik nedenleriyle, bu konuda olay abonelikleri oluşturma özelliğini azure aboneliğinin tamamında okuma erişimi olan sorumlularla kısıtlamak zorunludur. Bu sistem konusu aracılığıyla verilere erişmek için, Event Grid'in gerektirdiği genel izinlere ek olarak, aşağıdaki Azure Kaynak Bildirimlerine özgü izin gereklidir: Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action.

Olay şemaları

Şema şu şekildedir:

{
    "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
}

Bir olay aşağıdaki üst düzey verilere sahiptir:

Özellik Türü Veri Akışı Açıklaması
id String Olayın benzersiz tanımlayıcısı
source String Bu sistem konusunun oluşturulduğu Azure aboneliği.
subject String Bu olayın yayıldığı temel kaynağın yayımcı tanımlı yolu.
type String Bu sistem konu türünün kayıtlı olay türü
time Dize
Biçim: 2022-11-07T18:43:09.2894075Z		 Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat
data Object Kaynak sağlayıcısına özgü olay verilerini içerir. Daha fazla bilgi için sonraki tabloya bakın.
specversion String CloudEvents şema belirtimi sürümü.

data Nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Açıklama
resourceInfo Object Kaynağa özgü veriler. Daha fazla bilgi için sonraki tabloya bakın.
apiVersion String Kaynak özelliklerinin API sürümü.
operationalInfo Object Kaynakla ilgili işlem bilgilerinin ayrıntıları.

resourceInfo Nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
id String Olay konusunun yayımcı tanımlı yolu
name String Bu alan Olay Kimliğini gösterir. Her zaman alanın son bölümünün id değerini alır.
type String Yayılmakta olan olayın türü. Bu bağlamda, veya Microsoft.ResourceHealth/ResourceAnnotatedşeklindedirMicrosoft.ResourceHealth/AvailabilityStatuses.
properties Object Kaynağın yükü. Daha fazla bilgi için sonraki tabloya bakın.

operationalInfo Nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Açıklama
resourceEventTime DateTime Kaynağın güncelleştirilildiği tarih ve saat.

properties nesnesinin data içindeki ve ResourceAnnotated olayları farklıdırAvailabilityStatusChanged.

AvailabilityStatusChanged olayının özellikleri

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

Olay için AvailabilityStatusChanged nesne properties aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
targetResourceId String Kullanılabilirlik bilgilerinin yayıldığı temel kaynak.
targetResourceType String Temel kaynağın türü.
occurredTime String Bu gerçek olayın yayıldığı saat.
previousAvailabilityState String Önceki kullanılabilirlik durumu.
availabilityState String Geçerli kullanılabilirlik durumu. Değerlerin listesi için bkz. Kullanılabilirlik Durumları - Kaynağa Göre Al - REST API (Azure Kaynak Durumu).

ResourceAnnotated olayının özellikleri

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

Olay için ResourceAnnotated nesne properties aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
targetResourceId String Ek açıklama bilgilerinin yayıldığı temel kaynak.
targetResourceType String Temel kaynağın türü.
occurredTime String Kullanılabilirliği etkileyen olaya yanıt olarak ek açıklamanın Azure platformu tarafından ne zaman yayıldığı zaman damgası.
annotationName String Ek açıklamanın adı. Ek açıklamaların listesi ve buna karşılık gelen açıklamalar için bkz. Kaynak Durumu sanal makine Sistem Durumu Ek Açıklamaları - Azure Hizmet Durumu.
reason String Kaynak kullanılabilirliğinin neden değiştiğine veya etkilendiğine ilişkin kısa bir açıklama.
summary String Etkinlikle ilgili ayrıntılı ifade ve kaynak kullanılabilirliğinin değişmesine veya etkilenmesine neden olma.
context String Kaynak kullanılabilirliğinin Azure'a mı yoksa kullanıcının neden olduğu etkinliğe mi bağlı olduğunu belirler.
category String Kaynak kullanılabilirliğinin planlanan veya planlanmamış etkinlikten etkilenip etkilenmediğini belirler. Bu özellik yalnızca olaylar için Platform-Initiated geçerlidir.

Örnek olaylar

AvailabilityStatusChanged olayı

Aşağıdaki örnekte anahtar-değer değiştirme olayının şeması gösterilmektedir:

{
  "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"
}

ResourceAnnotated olayı

Aşağıdaki örnekte anahtar-değer değiştirme olayının şeması gösterilmektedir:

{
  "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"
}

Bizimle ulaşın

Bu özellik hakkında sorularınız veya geri bildirimleriniz varsa adresinden bize arnsupport@microsoft.comulaşmaktan çekinmeyin.

Belirli bir olayla ilgili belirli geri bildirimlerde size daha iyi yardımcı olmak için aşağıdaki bilgileri sağlayın:

Eksik olaylar için:

  • Sistem konu türü adı
  • İşlem yürütülürken UTC'de yaklaşık zaman damgası
  • Bildirimin oluşturulduğu temel kaynak kimliği
  • Azure portalında kaynağınıza gidin ve en sağ köşedeki JSON görünümünü seçin. Kaynak Kimliği, JSON görünümü sayfasındaki ilk alandır.
  • Beklenen olay türü
  • Yürütülen işlem (örneğin, VM başlatıldı veya durduruldu, Depolama hesap oluşturuldu vb.)
  • Karşılaşılan sorunun açıklaması (örneğin, VM başlatıldı ve Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged olayı oluşturulmadı)
  • Mümkünse yürütülen işlemin bağıntı kimliğini belirtin

Geciken veya beklenmeyen içeriğe sahip olan olay için

  • Sistem konu türü adı
  • data.resourceInfo.properties hariç bildirimin tüm içeriği
  • Karşılaşılan ve etkilenen alan değerlerinin açıklaması

Bu verileri paylaşırken son kullanıcı tarafından tanımlanabilir hiçbir bilgi sağlamadığınızdan emin olun.

Sonraki adımlar

Bkz. Azure Kaynak Bildirimleri - Sistem Durumu Kaynakları olaylarına abone olma.