Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
APLICA-SE A:
Python SDK azure-ai-ml v2 (atual)
APLICA-SE A:
SDK do Azure Machine Learning v1 para Python
Importante
Este artigo fornece informações sobre como usar o SDK do Azure Machine Learning v1. O SDK v1 foi preterido a partir de 31 de março de 2025. O apoio terminará em 30 de junho de 2026. Você pode instalar e usar o SDK v1 até essa data.
Recomendamos a transição para o SDK v2 antes de 30 de junho de 2026. Para obter mais informações sobre o SDK v2, consulte O que é a CLI do Azure Machine Learning e o SDK do Python v2? e a referência do SDK v2.
O Azure Machine Learning disponibiliza uma API de diagnóstico que pode ser utilizada para identificar problemas na área de trabalho. Os erros devolvidos no relatório de diagnóstico incluem informações sobre como resolver o problema.
Pode utilizar os diagnósticos da área de trabalho no estúdio do Azure Machine Learning ou no SDK Python.
Pré-requisitos
Uma área de trabalho do Azure Machine Learning. Para conhecer as etapas de criação de um espaço de trabalho, consulte Criar o espaço de trabalho.
O SDK do Azure Machine Learning para Python v2. Para instalar o SDK, use o seguinte comando:
pip install azure-ai-ml azure-identityPara atualizar uma instalação existente do SDK para a versão mais recente, use o seguinte comando:
pip install --upgrade azure-ai-ml azure-identityPara obter mais informações, consulte Biblioteca de cliente do Pacote do Azure Machine Learning para Python.
- Uma área de trabalho do Azure Machine Learning. Se você não tiver um, consulte Criar um espaço de trabalho.
- O SDK do Azure Machine Learning v1 para Python.
Diagnóstico do estúdio
No estúdio do Azure Machine Learning, pode executar um diagnóstico na área de trabalho para verificar a configuração. Para executar o diagnóstico, selecione o ícone '?' no canto superior direito da página. Em seguida, selecione Executar diagnóstico da área de trabalho.
Após a execução do diagnóstico, uma lista de todos os problemas detetados é retornada. Esta lista inclui links para possíveis soluções.
Diagnóstico de Python
O trecho a seguir demonstra como usar o diagnóstico de espaço de trabalho do Python.
APLICA-SE A:
Python SDK azure-ai-ml v2 (atual)
from azure.ai.ml import MLClient
from azure.ai.ml.entities import Workspace
from azure.identity import DefaultAzureCredential
subscription_id = '<your-subscription-id>'
resource_group = '<your-resource-group-name>'
workspace = '<your-workspace-name>'
ml_client = MLClient(DefaultAzureCredential(), subscription_id, resource_group)
resp = ml_client.workspaces.begin_diagnose(workspace).result()
# Inspect the attributes of the response you are interested in
for result in resp.application_insights_results:
print(f"Diagnostic result: {result.code}, {result.level}, {result.message}")
A resposta é um objeto DiagnoseResponseResultValue que contém informações sobre quaisquer problemas detetados com o espaço de trabalho.
APLICA-SE A:
SDK do Azure Machine Learning v1 para Python
from azureml.core import Workspace
ws = Workspace.from_config()
diag_param = {
"value": {
}
}
resp = ws.diagnose_workspace(diag_param)
print(resp)
A resposta é um documento JSON que contém informações sobre quaisquer problemas detetados com o espaço de trabalho. O JSON a seguir é um exemplo de resposta:
{
"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/<myresourcegroup>/providers/Microsoft.Network/privateEndpoints/<workspace-private-endpoint>' is not using Azure default DNS. You need to configure your DNS server and check https://learn.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": []
}
}
Se nenhum problema for detetado, um documento JSON vazio será retornado.
Para obter mais informações, consulte a referência do espaço de trabalho .
Para obter mais informações, consulte a referência Workspace.diagnose_workspace( ).