Monitoraggio degli eventi di Amazon One Enterprise su Amazon EventBridge

Puoi monitorare gli eventi di Amazon One Enterprise in EventBridge, che fornisce un flusso di dati in tempo reale dalle tue applicazioni, applicazioni software-as-a-service (SaaS) e AWS servizi. EventBridgeindirizza tali dati verso obiettivi come Amazon AWS Lambda Simple Notification Service. Questi eventi forniscono un flusso quasi in tempo reale di eventi di sistema che descrivono i cambiamenti nelle AWS risorse.

Iscriviti agli eventi di Amazon One Enterprise

Gli eventi di modifica dello stato del dispositivo e del profilo utente di Amazon One vengono pubblicati utilizzando EventBridge e possono essere abilitati nella EventBridge console creando una nuova regola. Sebbene gli eventi non siano ordinati, hanno un timestamp che consente di utilizzare i dati. Gli eventi vengono emessi secondo il principio del massimo sforzo.

Per iscriversi agli eventi Amazon One Enterprise

1. Apri la EventBridge console all'indirizzo https://console.aws.amazon.com/events/.

2. Nel pannello di navigazione, in Autobus, scegli Regole.

3. Scegli Crea regola.

4. Nella pagina di dettaglio della regola predefinita, assegna un nome alla regola, scegli Regola con un modello di evento, quindi scegli Avanti.

5. Nella pagina Crea modello di eventi, in Origine evento, verifica che siano selezionati AWS gli eventi o gli eventi dei EventBridge partner.

6. In Tipo di evento di esempio, scegli Inserisci il mio.

7. Copia e incolla da uno deiEventi di esempio.

8. Per Metodo di creazione, scegli Modello personalizzato. Nella sezione Schema di evento, aggiungi una fonte di eventi JSON con origine eventi aws:one e il tipo di dettaglio richiesto, quindi scegli Avanti.

9. Nella pagina Seleziona obiettivi, seleziona un obiettivo a tua scelta, che include una funzione, una SQS coda o un argomento Lambda. SNS Per informazioni sulla configurazione degli obiettivi, consulta Amazon EventBridge targets.

10. Facoltativamente, puoi configurare i tag.

11. Nella pagina Esamina e crea, scegli Crea regola. Per ulteriori informazioni sulla configurazione delle regole, consulta le EventBridgeregole nella Guida per l' EventBridge utente.

Tipi di eventi di modifica dello stato del dispositivo

Gli eventi di modifica dello stato del dispositivo vengono generati inJSON. Per ogni tipo di evento, viene inviato un JSON blob alla destinazione prescelta, come configurato nella regola. Sono disponibili i seguenti tipi di dettagli:

Lo stato di salute del dispositivo è stato modificato in integro

Il dispositivo ha superato tutti i controlli sanitari.

Lo stato di salute del dispositivo è stato modificato in critico

Il dispositivo non ha superato uno o più controlli di integrità.

La connettività del dispositivo è stata modificata in modalità offline

Il dispositivo non è connesso a Internet.

La connettività del dispositivo è stata modificata in linea

Il dispositivo è connesso a Internet.

risorse

Contiene l'elenco degli deviceInstance arn per i quali è stato pubblicato l'evento Device Status Change.

metadata

siteName

• Nome del sito in cui deviceInstance è presente.

siteArn

• Arn per il sito in cui deviceInstance è presente.

dati

currentConnectivity

• Indica se deviceInstance è connesso o disconnesso da Internet.

• Valori possibili:CONNECTED, DISCONNECTED

previousConnectivity

• Indica se deviceInstance era connesso o disconnesso da Internet prima dell'evento.

• Valori possibili:CONNECTED, DISCONNECTED

currentHealthStatus

• Indica se deviceInstance ha superato tutti i controlli sanitari.

• Valori possibili:HEALTHY, CRITICAL

previousHealthStatus

• Indica se deviceInstance ha superato tutti i controlli sanitari all'ultimo controllo.

• Valori possibili:HEALTHY, CRITICAL

assetTagId

• Il assetTagId dispositivo associato adeviceInstance.

deviceInstanceName

• Il nome del evento deviceInstance per il quale è stato pubblicato l'evento di stato del dispositivo.

Tipi di eventi del profilo utente

I tipi di dettagli degli eventi relativi al profilo utente sono:

Nuova iscrizione avvenuta con successo

Quando un utente si è registrato con successo.

Nuova cancellazione avvenuta con successo

Quando un utente ha annullato la registrazione con successo.

Iscrizione non riuscita

Quando un utente non è riuscito a registrarsi.

Annullamento della registrazione non riuscito

Quando un utente non è riuscito ad annullare la registrazione.

Riconoscimento riuscito

Quando un utente esegue correttamente la scansione del palmo per l'autenticazione.

Riconoscimento non riuscito

Quando il riconoscimento di una scansione del palmo non è riuscito.

Oggetti eventi

risorse

Contiene l'elenco degli arn del profilo utente per i quali è stato pubblicato l'evento del profilo utente.

dati

accountId

• L' AWS account pertinente per il dispositivo che ha avviato la richiesta.

requestSource

• Si tratta deviceInstanceId del dispositivo che ha avviato la richiesta.

createdTimestamp

• L'ora della creazione dell'evento.

userStatus

• Lo stato attuale dell'utente.

• Valori possibili:ACTIVE, DELETED

associatedId

• L'id associato dell'utente, ad esempio l'id del badge.

motivo

• Questo valore verrà visualizzato in caso di eventi non riusciti. Contiene il motivo per cui l'evento non ha avuto successo.

Eventi di esempio

Gli esempi seguenti mostrano gli eventi per Amazon One Enterprise.

Argomenti

• Lo stato di salute del dispositivo è stato modificato in integro
• Lo stato di salute del dispositivo è passato a critico
• La connettività del dispositivo è passata a online
• La connettività del dispositivo è passata a offline
• Nuova iscrizione avvenuta con successo

Lo stato di salute del dispositivo è stato modificato in integro

Il dispositivo ha superato lo stato di integrità e lo stato di integrità dell'istanza del dispositivo è passato HEALTHY da stato di CRITICAL salute a stato di integrità.

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

Lo stato di salute del dispositivo è passato a critico

Il dispositivo non ha superato uno o più controlli di integrità e lo stato di integrità dell'istanza del dispositivo è cambiato in CRITICAL daHEALTHY.

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

La connettività del dispositivo è passata a online

Il dispositivo è connesso a Internet e lo stato di connettività dell'istanza del dispositivo è cambiato in CONNECTED daDISCONNECTED.

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

La connettività del dispositivo è passata a offline

Il dispositivo non è connesso a Internet e lo stato di connettività dell'istanza del dispositivo è cambiato in DISCONNECTED daCONNECTED.

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

Nuova iscrizione avvenuta con successo

Un evento quando un utente si è registrato con successo.

{
    "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\"}]",
        }
    }
}