Risolvere i problemi relativi al gateway di rete virtuale e alle connessioni tramite Network Watcher di AzureTroubleshoot Virtual Network gateway and Connections using Azure Network Watcher

Network Watcher offre numerose funzionalità che consentono di comprendere le risorse di rete in Azure.Network Watcher provides many capabilities as it relates to understanding your network resources in Azure. Una di queste funzionalità è la risoluzione dei problemi riscontrati con le risorse.One of these capabilities is resource troubleshooting. La funzionalità può essere chiamata dal portale, da PowerShell, dall'interfaccia della riga di comando o dall'API REST.Resource troubleshooting can be called through the portal, PowerShell, CLI, or REST API. Quando chiamata, Network Watcher controlla l'integrità di un gateway di rete virtuale o di una connessione e restituisce i risultati.When called, Network Watcher inspects the health of a Virtual Network Gateway or a Connection and returns its findings.

Questo articolo illustra le diverse attività di gestione attualmente disponibili per la risoluzione dei problemi relativi alle risorse.This article takes you through the different management tasks that are currently available for resource troubleshooting.

Prima di iniziareBefore you begin

ARMclient viene usato per chiamare l'API REST con PowerShell.ARMclient is used to call the REST API using PowerShell. ARMClient è reperibile in Chocolatey in ARMClient on Chocolatey (ARMClient in Chocolatey)ARMClient is found on chocolatey at ARMClient on Chocolatey

Questo scenario presuppone il completamento dei passaggi descritti in Creare un servizio Network Watcher per creare un servizio Network Watcher.This scenario assumes you have already followed the steps in Create a Network Watcher to create a Network Watcher.

Per un elenco dei tipi di gateway supportati, consultare i tipi di gateway supportati.For a list of supported gateway types visit, Supported Gateway types.

PanoramicaOverview

La risoluzione dei problemi relativi a Network Watcher consente di risolvere i problemi che si verificano con i gateway di rete virtuale e le connessioni.Network Watcher troubleshooting provides the ability troubleshoot issues that arise with Virtual Network gateways and Connections. Quando viene inviata una richiesta di risoluzione dei problemi delle risorse, i log vengono sottoposti a query e controllati.When a request is made to the resource troubleshooting, logs are querying and inspected. Dopo aver completato l'ispezione, vengono restituiti i risultati.When inspection is complete, the results are returned. Le richieste di risoluzione dei problemi delle API sono richieste a esecuzione prolungata, che possono richiedere anche diversi minuti per restituire un risultato.The troubleshoot API requests are long running requests, which could take multiple minutes to return a result. I log vengono archiviati in un contenitore di un account di archiviazione.Logs are stored in a container on a storage account.

Accedere con ARMClientLog in with ARMClient

armclient login

Risolvere i problemi relativi a un gateway di rete virtualeTroubleshoot a Virtual Network gateway

PUBBLICARE la richiesta di risoluzione dei problemiPOST the troubleshoot request

Nell'esempio seguente viene eseguita una query sullo stato di un gateway di rete virtuale.The following example queries the status of a Virtual Network gateway.


$subscriptionId = "00000000-0000-0000-0000-000000000000"
$resourceGroupName = "ContosoRG"
$NWresourceGroupName = "NetworkWatcherRG"
$networkWatcherName = "NetworkWatcher_westcentralus"
$vnetGatewayName = "ContosoVNETGateway"
$storageAccountName = "contososa"
$containerName = "gwlogs"
$requestBody = @"
{
'TargetResourceId': '/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.Network/virtualNetworkGateways/${vnetGatewayName}',
'Properties': {
'StorageId': '/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.Storage/storageAccounts/${storageAccountName}',
'StoragePath': 'https://${storageAccountName}.blob.core.windows.net/${containerName}'
}
}
"@


armclient post "https://management.azure.com/subscriptions/${subscriptionId}/ResourceGroups/${NWresourceGroupName}/providers/Microsoft.Network/networkWatchers/${networkWatcherName}/troubleshoot?api-version=2016-03-30" -verbose

Poiché questa operazione ha una lunga esecuzione, l'URI per le query dell'operazione e l'URI per il risultato vengono restituiti nell'intestazione della risposta come illustrato nella risposta seguente:Since this operation is long running, the URI for querying the operation and the URI for the result is returned in the response header as shown in the following response:

Valori importantiImportant Values

  • Azure-AsyncOperation: questa proprietà contiene l'URI per eseguire le query sull'operazione di risoluzione dei problemi asincronaAzure-AsyncOperation - This property contains the URI to query the Async troubleshoot operation
  • Location: questa proprietà contiene l'URI in cui si trovano i risultati una volta completata l'operazioneLocation - This property contains the URI where the results are when the operation is complete
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 10
x-ms-request-id: 8a1167b7-6768-4ac1-85dc-703c9c9b9247
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operations/8a1167b7-6768-4ac1-85dc-703c9c9b9247?api-version=2016-03-30
Strict-Transport-Security: max-age=31536000; includeSubDomains
Cache-Control: no-cache
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operationResults/8a1167b7-6768-4ac1-85dc-703c9c9b9247?api-version=2016-03-30
Server: Microsoft-HTTPAPI/2.0; Microsoft-HTTPAPI/2.0
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 4364d88a-bd08-422c-a716-dbb0cdc99f7b
x-ms-routing-request-id: NORTHCENTRALUS:20170112T183202Z:4364d88a-bd08-422c-a716-dbb0cdc99f7b
Date: Thu, 12 Jan 2017 18:32:01 GMT

null

Eseguire una query all'operazione asincrona per il completamentoQuery the async operation for completion

Usare l'URI delle operazioni per eseguire query sullo stato di avanzamento dell'operazione, come illustrato nell'esempio seguente:Use the operations URI to query for the progress of the operation as seen in the following example:

armclient get "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operations/8a1167b7-6768-4ac1-85dc-703c9c9b9247?api-version=2016-03-30" -verbose

Mentre l'operazione è in corso, la risposta mostra InProgress come illustrato nell'esempio seguente:While the operation is in progress, the response shows InProgress as seen in the following example:

{
  "status": "InProgress"
}

Al termine dell'operazione, lo stato diventa Succeeded.When the operation is complete the status changes to Succeeded.

{
  "status": "Succeeded"
}

Recuperare i risultatiRetrieve the results

Quando lo stato restituito è Succeeded, chiamare un metodo GET sull'URI operationResult per recuperare i risultati.Once the status returned is Succeeded, call a GET Method on the operationResult URI to retrieve the results.

armclient get "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operationResults/8a1167b7-6768-4ac1-85dc-703c9c9b9247?api-version=2016-03-30" -verbose

Le risposte seguenti sono esempi di una tipica risposta ridotta, restituita quando si eseguono query sui risultati della risoluzione dei problemi relativi a un gateway.The following responses are examples of a typical degraded response returned when querying the results of troubleshooting a gateway. Vedere Informazioni sui risultati per chiarimenti sul significato delle proprietà nella risposta.See Understanding the results to get clarification on what the properties in the response mean.

{
  "startTime": "2017-01-12T10:31:41.562646-08:00",
  "endTime": "2017-01-12T18:31:48.677Z",
  "code": "Degraded",
  "results": [
    {
      "id": "PlatformInActive",
      "summary": "We are sorry, your VPN gateway is in standby mode",
      "detail": "During this time the gateway will not initiate or accept VPN connections with on premises VPN devices or other Azure VPN Gateways. This is a transient state while the Azure platform is being updated.",
      "recommendedActions": [
        {
          "actionText": "If the condition persists, please try resetting your Azure VPN gateway",
          "actionUri": "https://azure.microsoft.com/en-us/documentation/articles/vpn-gateway-resetgw-classic/",
          "actionUriText": "resetting the VPN Gateway"
        },
        {
          "actionText": "If your VPN gateway isn't up and running by the expected resolution time, contact support",
          "actionUri": "http://azure.microsoft.com/support",
          "actionUriText": "contact support"
        }
      ]
    },
    {
      "id": "NoFault",
      "summary": "This VPN gateway is running normally",
      "detail": "There aren't any known Azure platform problems affecting this VPN Connection",
      "recommendedActions": [
        {
          "actionText": "If you are still experience problems with the VPN gateway, please try resetting the VPN gateway.",
          "actionUri": "https://azure.microsoft.com/en-us/documentation/articles/vpn-gateway-resetgw-classic/",
          "actionUriText": "resetting VPN gateway"
        },
        {
          "actionText": "If you are experiencing problems you believe are caused by Azure, contact support",
          "actionUri": "http://azure.microsoft.com/support",
          "actionUriText": "contact support"
        }
      ]
    }
  ]
}

Risoluzione dei problemi relativi alle connessioniTroubleshoot Connections

Nell'esempio seguente viene eseguita una query sullo stato di una connessione.The following example queries the status of a Connection.


$subscriptionId = "00000000-0000-0000-0000-000000000000"
$resourceGroupName = "ContosoRG"
$NWresourceGroupName = "NetworkWatcherRG"
$networkWatcherName = "NetworkWatcher_westcentralus"
$connectionName = "VNET2toVNET1Connection"
$storageAccountName = "contososa"
$containerName = "gwlogs"
$requestBody = @{
"TargetResourceId": "/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.Network/connections/${connectionName}",
"Properties": {
"StorageId": "/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.Storage/storageAccounts/${storageAccountName}",
"StoragePath": "https://${storageAccountName}.blob.core.windows.net/${containerName}"
}

}
armclient post "https://management.azure.com/subscriptions/${subscriptionId}/ResourceGroups/${NWresourceGroupName}/providers/Microsoft.Network/networkWatchers/${networkWatcherName}/troubleshoot?api-version=2016-03-30 "

Nota

L'operazione di risoluzione dei problemi non può essere eseguita in parallelo su una connessione e sui gateway corrispondenti.The troubleshoot operation cannot be run in parallel on a Connection and its corresponding gateways. L'operazione deve essere completata prima di eseguire il gateway sulla risorsa precedente.The operation must complete prior to running it on the previous resource.

Poiché questa transazione ha una lunga esecuzione, nell'intestazione della risposta l'URI per le query dell'operazione e l'URI per il risultato vengono restituiti come illustrato nella risposta seguente:Since this is a long running transaction, in the response header, the URI for querying the operation and the URI for the result is returned as shown in the following response:

Valori importantiImportant Values

  • Azure-AsyncOperation: questa proprietà contiene l'URI per eseguire le query sull'operazione di risoluzione dei problemi asincronaAzure-AsyncOperation - This property contains the URI to query the Async troubleshoot operation
  • Location: questa proprietà contiene l'URI in cui si trovano i risultati una volta completata l'operazioneLocation - This property contains the URI where the results are when the operation is complete
HTTP/1.1 202 Accepted
Pragma: no-cache
Retry-After: 10
x-ms-request-id: 8a1167b7-6768-4ac1-85dc-703c9c9b9247
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operations/8a1167b7-6768-4ac1-85dc-703c9c9b9247?api-version=2016-03-30
Strict-Transport-Security: max-age=31536000; includeSubDomains
Cache-Control: no-cache
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operationResults/8a1167b7-6768-4ac1-85dc-703c9c9b9247?api-version=2016-03-30
Server: Microsoft-HTTPAPI/2.0; Microsoft-HTTPAPI/2.0
x-ms-ratelimit-remaining-subscription-writes: 1199
x-ms-correlation-request-id: 4364d88a-bd08-422c-a716-dbb0cdc99f7b
x-ms-routing-request-id: NORTHCENTRALUS:20170112T183202Z:4364d88a-bd08-422c-a716-dbb0cdc99f7b
Date: Thu, 12 Jan 2017 18:32:01 GMT

null

Eseguire una query all'operazione asincrona per il completamentoQuery the async operation for completion

Usare l'URI delle operazioni per eseguire query sullo stato di avanzamento dell'operazione, come illustrato nell'esempio seguente:Use the operations URI to query for the progress of the operation as seen in the following example:

armclient get "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operations/843b1c31-4717-4fdd-b7a6-4c786ca9c501?api-version=2016-03-30"

Mentre l'operazione è in corso, la risposta mostra InProgress come illustrato nell'esempio seguente:While the operation is in progress, the response shows InProgress as seen in the following example:

{
  "status": "InProgress"
}

Al termine dell'operazione, lo stato diventa Succeeded.When the operation is complete, the status changes to Succeeded.

{
  "status": "Succeeded"
}

Le risposte seguenti sono esempi di una tipica risposta restituita quando si eseguono query sui risultati della risoluzione dei problemi relativi a una connessione.The following responses are examples of a typical response returned when querying the results of troubleshooting a Connection.

Recuperare i risultatiRetrieve the results

Quando lo stato restituito è Succeeded, chiamare un metodo GET sull'URI operationResult per recuperare i risultati.Once the status returned is Succeeded, call a GET Method on the operationResult URI to retrieve the results.

armclient get "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Network/locations/westcentralus/operationResults/843b1c31-4717-4fdd-b7a6-4c786ca9c501?api-version=2016-03-30"

Le risposte seguenti sono esempi di una tipica risposta restituita quando si eseguono query sui risultati della risoluzione dei problemi relativi a una connessione.The following responses are examples of a typical response returned when querying the results of troubleshooting a Connection.

{
  "startTime": "2017-01-12T14:09:19.1215346-08:00",
  "endTime": "2017-01-12T22:09:23.747Z",
  "code": "UnHealthy",
  "results": [
    {
      "id": "PlatformInActive",
      "summary": "We are sorry, your VPN gateway is in standby mode",
      "detail": "During this time the gateway will not initiate or accept VPN connections with on premises VPN devices or other Azure VPN Gateways. This 
is a transient state while the Azure platform is being updated.",
      "recommendedActions": [
        {
          "actionText": "If the condition persists, please try resetting your Azure VPN gateway",
          "actionUri": "https://azure.microsoft.com/en-us/documentation/articles/vpn-gateway-resetgw-classic/",
          "actionUriText": "resetting the VPN gateway"
        },
        {
          "actionText": "If your VPN Connection isn't up and running by the expected resolution time, contact support",
          "actionUri": "http://azure.microsoft.com/support",
          "actionUriText": "contact support"
        }
      ]
    },
    {
      "id": "NoFault",
      "summary": "This VPN Connection is running normally",
      "detail": "There aren't any known Azure platform problems affecting this VPN Connection",
      "recommendedActions": [
        {
          "actionText": "If you are still experience problems with the VPN gateway, please try resetting the VPN gateway.",
          "actionUri": "https://azure.microsoft.com/en-us/documentation/articles/vpn-gateway-resetgw-classic/",
          "actionUriText": "resetting VPN gateway"
        },
        {
          "actionText": "If you are experiencing problems you believe are caused by Azure, contact support",
          "actionUri": "http://azure.microsoft.com/support",
          "actionUriText": "contact support"
        }
      ]
    }
  ]
}

Informazioni sui risultatiUnderstanding the results

Il testo dell'azione offre indicazioni generiche su come risolvere il problema.The action text provides general guidance on how to resolve the issue. Se è possibile eseguire un'azione per il problema, viene fornito un collegamento con altre informazioni.If an action can be taken for the issue, a link is provided with additional guidance. Nel caso in cui non siano presenti altre indicazioni, la risposta include l'URL per aprire una richiesta di assistenza.In the case where there is no additional guidance, the response provides the url to open a support case. Per altre informazioni sulle proprietà della risposta e ciò che vie è incluso, consultare la panoramica sulla risoluzione dei problemi in Network Watcher.For more information about the properties of the response and what is included, visit Network Watcher Troubleshoot overview

Per istruzioni sul download di file dall'account di archiviazione di Azure, consultare Introduzione all'archiviazione BLOB di Azure con .NET.For instructions on downloading files from azure storage accounts, refer to Get started with Azure Blob storage using .NET. Un altro strumento che può essere usato è Storage Explorer.Another tool that can be used is Storage Explorer. Altre informazioni su Storage Explorer sono reperibili facendo clic sul collegamento seguente: Storage Explorer.More information about Storage Explorer can be found here at the following link: Storage Explorer

Passaggi successiviNext steps

Se sono state modificate le impostazioni che arrestano la connettività VPN, vedere Gestire gruppi di sicurezza di rete per tenere traccia del gruppo di sicurezza di rete e delle regole di sicurezza in questione.If settings have been changed that stop VPN connectivity, see Manage Network Security Groups to track down the network security group and security rules that may be in question.