Azure 리소스 알림 - Azure Event Grid의 ContainerService 이벤트(미리 보기)
AKS(Azure Kubernetes Service)는 Container Service 이벤트 리소스 시스템 토픽을 사용하여 AKS 클러스터에서 예약된 유지 관리 작업에 대한 선점 알림을 제공합니다. 이 기능을 사용하면 예약, 시작, 완료, 취소 및 실패를 포함하여 다양한 이벤트 단계에서 필수 유지 관리 작업에 대한 푸시 알림을 수신할 수 있습니다. 특히 예약된 단계의 경우 알림은 실제 유지 관리 작업 7일 및 24시간 전에 디스패치됩니다.
알림에는 다음이 포함됩니다.
- AKS에서 시작된 유지 관리(예: 언더레이 마이그레이션, Konnectivity Tunnel Switch)
- 고객이 시작한 유지 관리(예: 자동 업그레이드, 노드 OS 업그레이드 및 주간 릴리스 기간)
이러한 미래 예측 알림은 잠재적인 중단에 더 잘 대비할 수 있는 기회를 제공하여 고객을 지원하며 궁극적으로 운영 비용을 최소화하는 것을 목표로 합니다.
이 문서에서는 Azure Resource Notifications ContainerService 이벤트에 대한 속성 및 스키마를 제공합니다. 일반적으로 이벤트 스키마에 대한 소개는 Azure Event Grid 이벤트 스키마를 참조하세요. 또한 생성된 이벤트의 샘플과 이 토픽 유형에 대한 시스템 토픽을 만드는 방법에 대한 관련 문서의 링크를 찾을 수 있습니다.
일정 유형
ContainerService는 소비를 위해 다음과 같은 이벤트 유형을 제공합니다.
| 이벤트 유형 | 설명 |
|---|---|
Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted |
는 AKS 클러스터에서 예약된 유지 관리 이벤트에 대한 사전 알림을 제공합니다. |
역할 기반 액세스 제어
현재 이러한 이벤트는 Azure 구독 범위에서만 내보내집니다. 이는 이 토픽 유형에 대한 이벤트 구독을 만드는 엔터티가 이 Azure 구독 전체에서 알림을 수신한다는 것을 의미합니다. 보안상의 이유로 이 토픽에서 이벤트 구독을 만드는 기능을 전체 Azure 구독에 대한 읽기 권한이 있는 보안 주체로 제한해야 합니다. Event Grid에 필요한 일반 권한 외에도 이 시스템 항목을 통해 데이터에 액세스하려면 다음 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 |
String 형식: 2022-11-07T18:43:09.2894075Z |
공급자의 UTC 시간을 기준으로 이벤트가 생성된 시간 |
data |
Object | 리소스 공급자와 관련된 이벤트 데이터를 포함합니다. 자세한 내용은 다음 테이블을 참조하세요. |
specversion |
문자열 | CloudEvents 스키마 사양 버전입니다. |
data 개체의 속성은 다음과 같습니다.
| 속성 | Type | 설명 |
|---|---|---|
resourceInfo |
Object | 리소스와 관련된 데이터입니다. 자세한 내용은 다음 테이블을 참조하세요. |
apiVersion |
문자열 | 리소스 속성의 API 버전. |
operationalInfo |
Object | 리소스와 관련된 운영 정보의 세부 정보입니다. |
resourceInfo 개체의 속성은 다음과 같습니다.
| 속성 | Type | 설명 |
|---|---|---|
id |
문자열 | 게시자가 정의한 이벤트 주체에 대한 경로 |
name |
문자열 | 이 필드는 이벤트 ID를 나타냅니다. 항상 필드의 마지막 섹션 id 값을 사용합니다. |
type |
문자열 | 내보내는 이벤트의 유형입니다. |
location |
문자열 | 리소스가 있는 국가 또는 지역입니다. |
properties |
Object | 리소스의 페이로드입니다. 자세한 내용은 다음 테이블을 참조하세요. |
operationalInfo 개체의 속성은 다음과 같습니다.
| 속성 | Type | 설명 |
|---|---|---|
resourceEventTime |
DateTime | 리소스가 업데이트된 날짜 및 시간입니다. |
이벤트에 ScheduledEventEmitted 는 다음과 같은 속성이 있습니다.
| 속성 | Type | 설명 |
|---|---|---|
description |
문자열 | 이벤트에 대한 설명입니다. |
eventId |
문자열 | 이벤트의 이벤트 ID입니다. |
eventSource |
문자열 | 이벤트의 원본입니다. |
eventStatus |
열거형(문자열) | 예약됨, 시작됨, 완료됨, 취소됨, 실패 등일 수 있는 이벤트의 상태입니다. |
eventDetails |
문자열 | 이벤트의 세부 정보입니다. |
scheduledTime |
문자열(날짜-시간 형식) | 이벤트의 시간이 시작되도록 예약됩니다. |
lastUpdateTime |
문자열(날짜-시간 형식) | 이벤트의 상태가 마지막으로 업데이트된 시간입니다. |
resources |
문자열 배열(Azure Resource Manager ID 형식) | 이벤트의 영향을 받는 리소스 목록입니다. |
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의 대략적 타임스탬프
- 알림이 생성된 기본 리소스 ID
- Azure Portal의 리소스로 이동하고 맨 오른쪽 모서리에서 JSON 보기를 선택합니다. 리소스 ID는 JSON 보기 페이지의 첫 번째 필드입니다.
- 예상 이벤트 유형
- 실행된 작업(예: VM 시작 또는 중지, 스토리지 계정 생성 등)
- 발생한 문제에 대한 설명(예: VM이 시작되고 Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged 이벤트가 생성되지 않음)
- 가능하면 실행된 작업의 상관 관계 ID를 제공합니다.
지연되었거나 예기치 않은 콘텐츠가 있는 이벤트의 경우
- 시스템 토픽 유형 이름
- data.resourceInfo.properties를 제외한 알림의 전체 콘텐츠
- 발생한 문제 및 영향을 받은 필드 값에 대한 설명
이 데이터를 공유하는 동안 최종 사용자 식별 정보를 제공하고 있지 않은지 확인합니다.
다음 단계
Azure 리소스 알림 - Container Service 이벤트 구독을 참조 하세요.