Troubleshoot MedTech service deployment errors
This article provides troubleshooting steps and fixes for MedTech service deployment errors.
Tip
Having access to MedTech service metrics and logs is essential for troubleshooting and assessing the overall health and performance of your MedTech service. Check out these MedTech service articles to learn how to enable, configure, and use these MedTech service monitoring features:
How to use the MedTech service monitoring and health checks tabs
MedTech service resource errors and fixes
Here's a list of errors that can be found in the Azure Resource Manager (ARM) API or Azure portal and fixes for these errors:
The maximum number of resource type iotconnectors has been reached
Displayed: ARM API and Azure portal
Description: MedTech service subscription quota is reached (default is 10 MedTech services per workspace and 10 workspaces per subscription).
Fix: Perform one of these options:
Delete one of the existing instances of the MedTech service.
Use a different subscription that hasn't reached the subscription quota.
Request a subscription quota increase - Azure Technical Support.
Invalid deviceMapping mapping. Validation errors: {LIST_OF_ERRORS}
Displayed: ARM API and Azure portal
Description: The device mapping provided in the MedTech service provisioning request is invalid.
Fix:
- If you're deploying a MedTech service using an ARM template, correct the errors in the mapping JSON provided in the
properties.deviceMappingproperty. - If you're deploying a MedTech service using the Azure portal, correct the errors in the mapping JSON provided in the Device mapping tab.
fullyQualifiedEventHubNamespace is null, empty, or formatted incorrectly
Displayed: ARM API
Description: The MedTech service's Event Hubs Namespace provided in the provisioning request isn't valid.
Fix: Update the MedTech service's properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace property to the correct format in your ARM template. The format should be {EVENTHUB_NAMESPACE}.servicebus.windows.net.
Ancestor resources must be fully provisioned before a child resource can be provisioned
Displayed: ARM API
Description: The parent workspace is still provisioning.
Fix: Wait until the parent workspace provisioning has completed and submit the provisioning request again.
The location property of child resources must match the location property of parent resources
Displayed: ARM API
Description: The MedTech service's location provided in the provisioning request is different from the parent workspace's location.
Fix: Set the location property of the MedTech service in your ARM template to the same value as the parent workspace's location property.
FHIR destination resource errors and fixes
Here's a list of errors that can be found in the Azure Resource Manager (ARM) API or Azure portal and fixes for these errors:
The maximum number of resource type iotconnectors/destinations has been reached
Displayed: ARM API and Azure portal
Description: MedTech service's FHIR® destination resource quota is reached (default is one per MedTech service).
Fix: Delete the existing instance of the MedTech service's FHIR destination resource. Only one FHIR destination resource is permitted per MedTech service.
The fhirServiceResourceId provided is invalid
Displayed: ARM API
Description: The FHIR destination's resource ID provided in the provisioning request isn't a valid resource ID for an instance of the FHIR service.
Fix: Ensure the resource ID in the properties.fhirServiceResourceId property of your ARM template is formatted correctly, and make sure the resource ID is for the FHIR service instance. The format should be: /subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP_NAME}/providers/Microsoft.HealthcareApis/workspaces/{WORKSPACE_NAME}/fhirservices/{FHIR_SERVICE_NAME}
Ancestor resources must be fully provisioned before a child resource can be provisioned
Displayed: ARM API
Description: The parent workspace or the parent MedTech service is still provisioning.
Fix: Wait until the parent workspace or the parent MedTech service provisioning completes, then submit the provisioning request again.
The location property of child resources must match the location property of parent resources
Displayed: ARM API
Description: The FHIR destination resource's location provided in the provisioning request is different from the parent MedTech service's location.
Fix: Set the location property of the FHIR destination in your ARM template to the same value as the parent MedTech service's location property.
Note
If you're not able to fix your MedTech service issue using this troubleshooting guide, you can open an Azure Technical Support ticket attaching copies of your device message and device and FHIR destination mappings to your request to better help with issue determination.
Next steps
Frequently asked questions about 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