Уведомления о ресурсах Azure — события ContainerService в Сетка событий Azure (предварительная версия)
В Служба Azure Kubernetes (AKS) используется системный раздел "Ресурсы событий службы контейнеров" для доставки предварительных уведомлений о запланированных действиях по обслуживанию в кластерах AKS. Эта функция позволяет получать push-уведомления для основных задач обслуживания на разных этапах событий, включая запланированные, инициированные, завершенные, отмененные и неудачные. В частности, для запланированного этапа уведомления отправляются 7 дней и 24 часа до фактического обслуживания.
Уведомления охватывают:
- Обслуживание, инициированное AKS (например, миграция подложки, коммутатор коннективности туннеля)
- Обслуживание, инициированное клиентами (например, автоматическое обновление, обновление ОС узла и еженедельные окна выпуска)
Эти перспективные уведомления помогают клиентам, предлагая возможность лучше подготовиться к потенциальным нарушениям, в конечном счете стремясь минимизировать операционные расходы.
В этой статье приведены свойства и схема событий ContainerService для уведомлений о ресурсах Azure. Общие сведения о схемах событий см. в Сетка событий Azure схеме событий. Кроме того, можно найти примеры созданных событий и ссылку на связанную статью о том, как создать системный раздел для этого типа раздела.
Типы событий
ContainerService предлагает следующий тип события для потребления:
| Тип события | Description |
|---|---|
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted |
предоставляет предварительные уведомления о запланированных событиях обслуживания в кластерах AKS. |
Управление доступом на основе ролей
В настоящее время эти события создаются исключительно в области подписки Azure. Это означает, что сущность, создающая подписку на события для этого типа раздела, получает уведомления по всей этой подписке Azure. По соображениям безопасности необходимо ограничить возможность создания подписок на события в этом разделе субъектам с доступом на чтение по всей подписке Azure. Чтобы получить доступ к данным через этот системный раздел, помимо универсальных разрешений, необходимых сетке событий, необходимо следующее разрешение для уведомлений ресурсов Azure: "".
Microsoft.ResourceNotifications/systemTopics/subscribeToContainerServiceEventResources/action
Схемы событий
Ниже приведена схема:
{
"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"
}
Событие содержит следующие высокоуровневые данные:
| Свойство | Type | Описание: |
|---|---|---|
id |
Строка | Уникальный идентификатор события |
source |
Строка | Подписка Azure, для которой создается этот системный раздел. |
subject |
Строка | Издатель определил путь к базовому ресурсу, на котором создается это событие. |
type |
Строка | Зарегистрированный тип события данного типа системного раздела |
time |
Струна Формат: 2022-11-07T18:43:09.2894075Z |
Время создания события определяется на основе времени поставщика в формате UTC. |
data |
Object | Содержит данные событий, относящиеся к поставщику ресурсов. Этот процесс описан в следующей таблице. |
specversion |
Строка | Версия спецификации схемы CloudEvents. |
Объект data имеет следующие свойства.
| Свойство | Type | Описание |
|---|---|---|
resourceInfo |
Object | Данные, относящиеся к ресурсу. Этот процесс описан в следующей таблице. |
apiVersion |
Строка | Версия API свойств ресурса. |
operationalInfo |
Object | Сведения об операционной информации, относящейся к ресурсу. |
Объект resourceInfo имеет следующие свойства.
| Свойство | Type | Описание: |
|---|---|---|
id |
Строка | Определяемый издателем путь к теме события |
name |
Строка | Это поле указывает идентификатор события. Он всегда принимает значение последнего раздела id поля. |
type |
Строка | Тип создаваемого события. |
location |
Строка | Расположение или регион, где находится ресурс. |
properties |
Object | Полезные данные ресурса. Этот процесс описан в следующей таблице. |
Объект operationalInfo имеет следующие свойства.
| Свойство | Type | Описание |
|---|---|---|
resourceEventTime |
Дата/время | Дата и время обновления ресурса. |
Событие ScheduledEventEmitted имеет следующие свойства:
| Свойство | Type | Описание: |
|---|---|---|
description |
Строка | Описание события. |
eventId |
Строка | Идентификатор события. |
eventSource |
Строка | Источник события. |
eventStatus |
Перечисление (строка) | Состояние события, которое может быть запланировано, запущено, завершено, отменено, сбой. |
eventDetails |
Строка | Сведения о событии. |
scheduledTime |
Строка (формат даты и времени) | Время начала события. |
lastUpdateTime |
Строка (формат даты и времени) | Время последнего обновления состояния события. |
resources |
Массив строк (формат идентификатора Azure Resource Manager) | Список ресурсов, затронутых событием. |
resourceType |
Строка | Тип ресурса события |
Примеры событий
В следующем примере показана схема события изменения пары "ключ-значение".
{
"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"
}
Свяжитесь с нами
Если у вас есть вопросы или отзывы об этой функции, не стесняйтесь обратиться к нам.arnsupport@microsoft.com
Чтобы лучше помочь вам с конкретным отзывом о определенном событии, укажите следующие сведения:
Для отсутствующих событий:
- Имя типа системного раздела
- Приблизительная метка времени в формате UTC при выполнении операции
- Базовый идентификатор ресурса, для которого было создано уведомление
- Перейдите к ресурсу в портал Azure и выберите представление JSON в правом верхнем углу. Идентификатор ресурса — это первое поле на странице представления JSON.
- Ожидаемый тип события
- Операция выполнена (например, запущена или остановлена виртуальная машина, созданная учетная запись хранения и т. д.)
- Описание возникной проблемы (например, виртуальная машина запущена и не создано событие Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
- Если это возможно, укажите идентификатор корреляции выполненной операции.
Для события, которое было отложено или имеет непредвиденное содержимое
- Имя типа системного раздела
- Все содержимое уведомления, за исключением data.resourceInfo.properties
- Описание проблем, возникающих и затронутых значений полей
Убедитесь, что вы не предоставляете ни одной идентифицируемой пользователем информации при совместном использовании этих данных.
Следующие шаги
См . статью "Подписка на уведомления о ресурсах Azure" — события службы контейнеров.