Powiadomienia dotyczące zasobów platformy Azure — zdarzenia ContainerService w usłudze Azure Event Grid (wersja zapoznawcza)
Usługa Azure Kubernetes Service (AKS) używa tematu systemu zasobów zdarzeń usługi kontenera do dostarczania powiadomień z góry dotyczących zaplanowanych działań konserwacyjnych w klastrach usługi AKS. Ta funkcja umożliwia odbieranie powiadomień wypychanych dla podstawowych zadań konserwacji na różnych etapach zdarzeń, w tym zaplanowanych, zainicjowanych, ukończonych, anulowanych i zakończonych niepowodzeniem. W szczególności w przypadku zaplanowanego etapu powiadomienia są wysyłane 7 dni i 24 godziny przed rzeczywistą aktywnością konserwacyjną.
Powiadomienia obejmują:
- Konserwacja zainicjowana przez usługę AKS (na przykład migracja nakładki, przełącznik tunelu Konnectivity)
- Konserwacja zainicjowana przez klientów (na przykład automatyczne uaktualnianie, uaktualnianie systemu operacyjnego Node i cotygodniowe okna wydania)
Te powiadomienia w przyszłości pomagają klientom, oferując możliwość lepszego przygotowania się do potencjalnych zakłóceń, co ostatecznie ma na celu zminimalizowanie wydatków operacyjnych.
Ten artykuł zawiera właściwości i schemat zdarzeń ContainerService usługi Azure Resource Notifications. Aby zapoznać się z ogólnym wprowadzeniem do schematów zdarzeń, zobacz Schemat zdarzeń usługi Azure Event Grid. Ponadto można znaleźć przykłady wygenerowanych zdarzeń i link do powiązanego artykułu na temat tworzenia tematu systemowego dla tego typu tematu.
Typy zdarzeń
Usługa ContainerService oferuje następujący typ zdarzenia do użycia:
| Typ zdarzenia | opis |
|---|---|
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted |
Udostępnia powiadomienia z wyprzedzeniem dotyczące zdarzeń zaplanowanej konserwacji w klastrach usługi AKS. |
Kontrola dostępu oparta na rolach
Obecnie te zdarzenia są emitowane wyłącznie w zakresie subskrypcji platformy Azure. Oznacza to, że jednostka tworząca subskrypcję zdarzeń dla tego typu tematu otrzymuje powiadomienia w całej subskrypcji platformy Azure. Ze względów bezpieczeństwa konieczne jest ograniczenie możliwości tworzenia subskrypcji zdarzeń w tym temacie do podmiotów zabezpieczeń z dostępem do odczytu w całej subskrypcji platformy Azure. Aby uzyskać dostęp do danych za pośrednictwem tego tematu systemowego, oprócz ogólnych uprawnień wymaganych przez usługę Event Grid, niezbędne jest następujące uprawnienie specyficzne dla usługi Azure Resource Notifications: "".
Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action
Schematy zdarzeń
Oto schemat:
{
"id": "string",
"source": "string",
"subject": "string",
"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
"time ": "string in date-time",
"data": {
"resourceInfo": {
"id": "string",
"name": "string",
"type": "string",
"location": "string",
"properties": {
"description": "string",
"eventId": "string",
"eventSource": "string",
"eventStatus": "string",
"eventDetails": "string",
"scheduledTime": "string in date-time",
"startTime": "string in date-time",
"lastUpdateTime": "string in date-time",
"resources": "array of strings",
"resourceType": "string"
}
},
"operationalInfo": {
"resourceEventTime": "string in date-time"
},
"apiVersion": "string"
},
"specversion": "string"
}
Zdarzenie ma następujące dane najwyższego poziomu:
| Właściwość | Type | opis |
|---|---|---|
id |
String | Unikatowy identyfikator zdarzenia |
source |
String | Subskrypcja platformy Azure, dla której jest tworzony ten temat systemowy. |
subject |
String | Ścieżka zdefiniowana przez program Publisher do zasobu podstawowego, na którym jest emitowane to zdarzenie. |
type |
String | Typ zarejestrowanego zdarzenia tego typu tematu systemowego |
time |
Struna Format: 2022-11-07T18:43:09.2894075Z |
Czas generowania zdarzenia na podstawie czasu UTC dostawcy |
data |
Objekt | Zawiera dane zdarzenia specyficzne dla dostawcy zasobów. Aby uzyskać więcej informacji, zobacz następną tabelę. |
specversion |
String | Wersja specyfikacji schematu CloudEvents. |
Obiekt data ma następujące właściwości:
| Właściwość | Type | Opis |
|---|---|---|
resourceInfo |
Objekt | Dane specyficzne dla zasobu. Aby uzyskać więcej informacji, zobacz następną tabelę. |
apiVersion |
String | Wersja interfejsu API właściwości zasobu. |
operationalInfo |
Objekt | Szczegóły informacji operacyjnych dotyczących zasobu. |
Obiekt resourceInfo ma następujące właściwości:
| Właściwość | Type | opis |
|---|---|---|
id |
String | Zdefiniowana ścieżka wydawcy do tematu zdarzenia |
name |
String | To pole wskazuje identyfikator zdarzenia. Zawsze przyjmuje wartość ostatniej sekcji id pola. |
type |
String | Typ emitowanego zdarzenia. |
location |
String | Lokalizacja lub region, w którym znajduje się zasób. |
properties |
Objekt | Ładunek zasobu. Aby uzyskać więcej informacji, zobacz następną tabelę. |
Obiekt operationalInfo ma następujące właściwości:
| Właściwość | Type | Opis |
|---|---|---|
resourceEventTime |
DateTime | Data i godzina aktualizacji zasobu. |
Zdarzenie ScheduledEventEmitted ma następujące właściwości:
| Właściwość | Type | opis |
|---|---|---|
description |
String | Opis zdarzenia. |
eventId |
String | Identyfikator zdarzenia. |
eventSource |
String | Źródło zdarzenia. |
eventStatus |
Wyliczenie (ciąg) | Stan zdarzenia, które może być — Zaplanowane, Uruchomione, Ukończone, Anulowane, Niepowodzenie. |
eventDetails |
String | Szczegóły zdarzenia. |
scheduledTime |
Ciąg (format daty i godziny) | Godzina rozpoczęcia zdarzenia. |
lastUpdateTime |
Ciąg (format daty i godziny) | Ostatni raz stan zdarzenia został zaktualizowany. |
resources |
Tablica ciągów (format identyfikatora usługi Azure Resource Manager) | Lista zasobów, których dotyczy zdarzenie. |
resourceType |
String | Typ zasobu zdarzenia |
Przykładowe zdarzenia
W poniższym przykładzie przedstawiono schemat zdarzenia zmodyfikowanego przez klucz-wartość:
{
"id": "5bdb52cf-5489-4845-86c8-7fe94a4fc6c1",
"source": "/subscriptions/{subscription-id}",
"subject": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
"data": {
"resourceInfo": {
"id": "/subscriptions/{subscription-id}/resourceGroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}/scheduledEvents/{event-id}",
"name": "{event-id}",
"type": "Microsoft.ContainerService/managedClusters/scheduledEvents",
"properties": {
"description": "ScheduledEvents",
"eventId": "bbe82027-0444-4f73-897a-0bbfe3af66f1",
"eventSource": "AutoUprader",
"eventStatus": "Started",
"eventDetails": "Start to upgrade security vhd",
"scheduledTime": "2024-04-16T22:17:12.103268606Z",
"startTime": "0001-01-01T00:00:00.0000000Z",
"lastUpdateTime": "0001-01-01T00:00:00.0000000Z",
"resources": [
"/subscriptions/{subscription-id}/resourcegroups/{rg-name}/providers/Microsoft.ContainerService/managedClusters/{managedcluster-name}"
],
"resourceType": "ManagedCluster"
}
},
"operationalInfo": {
"resourceEventTime": "2024-04-16T22:17:12.1032748"
},
"apiVersion": "2023-11-02-preview"
},
"type": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
"specversion": "1.0",
"time": "2024-04-16T22:17:12.1032748Z"
}
Kontakt z nami
Jeśli masz jakiekolwiek pytania lub opinie dotyczące tej funkcji, nie wahaj się skontaktować się z nami pod adresem arnsupport@microsoft.com.
Aby lepiej pomóc w konkretnej opinii na temat określonego zdarzenia, podaj następujące informacje:
W przypadku brakujących zdarzeń:
- Nazwa typu tematu systemowego
- Przybliżony znacznik czasu w formacie UTC podczas wykonywania operacji
- Identyfikator zasobu podstawowego, dla którego zostało wygenerowane powiadomienie
- Przejdź do zasobu w witrynie Azure Portal i wybierz widok JSON w prawym górnym rogu. Identyfikator zasobu to pierwsze pole na stronie widoku JSON.
- Oczekiwany typ zdarzenia
- Wykonano operację (na przykład uruchomiono lub zatrzymano maszynę wirtualną, utworzono konto magazynu itp.)
- Opis napotkanego problemu (na przykład maszyna wirtualna została uruchomiona i nie wygenerowano zdarzenia Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
- Jeśli to możliwe, podaj identyfikator korelacji wykonanej operacji
W przypadku zdarzenia, które zostało opóźnione lub ma nieoczekiwaną zawartość
- Nazwa typu tematu systemowego
- Cała zawartość powiadomienia z wyłączeniem właściwości data.resourceInfo.properties
- Opis napotkanego problemu i wartości pól, których dotyczy problem
Upewnij się, że podczas udostępniania tych danych nie udostępniasz żadnych informacji możliwych do zidentyfikowania przez użytkownika końcowego.
Następne kroki
Zobacz Subskrybowanie powiadomień o zasobach platformy Azure — zdarzenia usługi Container Service.