What are Events?

Events are a notification and subscription feature in the Azure Health Data Services. Events enable customers to utilize and enhance the analysis and workflows of structured and unstructured data like vitals and clinical or progress notes, operations data, Internet of Medical Things (IoMT) health data, and medical imaging data.

When Fast Healthcare Interoperability Resources (FHIR®) resource changes or Digital Imaging and Communications in Medicine (DICOM) image changes are successfully written to the Azure Health Data Services, the Events feature sends notification messages to Events subscribers. These event notification occurrences can be sent to multiple endpoints to trigger automation ranging from starting workflows to sending email and text messages to support the changes occurring from the health data it originated from. The Events feature integrates with the Azure Event Grid service and creates a system topic for the Azure Health Data Services Workspace.

Important

FHIR resource and DICOM image change data is only written and event messages are sent when the Events feature is turned on. The Event feature doesn't send messages on past resource changes or when the feature is turned off.

Tip

For more information about the features, configurations, and to learn about the use cases of the Azure Event Grid service, see Azure Event Grid

Diagram of data flow from users to a FHIR service and then into the Events pipeline.

Important

Events currently supports only the following operations:

  • FhirResourceCreated - The event emitted after a FHIR resource gets created successfully.

  • FhirResourceUpdated - The event emitted after a FHIR resource gets updated successfully.

  • FhirResourceDeleted - The event emitted after a FHIR resource gets soft deleted successfully.

  • DicomImageCreated - The event emitted after a DICOM image gets created successfully.

  • DicomImageDeleted - The event emitted after a DICOM image gets deleted successfully.

For more information about the FHIR service delete types, see FHIR REST API capabilities for Azure Health Data Services FHIR service

Scalable

Events are designed to support growth and changes in healthcare technology needs by using the Azure Event Grid service and creating a system topic for the Azure Health Data Services Workspace.

Configurable

Choose the FHIR and DICOM event types that you want to receive messages about. Use the advanced features like filters, dead-lettering, and retry policies to tune Events message delivery options.

Note

The advanced features come as part of the Event Grid service.

Extensible

Use Events to send FHIR resource and DICOM image change messages to services like Azure Event Hubs or Azure Functions to trigger downstream automated workflows to enhance items such as operational data, data analysis, and visibility to the incoming data capturing near real time.

Secure

Built on a platform that supports protected health information and customer content data compliance with privacy, safety, and security in mind, the Events messages do not transmit sensitive data as part of the message payload.

Use Azure Managed identities to provide secure access from your Event Grid system topic to the Events message receiving endpoints of your choice.

Next steps

For more information about deploying Events, see

For frequently asks questions (FAQs) about Events, see

For Events troubleshooting resources, see

FHIR® is a registered trademark of Health Level Seven International, registered in the U.S. Trademark Office and is used with their permission.