Amazon One Enterprise イベントをサブスクライブするデバイスステータス変更イベントタイプユーザープロファイルイベントタイプイベント例デバイスのヘルスステータスが正常に変更されましたデバイスのヘルスステータスがクリティカルに変更されましたデバイス接続がオンラインに変更されましたデバイス接続がオフラインに変更されました新規登録成功

Amazon での Amazon One Enterprise イベントのモニタリング EventBridge

で Amazon One Enterprise イベントをモニタリングできます。これにより EventBridge、独自のアプリケーション、 software-as-a-service (SaaS ) アプリケーション、および AWS サービスからリアルタイムデータのストリームが配信されます。 EventBridgeは、そのデータを AWS Lambda や Amazon Simple Notification Service などのターゲットにルーティングします。これらのイベントは、 AWS リソースの変更を記述するシステムイベントのほぼリアルタイムのストリームを提供します。

Amazon One デバイスとユーザープロファイルのステータス変更イベントは、を使用して公開され EventBridge、新しいルールを作成することで EventBridge コンソールで有効にできます。イベントは順序付けされていませんが、データの使用に役立つタイムスタンプがあります。イベントは、ベストエフォートベースで出力されます。

Amazon One Enterprise イベントをサブスクライブするには

で EventBridge コンソールを開きますhttps://console.aws.amazon.com/events/。
ナビゲーションペインのバスで、ルール を選択します。
ルールの作成を選択します。
[Default rule detail] (デフォルトルール詳細) ページで、ルールに名前を割り当て、[Rule with an event pattern] (イベントパターンを持つルール) を選択し、[Next] (次へ) を選択します。
イベントソース のイベントパターンの構築ページで、AWS イベントまたは EventBridge パートナーイベントが選択されていることを確認します。
サンプルイベントタイプ で、自分のを入力 を選択します。
のいずれかからコピーして貼り付けますイベント例。
作成方法 で、カスタムパターン を選択します。イベントパターンセクションで、イベントソースを aws:oneとして、必要な詳細タイプJSONを持つを追加し、次へを選択します。
ターゲットを選択 (複数可） ページで、Lambda 関数、SQSキュー、またはSNSトピックを含む、任意のターゲットを選択します。ターゲットの設定の詳細については、「Amazon EventBridge ターゲット」を参照してください。
必要に応じて、タグを設定できます。
[Review and create] (確認して作成) ページで、[Create rule] (ルールの作成) を選択します。ルールの設定の詳細については、 EventBridge 「ユーザーガイド」の EventBridge「ルール」を参照してください。

デバイスステータス変更イベントタイプ

デバイスステータスの変更イベントはで生成されますJSON。イベントタイプごとに、ルールで設定されたように、選択したターゲットに BLOB JSON が送信されます。次の詳細タイプを使用できます。

デバイスのヘルスステータスが正常に変更されました: デバイスはすべてのヘルスチェックに合格しました。
デバイスのヘルスステータスが重大に変更されました: デバイスが 1 つ以上のヘルスチェックに失敗しました。
デバイス接続がオフラインに変更されました: デバイスがインターネットに接続されていません。
デバイス接続がオンラインに変更されました: デバイスはインターネットに接続されています。

イベントオブジェクト

リソース

Device Status Change イベントが公開された deviceInstance arn のリストが含まれます。

metadata

siteName

deviceInstance が存在するサイトの名前。

siteArn

deviceInstance が存在するサイトの Arn。

データ

currentConnectivity

deviceInstance がインターネットに接続されているか、インターネットから切断されているかを表します。
可能な値: CONNECTED、 DISCONNECTED

previousConnectivity

イベント前にがインターネットに接続されていたか、インターネットから切断 deviceInstance されていたかを表します。
可能な値: CONNECTED、 DISCONNECTED

currentHealthStatus

deviceInstance がすべてのヘルスチェックに合格したかどうかを表します。
可能な値: HEALTHY、 CRITICAL

previousHealthStatus

が最後にチェックしたときにすべてのヘルスチェックに deviceInstance 合格したかどうかを表します。
可能な値: HEALTHY、 CRITICAL

assetTagId

に関連付けられた assetTagId デバイスの deviceInstance。

deviceInstanceName

Device Status Event が発行された deviceInstance の名前。

ユーザープロファイルイベントタイプ

ユーザープロファイル関連のイベントの詳細タイプは次のとおりです。

新規登録成功: ユーザーが正常に登録されたとき。
新規登録解除成功: ユーザーが正常に登録解除されたとき。
登録失敗: ユーザーが登録に失敗したとき。
登録解除に失敗しました: ユーザーが登録解除に失敗したとき。
正常な認識: ユーザーが認証のためにパームを正常にスキャンしたとき。
失敗した認識: パームスキャンの認識が失敗したとき。

イベントオブジェクト

リソース

ユーザープロファイルイベントが公開されたユーザープロファイル arn のリストが含まれます。

データ

accountId

リクエストを開始したデバイスの関連 AWS アカウント。

requestSource

これは、リクエストを開始した deviceInstanceId デバイスのです。

createdTimestamp

イベントの作成時刻。

userStatus

ユーザーの現在のステータス。
可能な値: ACTIVE、 DELETED

associatedId

バッジ ID など、ユーザーの関連付けられた ID。

理由

この値は、失敗したイベントに表示されます。これには、イベントが失敗した理由が含まれます。

イベント例

次の例は、Amazon One Enterprise のイベントを示しています。

デバイスのヘルスステータスが正常に変更されました

デバイスはすべてのヘルスを合格し、デバイスインスタンスのヘルスステータスはCRITICALヘルスステータスHEALTHYからに変更されました。


{
    "version": "0",
    "id": "11232345564-96a4-ef3f-b739-b6aa5b193afb",
    "detail-type": "Device Health Status Changed To Healthy",
    "source": "aws.one",
    "account": "123456789012",
    "time": "2022-10-22T18:43:48Z",
    "region": "us-east-1",
    "resources": ["arn:aws:one:us-east-1:123456789012:device-instance/12345678901234"],
    "detail": {
    "version": "1.0.0",
    "metadata": {
      "siteName": "Site name",
      "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
    },
    "data": {
      "currentHealthStatus": "HEALTHY",
      "previousHealthStatus": "CRITICAL",
      "assetTagId": "0000195169",
      "deviceInstanceName": "Device name"
    }
  }
}

デバイスのヘルスステータスがクリティカルに変更されました

デバイスが 1 つ以上のヘルスチェックに失敗し、デバイスインスタンスのヘルスステータスが CRITICALからに変更されましたHEALTHY。


{
  "version": "0",
  "id": "11232345564-96a4-ef3f-b739-b6aa5b193afb",
  "detail-type": "Device Health Status Changed To Critical",
  "source": "aws.one",
  "account": "123456789012",
  "time": "2022-10-22T18:43:48Z",
  "region": "us-east-1",
  "resources": ["arn:aws:one:us-east-1:123456789012:device-instance/12345678901234"],
  "detail": {
    "version": "1.0.0",
    "metadata": {
      "siteName": "Site name",
      "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
    },
    "data": {
      "currentHealthStatus": "CRITICAL",
      "previousHealthStatus": "HEALTHY",
      "assetTagId": "0000195169",
      "deviceInstanceName": "Device name"
    }
  }
}

デバイス接続がオンラインに変更されました

デバイスがインターネットに接続され、デバイスインスタンスの接続ステータスが CONNECTEDからに変更されましたDISCONNECTED。


{
  "version": "0",
  "id": "11232345564-96a4-ef3f-b739-b6aa5b193afb",
  "detail-type": "Device Connectivity Changed To Online",
  "source": "aws.one",
  "account": "123456789012",
  "time": "2022-10-22T18:43:48Z",
  "region": "us-east-1",
  "resources": ["arn:aws:one:us-east-1:123456789012:device-instance/12345678901234"],
  "detail": {
    "version": "1.0.0",
    "metadata": {
      "siteName": "Site name",
      "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
    },
    "data": {
      "currentConnectivity": "CONNECTED",
      "previousConnectivity": "DISCONNECTED",
      "assetTagId": "0000195169",
      "deviceInstanceName": "Device name"
    }
  }
}

デバイス接続がオフラインに変更されました

デバイスがインターネットに接続されておらず、デバイスインスタンスの接続ステータスが DISCONNECTEDからに変更されましたCONNECTED。


{
  "version": "0",
  "id": "11232345564-96a4-ef3f-b739-b6aa5b193afb",
  "detail-type": "Device Connectivity Changed To Offline",
  "source": "aws.one",
  "account": "123456789012",
  "time": "2022-10-22T18:43:48Z",
  "region": "us-east-1",
  "resources": ["arn:aws:one:us-east-1:123456789012:device-instance/12345678901234"],
  "detail": {
    "version": "1.0.0",
    "metadata": {
      "siteName": "Site name",
      "siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
    },
    "data": {
      "currentConnectivity": "DISCONNECTED",
      "previousConnectivity": "CONNECTED",
      "assetTagId": "0000195169",
      "deviceInstanceName": "Device name"
    }
  }
}

新規登録成功

ユーザーが正常に登録されたイベント。


{
    "version": "0",
    "id": "aebc9c86-f20e-75db-caaa-63bf14926f59",
    "detail-type": "New Successful Enrollment",
    "source": "aws.one",
    "account": "679792848029",
    "time": "2023-11-22T02:55:17Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:one:us-east-1:679792848029:user"
    ],
    "detail": {
        "version": "1.0.0",
        "data": {
            "accountId": "679792848029",
            "enrollmentSource": "QfUuUnFqs5accJ",
            "createdTimestamp": "2023-11-22T02:55:17Z",
            "userStatus": "ACTIVE",
            "associatedIds": "[{\"associatedIdType\":\"badge\",\"associatedIdValue\":\"1111358294500\"}]",
        }
    }
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

モニタリング

CloudTrail ログ