Frequently asked questions about the MedTech service
MedTech service: The basics
Where is the MedTech service available?
The MedTech service is available in these Azure regions: Products available by region.
Can I use the MedTech service with a different FHIR service other than the Azure Health Data Services FHIR service?
No. The MedTech service currently only supports the Azure Health Data Services FHIR® service for the persistence of transformed device data. The open-source version of the MedTech service supports the use of different FHIR services.
To learn about the MedTech service open-source projects, see Open-source projects.
What versions of FHIR does the MedTech service support?
The MedTech service supports the HL7 FHIR R4 standard.
Why do I have to provide device and FHIR destination mappings to the MedTech service?
The MedTech service requires device and FHIR destination mappings to perform normalization and transformation processes on device data. To learn how the MedTech service transforms device data into FHIR Observations, see Overview of the MedTech service device data processing stages.
Is JsonPathContent still supported by the MedTech service device mapping?
Yes. JsonPathContent can be used as a template type within CollectionContent. It's recommended that CalculatedContent is used as it supports all of the features of JsonPathContent with extra support for more advanced features.
How long does it take for device data to show up in the FHIR service?
The MedTech service buffers FHIR Observations created during the transformation stage and provides near real-time processing. However, this buffer can potentially delay the persistence of FHIR Observations to the FHIR service up to ~five minutes. To learn how the MedTech service transforms device data into FHIR Observations, see Overview of the MedTech service device data processing stages.
Why are the device messages added to the event hub not showing up as FHIR Observations in the FHIR service?
Tip
Having access to MedTech service logs is essential for troubleshooting and assessing the overall health and performance of your MedTech service.
To learn how to troubleshoot MedTech service errors found in the logs, see Troubleshoot errors using the MedTech service logs.
| Potential issue | Fix |
|---|---|
| Data is still being processed. | Data is egressed to the FHIR service in batches (every ~five minutes). It’s possible the data is still being processed and extra time is needed for the data to be persisted in the FHIR service. |
| Device mapping hasn't been configured. | Configure and save a conforming and valid device mapping. |
| FHIR destination mapping hasn't been configured. | Configure and save a conforming and valid FHIR destination mapping. |
| The device message doesn't contain an expected expression defined in the device mapping. | Verify the JsonPath or JMESPath expressions defined in the device mapping match tokens defined in the device message. |
| A Device resource hasn't been created in the FHIR service (Resolution type: Lookup only)*. | Create a valid Device resource in the FHIR service. Ensure the Device resource contains an identifier that matches the device identifier provided in the incoming message. |
| A Patient resource hasn't been created in the FHIR service (Resolution type: Lookup only)*. | Create a valid Patient resource in the FHIR service. |
| The Device.patient reference isn't set, or the reference is invalid (Resolution type: Lookup only)*. | Make sure the Device resource contains a valid reference to a Patient resource. |
* Reference Deploy the MedTech service using the Azure portal for a functional description of the MedTech service resolution types (Create or Lookup).
Does the MedTech service perform backups of device messages?
No. The MedTech service doesn't back up the device messages that is sent to the event hub. The event hub owner controls the device message retention period within their event hub, which can be from one to 90 days. Event hubs can be deployed in three different service tiers. Message retention limits are tier-dependent: Basic one day, Standard 1-7 days, Premium 90 days. If the MedTech service successfully processes the device data, it's persisted in the FHIR service, and the FHIR service backup policy applies.
To learn more about event hub message retention, see What is the maximum retention period for events?
What are the subscription quota limits for the MedTech service?
- (25) MedTech services per Azure subscription (not adjustable).
- (10) MedTech services per Azure Health Data Services workspace (not adjustable).
- (One) FHIR destination* per MedTech service (not adjustable).
* FHIR destination is a child resource of the MedTech service.
I'm receiving authentication errors with my MedTech service after moving my Azure subscription to a different Azure tenant. How do I fix this issue?
If the Azure subscription that your MedTech service was provisioned in has since been moved to a different Azure tenant, you could see failing MedTech service HealthChecks for ExternalEventHub:IsAuthenticated and FhirService:IsAuthenticated. For guidance on how to view these failed HealthChecks, see How to enable diagnostic settings for the MedTech service. There are two methods for fixing this issue based on the type of managed identity you're using with your MedTech service:
- System-assigned managed identity: If you're using a system-assigned managed identity with your MedTech service, a new identity is created for you through reprovisioning.
- User-assigned managed identity: If you're using a user-assigned managed identity with your MedTech service, you need to first recreate the identity in the new tenant and update your MedTech service with the new identity before reprovisioning.
In either case, you also need to update the Azure RBAC settings on your FHIR service and event hub with the new managed identity. For more information on transferring subscriptions to different tenants, see Transfer an Azure subscription to a different Microsoft Entra directory.
Can I use the MedTech service with device messages from Apple®, Google®, or Fitbit® devices?
Yes. The MedTech service supports device messages from all these vendors through the open-source version of the MedTech service.
To learn about the MedTech service open-source projects, see Open-source projects.
Next steps
Understand the MedTech service device data processing stages
Choose a deployment method for the MedTech service
Note
FHIR® is a registered trademark of HL7 and is used with the permission of HL7.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for