View a markdown version of this page

Usare EventBridge con AWS HealthOmics - AWS HealthOmics

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Usare EventBridge con AWS HealthOmics

HealthOmics invia eventi ad Amazon EventBridge quando le risorse cambiano stato. Le risorse includono processi di importazione, processi di esportazione, condivisioni di risorse, flussi di lavoro, attività ed esecuzioni. Per ogni tipo di risorsa, è disponibile un elenco di modifiche allo stato che generano un evento.

Un bus di eventi è un router che riceve eventi e li invia alle destinazioni. L'account include un bus di eventi predefinito che riceve automaticamente gli eventi dai AWS servizi. È possibile creare bus di eventi personalizzati aggiuntivi.

Si creano EventBridge regole per specificare le azioni da intraprendere quando il bus degli eventi riceve degli eventi. Ad esempio, è possibile creare una regola che notifica le modifiche di stato di una risorsa.

Gli scenari più comuni per l'utilizzo degli eventi includono:

  • Per monitorare quando un utente condivide una risorsa con te o revoca la condivisione.

  • Per monitorare se un'esecuzione fallisce o viene completata correttamente.

Per ulteriori informazioni sull'utilizzo EventBridge, consulta Cos'è Amazon EventBridge?

Configurare EventBridge per HealthOmics

Prima di poter monitorare gli EventBridge eventi, crea un EventBridge bus e crea regole per gli eventi di interesse.

Configura un EventBridge bus

È possibile utilizzare il bus di eventi predefinito per il proprio bus di eventi Account AWS o configurare un bus di eventi personalizzato. Per configurare un bus di eventi personalizzato, segui questi passaggi:

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

  2. Nella barra di navigazione a sinistra, scegli Event buses.

  3. Scegliere Create event bus (Crea bus di eventi).

  4. Nel modulo Crea bus per eventi, inserisci un nome per l'autobus.

  5. Scegli Crea per creare il bus.

Crea una EventBridge regola

La procedura seguente mostra come creare una regola semplice. Per ulteriori informazioni sulle regole, vedere Regole in EventBridge.

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

  2. Nel riquadro di navigazione di sinistra seleziona Rules (Regole).

  3. Scegli Crea regola. La console apre il modulo Crea regola.

  4. In Definisci i dettagli della regola, fornisci un nome per la regola.

    • In Nome, inserisci un nome per il bus.

    • Per Event bus, seleziona il bus per questa regola.

    • Scegli Avanti.

  5. In Build event pattern, in Event source seleziona AWS events o EventBridge partner events.

  6. Scorri verso il basso fino a Event pattern.

    1. Per Origine dell'evento, seleziona Servizi AWS.

    2. Per il servizio AWS, inserisci omics nel filtro di testo e seleziona AWS HealthOmics come servizio.

    3. Per Tipo di evento seleziona l'evento di interesse (o Tutti gli eventi).

    4. Scegli Avanti.

  7. In Seleziona obiettivi, seleziona un obiettivo per l'evento. Ad esempio, scegli il servizio AWS, il gruppo di CloudWatch log scelto e configura un gruppo di log.

    Per molti tipi di target, EventBridge necessita dell'autorizzazione per l'invio degli eventi. La console crea queste autorizzazioni per te.

  8. (Facoltativo) In Configure tags, associa i tag alla regola.

  9. In Revisione e aggiornamento, rivedi la configurazione e scegli Crea regola.

EventBridge eventi in HealthOmics

La tabella seguente elenca gli eventi a EventBridge cui vengono HealthOmics inviati e l'elenco dei possibili valori di stato per l'evento.

Nome evento Valori di stato possibili
Modifica dello stato del processo di importazione delle annotazioni Inviato, in corso, annullato, completato, non riuscito o completato con errori
Modifica dello stato della condivisione di Annotation Store In sospeso, in fase di attivazione, attivo, in eliminazione, eliminato, non riuscito
Modifica dello stato di Annotation Store Creazione, creazione, aggiornamento, aggiornamento, eliminazione, eliminazione o creazione non riuscita
Leggi Imposta modifica dello stato del processo di attivazione Inviato, in corso, completato, non riuscito o completato con errori
Leggi Imposta modifica dello stato del lavoro di esportazione Inviato, in corso, completato, non riuscito o completato con errori
Leggi Imposta modifica dello stato del processo di importazione Inviato, in corso, completato, non riuscito o completato con errori
Leggi Set Status Change Elaborazione del caricamento, caricamento non riuscito, attivo, archiviato, in fase di attivazione o eliminato
Modifica dello stato del processo di importazione di riferimento Inviato, in corso, completato, non riuscito o completato con errori
Modifica dello stato di riferimento Attivo o eliminato
Modifica dello stato del negozio di riferimento Creato, aggiornato, attivo o eliminato
Esegui modifica dello stato In sospeso, in avvio, in esecuzione, in arresto, completato, eliminato, fallito o annullato
Modifica dello stato di Sequence Store Creato, aggiornato, attivo o eliminato
Modifica dello stato dell'attività In sospeso, in avvio, in esecuzione, in arresto, completato, eliminato, fallito o annullato
Modifica dello stato del processo di importazione della variante Inviato, in corso, annullato, completato, non riuscito o completato con errori
Modifica dello stato di Variant Store Share In sospeso, in fase di attivazione, attiva, in eliminazione, eliminata, non riuscita
Modifica dello stato del Variant Store Creazione, creazione, aggiornamento, aggiornamento, eliminazione, eliminazione o creazione non riuscita
Modifica dello stato di condivisione del flusso di lavoro In sospeso, in fase di attivazione, attiva, in eliminazione, eliminata, non riuscita
Modifica dello stato del flusso di lavoro Creazione riuscita, creazione fallita, eliminazione riuscita o eliminazione fallita

Struttura del messaggio di evento

HealthOmics fornisce la soluzione ottimale per inviare messaggi relativi agli eventi di modifica dello stato a. EventBridge L'evento è un oggetto con struttura JSON che contiene anche dettagli sui metadati. È possibile utilizzare i metadati come input per ricreare l'evento o per ottenere ulteriori informazioni. Gli eventi includono i seguenti campi:

  • version— Attualmente 0 (zero) per tutti gli eventi.

  • id— Un UUID della versione 4 generato per ogni evento.

  • detail-type— Il tipo di evento che viene inviato.

  • account— L' Account AWS ID a 12 cifre del proprietario del bucket.

  • source— Identifica il servizio che ha generato l'evento.

  • time— L'ora in cui si è verificato l'evento.

  • region— Identifica la data Regione AWS del secchio.

  • resources— Un array JSON che contiene l'Amazon Resource Name (ARN) del bucket.

  • detail— Un oggetto JSON che contiene informazioni sull'evento.

Gli eventi di esecuzione includono i seguenti campi:

  • uuid— L'identificatore univoco universale per la corsa.

  • workflowId— Identificatore del flusso di lavoro associato a questa esecuzione.

  • workflowName— Nome del flusso di lavoro associato a questa esecuzione..

  • runId— Identificatore dell'esecuzione.

  • runName— Nome della corsa.

  • runOutputUri— L'URI in cui l'esecuzione scriverà i dati di output.

Esempi di messaggi di evento

L'esempio seguente è un evento per una modifica dello stato di esecuzione, che mostra i campi aggiuntivi.

{ "version":"0", "id":"c0e540f4-df38-b986-86c1-3e3730f971fe", "detail-type":"Run Status Change", "source":"aws.omics", "account":"123456789012", "time":"2022-10-20T22:07:35Z", "region":"us-west-2", "resources":[ "arn:aws:omics:us-west-2:123456789012:run/2101313" ], "detail":{ "omicsVersion":"1.0.0", "arn":"arn:aws:omics:us-west-2:123456789012:run/2101313", "status":"COMPLETED", "uuid":"153893cd-097a-40ec-aec7-838a97cd2b21", "runId": "1234567", "runName": "run name", "runOutputUri": "s3://amzn-s3-demo-bucket/run-output/2101313", "workflowId": "1234567", "workflowName": "workflow name" } }

L'esempio seguente è un evento per una modifica dello stato dell'attività.

{ "version": "0", "id": "718d6817-c868-26d3-8ef0-0dc9b2ac73f4", "detail-type": "Task Status Change", "source": "aws.omics", "account": "123456789012", "time": "2024-10-30T09:05:44Z", "region": "us-west-2", "resources": ["arn:aws:omics:us-west-2:123456789012:task/8888888"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-west-2:123456789012:task/8888888", "status": "COMPLETED", "runArn": "arn:aws:omics:us-west-2:123456789012:run/2101313", "runUuid": "153893cd-097a-40ec-aec7-838a97cd2b21", "runId": "1234567", "runName": "run name", "workflowId": "1234567", "workflowName": "workflow name" } }

Di seguito è riportato un esempio di evento per una modifica dello stato del set di lettura.

{ "version": "0", "id": "64ca0eda-9751-dc55-c41a-1bd50b4fc9b7", "detail-type": "Read Set Status Change", "source": "aws.omics", "account": "123456789012", "time": "2023-04-04T17:53:06Z", "region": "us-west-2", "resources": ["arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-west-2:123456789012:sequenceStore/1234567890/readSet/3456789012", "sequenceStoreId" : "1234567890", "id": "3456789012", "status": "PROCESSING_UPLOAD" } }

Un evento simile viene creato per un processo di importazione di un negozio di varianti.

{ "version": "0", "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type": "Variant Store Status Change", "source": "aws.omics", "account": "123456789012", "time": "2015-12-22T18:43:48Z", "region": "us-east-1", "resources": ["arn:aws:omics:us-east-1:123456789012:myvariantstore2"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-east-1:123456789012:myvariantstore2", "status": "CREATED", "storeId": "6710c5f02610", "storeName": "myvariantstore2" } }

Di seguito è riportato un evento per la modifica dello stato del processo di importazione.

{ "version": "0", "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718", "detail-type": "Variant Import Job Status Change", "source": "aws.omics", "account": "123456789012", "time": "2015-12-22T18:43:48Z", "region": "us-east-1", "resources": ["arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9"], "detail": { "omicsVersion": "1.0.0", "arn": "arn:aws:omics:us-east-1:123456789012:my_variant_store/b64ea9a3-459f-4b68-92c3-3ddb83209fe9", "status": "COMPLETED", "jobId": "b64ea9a3-459f-4b68-92c3-3ddb83209fe9", "storeId": "a74869f91e20", "storeName": "my_variant_store" } }