Skip to content

Files

83 lines (62 loc) · 3.42 KB

how-to-workspace-diagnostic-api.md

File metadata and controls

83 lines (62 loc) · 3.42 KB
title titleSuffix description services ms.service ms.subservice ms.author author ms.reviewer ms.date ms.topic ms.custom
Workspace diagnostics
Azure Machine Learning
Learn how to use Azure Machine Learning workspace diagnostics in the Azure portal or with the Python SDK.
machine-learning
machine-learning
enterprise-readiness
jhirono
jhirono
larryfr
11/18/2021
how-to
sdkv1, event-tier1-build-2022

How to use workspace diagnostics

Azure Machine Learning provides a diagnostic API that can be used to identify problems with your workspace. Errors returned in the diagnostics report include information on how to resolve the problem.

You can use the workspace diagnostics from the Azure Machine Learning studio or Python SDK.

Prerequisites

Diagnostics from studio

From Azure Machine Learning studio or the Python SDK, you can run diagnostics on your workspace to check your setup. To run diagnostics, select the '?' icon from the upper right corner of the page. Then select Run workspace diagnostics.

:::image type="content" source="./media/how-to-workspace-diagnostic-api/diagnostics.png" alt-text="Screenshot of the workspace diagnostics button":::

After diagnostics run, a list of any detected problems is returned. This list includes links to possible solutions.

Diagnostics from Python

The following snippet demonstrates how to use workspace diagnostics from Python

[!INCLUDE sdk v1]

from azureml.core import Workspace

ws = Workspace.from_config()

diag_param = {
      "value": {
      }
    }

resp = ws.diagnose_workspace(diag_param)
print(resp)

The response is a JSON document that contains information on any problems detected with the workspace. The following JSON is an example response:

{
    'value': {
        'user_defined_route_results': [], 
        'network_security_rule_results': [], 
        'resource_lock_results': [], 
        'dns_resolution_results': [{
            'code': 'CustomDnsInUse', 
            'level': 'Warning', 
            'message': "It is detected VNet '/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Network/virtualNetworks/<virtual-network-name>' of private endpoint '/subscriptions/<subscription-id>/resourceGroups/larrygroup0916/providers/Microsoft.Network/privateEndpoints/<workspace-private-endpoint>' is not using Azure default dns. You need to configure your DNS server and check https://docs.microsoft.com/azure/machine-learning/how-to-custom-dns to make sure the custom dns is set up correctly."
        }], 
        'storage_account_results': [], 
        'key_vault_results': [], 
        'container_registry_results': [], 
        'application_insights_results': [], 
        'other_results': []
    }
}

If no problems are detected, an empty JSON document is returned.

For more information, see the Workspace.diagnose_workspace() reference.

Next steps