Уведомления о ресурсах Azure — события Службы контейнеров в Event Grid Azure (предварительная версия)

В Службе Azure Kubernetes (AKS) используется системная тема «Ресурсы событий службы контейнеров» для доставки предварительных уведомлений о запланированных действиях по обслуживанию в кластерах AKS. Эта функция позволяет получать push-уведомления для основных задач обслуживания на разных этапах событий, включая запланированные, инициированные, завершенные, отмененные и неудачные. В частности, для запланированного этапа уведомления отправляются 7 дней и 24 часа до фактического обслуживания.

Уведомления охватывают:

Обслуживание, инициированное AKS (например, миграция подложки, коммутатор коннективности туннеля)
Обслуживание, инициированное клиентами (например, автоматическое обновление, обновление ОС узла и еженедельные окна выпуска)

Эти прогнозирующие уведомления помогают клиентам, предоставляя возможность лучше подготовиться к потенциальным сбоям с целью минимизировать эксплуатационные расходы.

В этой статье приведены свойства и схема событий ContainerService для уведомлений о ресурсах Azure. Общие сведения о схемах событий см. в схеме событий Сетке событий Azure. Кроме того, можно найти примеры созданных событий и ссылку на связанную статью о том, как создать системный раздел для этого типа раздела.

Типы событий

ContainerService предлагает следующий тип события для потребления:

Тип события	Описание
`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"
}

Событие содержит следующие высокоуровневые данные:

Свойство	Тип	Описание
`id`	Строка	Уникальный идентификатор события
`source`	Строка	Подписка Azure, для которой создается этот системный раздел.
`subject`	Строка	Издатель определил путь к базовому ресурсу, на котором генерируется это событие.
`type`	Строка	Зарегистрированный тип события данного типа системного раздела
`time`	Струна Формат: `2022-11-07T18:43:09.2894075Z`	Время создания события определяется на основе времени поставщика в формате UTC.
`data`	Объект	Содержит данные событий, относящиеся к поставщику ресурсов. Этот процесс описан в следующей таблице.
`specversion`	Строка	Версия спецификации схемы CloudEvents.

Ниже приведена схема:

{
    "id": "string",
    "topic": "string",
    "subject": "string",
    "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"
            }
        },
        "apiVersion": "string",
        "operationalInfo": {
            "resourceEventTime": "string in datetime"
        }
    },
    "eventType": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
    "dataVersion": "string",
    "metadataVersion": "string",
    "eventTime": "string in date-time"
}

Событие содержит следующие высокоуровневые данные:

Свойство	Тип	Описание
`id`	Строка	Уникальный идентификатор события
`topic`	Строка	Подписка Azure, для которой создается этот системный раздел
`subject`	Строка	Издатель определил путь к базовому ресурсу, на котором генерируется это событие.
`data`	Объект	Содержит данные событий, относящиеся к поставщику ресурсов. Этот процесс описан в следующей таблице.
`eventType`	Строка	Зарегистрированный тип события данного типа системного раздела
`dataVersion`	Строка	Версия схемы объекта данных
`metadataVersion`	Строка	Версия схемы метаданных события
`eventTime`	Струна Формат: `2022-11-07T18:43:09.2894075Z`	Время создания события определяется на основе времени поставщика в формате UTC.

Объект data имеет следующие свойства.

Свойство	Тип	Описание
`resourceInfo`	Объект	Данные, относящиеся к ресурсу. Этот процесс описан в следующей таблице.
`apiVersion`	Строка	Версия API свойств ресурса.
`operationalInfo`	Объект	Сведения об операционной информации, относящейся к ресурсу.

Объект resourceInfo имеет следующие свойства.

Свойство	Тип	Описание
`id`	Строка	Определяемый издателем путь к теме события
`name`	Строка	Это поле указывает идентификатор события. Он всегда принимает значение последнего раздела `id` поля.
`type`	Строка	Тип создаваемого события.
`location`	Строка	Расположение или регион, где находится ресурс.
`properties`	Объект	Полезные данные ресурса. Этот процесс описан в следующей таблице.

Объект operationalInfo имеет следующие свойства.

Свойство	Тип	Описание
`resourceEventTime`	Дата/время	Дата и время обновления ресурса.

Событие ScheduledEventEmitted имеет следующие свойства:

Свойство	Тип	Описание
`description`	Строка	Описание события.
`eventId`	Строка	Идентификатор события.
`eventSource`	Строка	Источник события.
`eventStatus`	Enum (Строка)	Состояние события, которое может быть – Запланировано, Начато, Завершено, Отменено, Сбой.
`eventDetails`	Строка	Сведения о событии.
`scheduledTime`	Строка (формат даты и времени)	Время начала события.
`lastUpdateTime`	Строка (формат даты и времени)	Время последнего обновления состояния события.
`resources`	Массив строк (формат идентификатора Azure Resource Manager)	Список ресурсов, затронутых событием.
`resourceType`	Строка	Тип ресурса события

Примеры событий

Схема облачных событий
Схема событий Event Grid

В следующем примере показана схема события изменения пары "ключ-значение".

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

{
  "id": "5bdb52cf-5489-4845-86c8-7fe94a4fc6c1",
  "topic": "/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}/{event-id}",
      "name": "{event-id}",
      "type": "Microsoft.ContainerService/managedClusters/scheduledEvents",
      "location": "westus2",
      "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"
  },
  "eventType": "Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2024-04-16T22:17:12.1032748Z"
}

Свяжитесь с нами

Если у вас есть вопросы или отзывы об этой функции, не стесняйтесь обратиться к нам по этой ссылке stackoverflow

Чтобы лучше помочь вам с конкретным отзывом о определенном событии, укажите следующие сведения:

Для отсутствующих событий:

Имя типа системной темы
Приблизительная метка времени в формате UTC при выполнении операции
Базовый идентификатор ресурса, для которого было создано уведомление
Перейдите к ресурсу в портале Azure и выберите представление JSON в верхнем правом углу. Идентификатор ресурса — это первое поле на странице представления JSON.
Ожидаемый тип события
Операция выполнена (например, запущена или остановлена виртуальная машина, созданная учетная запись хранения и т. д.)
Описание возникной проблемы (например, виртуальная машина запущена и не создано событие Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged)
Если это возможно, укажите идентификатор корреляции выполненной операции.

Для события, которое было отложено или имеет непредвиденное содержимое

Имя типа системной темы
Все содержимое уведомления, за исключением data.resourceInfo.properties
Описание проблем, возникающих и затронутых значений полей

Убедитесь, что вы не предоставляете персонально идентифицируемую информацию при передаче этих данных.

Следующие шаги

См. cтатью Подписка на уведомления о ресурсах Azure — события службы контейнеров.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2024-11-20