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. Accedi alla tua console AWS all'indirizzo https://console.aws.amazon.com/events/.

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

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

4. Scegli Crea regola.

5. Nella pagina di dettaglio della regola predefinita, assegna un nome alla regola.

6. Scegli Rule with an event pattern (Regola con un modello di eventi), quindi seleziona Next (Successivo).

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

8. In Tipo di evento di esempio, scegli AWS Events.

9. Per Metodo di creazione, scegli Modello personalizzato.

10. Nella sezione Modello di evento, aggiungi un JSON con origine dell'evento aws:one e il tipo di dettaglio richiesto:

    
           "
           source": ["aws.one"],
           "detail-type": ["New Successful Enrollment", 
           "New Successful Un-enrollment",
           "Unsuccessful Enrollment", 
           "Unsuccessful Un-enrollment", 
           "Successful Recognition", 
           "Unsuccessful Recognition"]
           }
                

    Puoi scegliere il tipo di dettaglio richiesto dall'elenco precedente e rimuovere ciò che non è richiesto.

11. Scegli Next (Successivo).

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

    Ad esempio, per vedere quando qualcuno arriva, scegli «Riconoscimento riuscito». Quindi guarda i dettagli dell'evento (riportati nell'Appendice) per vedere chi ha partecipato.

    Per completare il flusso di lavoro, puoi eseguire un'API esterna o un altro obiettivo.

13. Facoltativamente, puoi configurare i tag.

14. 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 in JSON. Per ogni tipo di evento, viene inviato un blob JSON alla destinazione di tua scelta, 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 è passata a online

Il dispositivo è connesso a Internet.

risorse

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

metadata

Nome del sito

• Nome del sito in cui è presente DeviceInstance.

SiteRan

• Arn per il sito in cui è presente DeviceInstance.

dati

Connettività attuale

• Indica se DeviceInstance è connesso o disconnesso da Internet.

• Valori possibili: CONNECTED, DISCONNECTED

CONNETTIVITÀ PRECEDENTE

• 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 di integrità.

• Valori possibili: HEALTHY, CRITICAL

previousHealthStatus

• Indica se DeviceInstance ha superato tutti i controlli di integrità all'ultimo controllo.

• Valori possibili: HEALTHY, CRITICAL

assetTagId

• Il assetTagId dispositivo associato a DeviceInstance.

deviceInstanceName

• Il nome della DeviceInstance per la 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 annullamento dell'iscrizione avvenuto 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.

Fonte della richiesta

• Questo è il deviceInstanceId dispositivo che ha avviato la richiesta.

Timestamp creato

• L'ora della creazione dell'evento.

Status dell'utente

• Lo stato attuale dell'utente.

• Valori possibili: ACTIVE, DELETED

ID associato

• 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

Lo stato di salute del dispositivo è stato modificato in integro

Il dispositivo ha superato tutte le condizioni e lo stato di salute dell'istanza del dispositivo è passato da STATO CRITICO a SANO.

{
    "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 è passato a CRITICO da 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"
    }
  }
}

La connettività del dispositivo è passata a online

Il dispositivo è connesso a Internet e lo stato di connettività dell'istanza del dispositivo è cambiato in CONNESSO da DISCONNESSO.

{
  "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 DISCONNESSO da CONNESSO.

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