Configurazione delle notifiche Pub/Sub

Puoi utilizzare Pub/Sub per ricevere notifiche quando si verificano eventi clinici nei datastore dell'API Cloud Healthcare. Queste notifiche ti informano quando:

• Un'istanza DICOM viene archiviata in un archivio DICOM utilizzando il metodo dicomStores.dicomWeb.studies.storeInstances o importata da Cloud Storage con dicomStores.notificationConfig.
• Un'istanza DICOM viene archiviata, importata, aggiornata o eliminata in un archivio DICOM utilizzando dicomStores.notificationConfigs.
• Una risorsa FHIR viene creata, aggiornata o eliminata in un archivio FHIR. Tuttavia, le notifiche non vengono inviate quando una risorsa FHIR viene importata da Cloud Storage.
• Un messaggio HL7v2 viene importato o creato in un archivio HL7v2 per la prima volta. I messaggi duplicati non attiveranno una notifica.

Quando si verifica uno di questi eventi, l'API Cloud Healthcare pubblica un messaggio in una risorsa Pub/Sub denominata argomento. Il messaggio può quindi essere ricevuto dalle applicazioni sottoscritte all'argomento.

Per DICOM e HL7v2, questi messaggi non contengono informazioni personali. Sono inclusi solo i seguenti elementi:

• Il progetto per cui viene generato il messaggio
• L'ID messaggio
• Nei messaggi HL7v2, il tipo di messaggio HL7v2

I messaggi FHIR Pub/Sub possono contenere informazioni personali. Per saperne di più, consulta Notifiche FHIR contenenti dati delle risorse FHIR.

Per una panoramica sull'utilizzo delle notifiche Pub/Sub con l'API Cloud Healthcare, consulta Notifiche Pub/Sub.

Prima di iniziare

Rivedi le quote di Pub/Sub

Prima di configurare le notifiche Pub/Sub, acquisisci familiarità con quote e limiti di Pub/Sub. Per informazioni su come visualizzare le quote, richiedere valori di quota più elevati e cosa succede se esaurisci la quota, consulta la documentazione di Quote Cloud.

Abilita l'API Pub/Sub

Per abilitare l'API Pub/Sub, fai clic sul pulsante seguente:

Abilitare l'API

Configurare le autorizzazioni Pub/Sub

Per consentire a Pub/Sub la pubblicazione dei messaggi dall'API Cloud Healthcare, devi aggiungere il ruolo pubsub.publisher all'account di servizio dell'agente di servizio Cloud Healthcare del progetto. Per i passaggi per aggiungere il ruolo richiesto, consulta Autorizzazioni Pub/Sub per archivi DICOM, FHIR e HL7v2.

crea un argomento Pub/Sub

Devi configurare un argomento Pub/Sub per ogni datastore per il quale vuoi ricevere notifiche. I singoli datastore possono avere i propri argomenti Pub/Sub oppure più datastore possono condividere lo stesso argomento. Puoi creare un argomento utilizzando la console Google Cloud o Google Cloud CLI.

Quando crei un argomento o vi fai riferimento nella configurazione di un datastore, devi utilizzare un URI qualificato nel seguente formato:

projects/PROJECT_ID/topics/TOPIC_NAME

dove PROJECT_ID è l'ID progetto Google Cloud e TOPIC_NAME è il nome dell'argomento.

Per creare un argomento, completa i seguenti passaggi:

gcloud pubsub topics create projects/PROJECT_ID/topics/TOPIC_NAME

Created topic [projects/PROJECT_ID/topics/TOPIC_NAME].

Crea una sottoscrizione Pub/Sub

Per ricevere messaggi pubblicati in un argomento, devi creare una sottoscrizione Pub/Sub. Ogni argomento Pub/Sub deve avere almeno una sottoscrizione Pub/Sub.

La sottoscrizione collega l'argomento a un'applicazione del sottoscrittore che riceve ed elabora i messaggi pubblicati nell'argomento.

Le sottoscrizioni possono essere configurate in modo da utilizzare un modello push o un modello pull.

Le sottoscrizioni possono essere configurate per filtrare i messaggi in base ai relativi attributi. Consulta le istruzioni per filtrare i messaggi di una sottoscrizione.

Per creare un abbonamento:

gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

Created subscription [projects/PROJECT_ID/subscriptions/TOPIC_NAME].

Visualizzare le notifiche relative alle istanze DICOM archiviate

Per informazioni sull'utilizzo delle notifiche Pub/Sub con i dati DICOM, consulta Notifiche Pub/Sub DICOM.

Visualizzare le notifiche HL7v2

La risorsa Hl7V2Store contiene un array notificationConfigs in cui puoi specificare argomenti Pub/Sub e criteri di filtro.

Quando un messaggio HL7v2 viene importato o creato in un archivio HL7v2, l'API Cloud Healthcare pubblica un messaggio negli argomenti Pub/Sub che hanno un filtro corrispondente al messaggio HL7v2.

Per visualizzare una notifica per un messaggio HL7v2 importato, completa i seguenti passaggi:

1. Crea o modifica un archivio HL7v2 e configuralo con un argomento Pub/Sub.
2. Aggiungi il ruolo pubsub.publisher richiesto all'account di servizio del progetto.
3. Importa un messaggio HL7v2 nell'archivio HL7v2. In questo modo l'API Cloud Healthcare pubblica un messaggio nell'argomento Pub/Sub configurato.

4. Per visualizzare il messaggio pubblicato nell'argomento Pub/Sub, esegui il comando gcloud pubsub subscriptions pull:

   gcloud pubsub subscriptions pull --auto-ack projects/PROJECT_ID/subscriptions/PUBSUB_SUBSCRIPTION

   Il comando restituisce il seguente output sul messaggio HL7v2 importato:

   ┌--------------------------------------------------------------------------------------------------------------------|-----------------|---------------┐
   |                                                                 DATA                                               |    MESSAGE_ID   |   ATTRIBUTES  |
   ├--------------------------------------------------------------------------------------------------------------------|-----------------|---------------|
   | projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/hl7V2Stores/HL7V2_STORE_ID/messages/HL7V2_MESSAGE_ID | 123456789012345 | msgType=TYPE  |
   └--------------------------------------------------------------------------------------------------------------------|-----------------|---------------┘

API Cloud Healthcare e criteri di archiviazione dei messaggi Pub/Sub

Per garantire che i dati dell'API Cloud Healthcare e i dati associati nei messaggi Pub/Sub si trovino nella stessa regione, devi impostare un criterio di archiviazione dei messaggi Pub/Sub.

Devi impostare esplicitamente il criterio di archiviazione dei messaggi nell'argomento Pub/Sub configurato nell'datastore per assicurarti che i dati rimangano nella stessa regione. Ad esempio, se il set di dati e l'archivio FHIR dell'API Cloud Healthcare si trovano in us-central1, il criterio di archiviazione dei messaggi deve consentire solo la regione us-central1.

Per configurare una policy di archiviazione dei messaggi, consulta Configurare le policy di archiviazione dei messaggi.

Risolvere i problemi relativi ai messaggi Pub/Sub mancanti

Se una notifica non può essere pubblicata su Pub/Sub, viene registrato un errore in Cloud Logging. Per saperne di più, consulta Visualizzazione dei log degli errori in Cloud Logging.

Se la frequenza di generazione degli errori supera un limite, gli errori in eccesso rispetto al limite non vengono inviati a Cloud Logging.

Passaggi successivi

Scopri come configurare un argomento Pub/Sub in:

• Un archivio DICOM
• Un archivio FHIR
• Un archivio HL7v2