次の方法で共有

Azure リソース通知 - コンテナー サービス イベント リソース システム トピックによって発生したイベントをサブスクライブする (プレビュー)

  • [アーティクル]

この記事では、Azure リソース通知 - コンテナー サービス イベント リソースによって発行されたイベントをサブスクライブするために必要な手順について説明します。 これらのイベントの詳細については、「Azure リソース通知 - コンテナー サービス イベント リソース」を参照してください。

正常性リソースのシステム トピックを作成する

  1. システム トピックを作成する Azure サブスクリプションにアカウントを設定します。

    az account set –s AZURESUBSCRIPTIONID

  2. az eventgrid system-topic create コマンドを使用して、microsoft.resourcenotifications.containerserviceeventresources タイプのシステム トピックを作成します。

    az eventgrid system-topic create --name SYSTEMTOPICNAME --resource-group RESOURCEGROUPNAME --source /subscriptions/AZURESUBSCRIPTIONID --topic-type microsoft.resourcenotifications.containerserviceeventresources --location Global

イベントをサブスクライブする

az eventgrid system-topic event-subscription create コマンドを使用して、上記のトピックのイベント サブスクリプションを作成します。

次のサンプル コマンドでは、ScheduledEventEmitted イベントのイベント サブスクリプションを作成します。

az eventgrid system-topic event-subscription create --name EVENTSUBSCRIPTIONNAME --resource-group RESOURCEGROUPNAME --system-topic-name SYSTEMTOPICNAME –included-event-types Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted --endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/MYEVENTHUBSNAMESPACE/eventhubs/MYEVENTHUB --endpoint-type eventhub

included-event-types を指定しない場合、すべてのイベントの種類が既定で含まれます。

特定のリソースからイベントをフィルターするには、--subject-begins-with パラメータを使用します。 この例では、指定したリソース グループ内のリソースに ScheduledEventsEmitted イベントをサブスクライブする方法を示します。

az eventgrid system-topic event-subscription create --name EVENTSUBSCRIPTIONNAME --resource-group RESOURCEGROUPNAME --system-topic-name SYSTEMTOPICNAME –included-event-types Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted --endpoint /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/MYEVENTHUBSNAMESPACE/eventhubs/MYEVENTHUB --endpoint-type eventhub --subject-begins-with /subscriptions/AZURESUBSCRIPTIONID/resourceGroups/SOURCERESOURCEGROUP/

イベント サブスクリプションとシステム トピックを削除する

イベント サブスクリプションを削除するには、az eventgrid system-topic event-subscription delete コマンドを使用します。 次に例を示します。

az eventgrid system-topic event-subscription delete --name EVENTSUBSCRIPTIONNAME --resourcegroup RESOURCEGROUPNAME --system-topic-name SYSTEMTOPICNAME

システム トピックを削除するには、az eventgrid system-topic delete コマンドを使用します。 次に例を示します。

az eventgrid system-topic delete --name SYSTEMTOPICNAME --resource-group RESOURCEGROUPNAME

フィルター処理の例

特定のクラスターを使用して Azure Kubernetes Cluster Scheduled Events をサブスクライブする

サブスクライバー側で、特定のクラスターによって Azure Kubernetes Cluster Scheduled Events をフィルター処理したい場合があるかもしれません。 このフィルター処理は、自分が関心のあるクラスターからの通知のみを受け取るようにする上で役に立ちます。

az eventgrid system-topic event-subscription create \
 --name EVENTSUBSCRIPTIONNAME \
 --resource-group RESOURCEGROUPNAME \
 --system-topic-name SYSTEMTOPICNAME \
 --included-event-types Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted \
 --endpoint /subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBNAMESPACE/eventhubs/EVENTHUBNAME \
 --endpoint-type evenhub \
 --advanced-filter data.resourceInfo.properties.resources StringContains clusterName

イベント状態 "完了" を使用して Azure Kubernetes Cluster Scheduled Events をサブスクライブする

サブスクライバー側で、たとえば "完了" などの特定の状態によって Azure Kubernetes Cluster Scheduled Events をフィルター処理したい場合があるかもしれません。 このフィルター処理は、自分が関心のあるイベントからの通知のみを受け取るようにする上で役に立ちます。

az eventgrid system-topic event-subscription create \
 --name EVENTSUBSCRIPTIONNAME \
 --resource-group RESOURCEGROUPNAME \
 --system-topic-name SYSTEMTOPICNAME \
 --included-event-types Microsoft.ResourceNotifications.ContainerServiceEventResources.ScheduledEventEmitted \
 --endpoint /subscriptions/000000000-0000-0000-0000-0000000000000/resourceGroups/RESOURCEGROUPNAME/providers/Microsoft.EventHub/namespaces/EVENTHUBNAMESPACE/eventhubs/EVENTHUBNAME \
 --endpoint-type evenhub \
 --advanced-filter data.resourceInfo.properties.eventStatus StringContains Completed

お問い合わせ

この機能について質問またはフィードバックがある場合は、ご遠慮なく arnsupport@microsoft.com までお問い合わせください。

特定のイベントについての特定のフィードバックがさらに適切に処理されるように、次の情報を提供してください。

見つからないイベントの場合:

  • システム トピックの種類の名前
  • 操作が実行された時点のおおよそのタイムスタンプ (UTC)
  • 通知が生成されたベース リソース ID
  • Azure portal でリソースに移動し、右端にある JSON ビューを選択します。 リソース ID は、JSON ビュー ページの最初のフィールドです。
  • 予期されるイベントの種類
  • 実行された操作 (起動または停止した VM、作成されたストレージ アカウントなど)
  • 発生した問題の説明 (VM は起動したが Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged イベントが生成されない、など)
  • 可能であれば、実行された操作の関連付け ID を入力してください

遅延したコンテンツや予期しないコンテンツを含むイベントの場合

  • システム トピックの種類の名前
  • 通知のすべての内容 (data.resourceInfo.properties を除く)
  • 発生した問題と影響を受けたフィールド値の説明

このデータを共有する際は、エンド ユーザーを特定できる情報を提供しないでください。

次のステップ

これらのイベントの詳細については、「Azure リソース通知 - コンテナー サービス イベント」を参照してください。