Behandeln von Netzwerkproblemen mit dem Azure Storage Mover-Agent

Der Azure Storage Mover-Agent ist ein wichtiger Bestandteil des Azure Storage Mover-Diensts, ein leistungsstarkes Tool zum nahtlosen Migrieren von Daten zu Azure. Die Funktionalität des Agents hängt stark von der zuverlässigen Netzwerkkonnektivität ab. Wenn Netzwerkprobleme auftreten, bietet der Azure Storage Mover-Agent einen robusten Satz von Tools zum Diagnostizieren und Beheben von Netzwerkproblemen.

Wenn Sie einem strukturierten Ansatz folgen, beginnend mit Konfigurationsüberprüfungen, dem Fortschritt durch Konnektivitätstests und der Anwendung der Endpunktdiagnose können Administratoren einen zuverlässigen Betrieb und erfolgreiche Datenmigrationen sicherstellen. Bei dauerhaften oder komplexen Problemen bietet das Supportpaket einen Weg zur tieferen Analyse und Unterstützung des Microsoft-Supports.

Diese systemeigenen Diagnosetools können mit standardmäßigen Tools und Techniken zur Problembehandlung im Netzwerk verwendet werden.

In diesem Artikel werden die verfügbaren Methoden zur Problembehandlung von Agent-Netzwerkproblemen beschrieben. Empfohlene Schritte zur Problembehandlung sind Konfigurationsprüfungen, Verbindungstests, Endpunktdiagnosen und die Verwendung von Supporttools.

Übersicht über die Netzwerkkonfiguration

Der empfohlene erste Schritt bei der Diagnose von Netzwerkproblemen besteht darin, die Netzwerkkonfiguration des Agents zu überprüfen. Diese Überprüfung kann über das Netzwerkkonfigurationstool anzeigen erfolgen, das sich in der Netzwerkkonfigurationsgruppe des Menüs des Agents befindet.

Das Tool "Netzwerkkonfiguration anzeigen" zeigt wichtige Informationen an, z. B.:

  • DHCP-Status
  • IP-Adresse und Subnetzmaske
  • MAC-Adresse
  • Verknüpfungs- und Betriebszustand
  • Geschwindigkeit und MTU
  • DNS-Server und Routingtabelle
  • Standardgateway- und Proxyeinstellungen
  • NTP-Serverkonfiguration

Im folgenden Beispiel wird die Beispielausgabe des Tools bereitgestellt:

Network Interface(s):
eth0:
  DHCP (Dynamic Host Configuration Protocol) status: true
  IP Address and mask: 192.168.1.10/24
  MAC Address (The unique hardware identifier for your network interface): 00:1A:2B:3C:4D:5E
  Link (The connection status of your network interface): up
  Operstate (The operational state of your network interface): up
  Speed (The data transfer rate of your network interface): 10Gbps
  MTU (Maximum Transmission Unit - the largest size of a network packet that can be transmitted): 1500
  DNS (Domain Name System - the service that translates domain names to IP addresses): 192.168.1.1
  Routes (The rules that determine the paths network traffic will take from your device to reach their destination):
    default via 192.168.1.1 proto dhcp src 192.168.1.10 metric 100
    192.168.1.0/24 dev eth0 proto kernel scope link src 192.168.1.10 metric 100
    169.254.0.0/24 proto dhcp scope link src 192.168.1.10 metric 100
Global DNS (The Domain Name System servers that are used by all devices on your network): 192.168.1.1
Default Gateway (The device that routes your network traffic to other networks or the internet): 192.168.1.1
Proxy (A server that acts as an intermediary for requests from clients seeking resources from other servers): No proxy
NTP Server(s) (Network Time Protocol servers - these servers provide time synchronization for your device): [ntp.ubuntu.com, time.google.com]

Wenn die Netzwerkkonfiguration eines Agents überprüft wird, geben alle Felder, die leere oder falsche Werte enthalten, eine potenzielle Fehlkonfiguration der Netzwerkadaptereinstellungen des Hypervisors oder der Schnittstelleneinstellungen des Agents an. Beispielsweise deutet ein leerer IP address-Wert oder ein Link- oder Operstate-Status, der von up abweicht, darauf hin, dass der Agent möglicherweise nicht ordnungsgemäß mit dem Netzwerk verbunden ist. In solchen Fällen sollten Administratoren die Netzwerkadaptereinstellungen des Hypervisors überprüfen oder die Schnittstelleneinstellungen des Agents neu konfigurieren.

Konnektivitätstests

Nachdem die Netzwerkkonfiguration überprüft wurde, besteht der nächste Schritt darin, die Konnektivität mit den wesentlichen Azure-Endpunkten des Agents zu testen. Der Agent bietet verschiedene Tools für diesen Zweck und ermöglicht Ihnen die Auswahl der Detailebene, die für Ihre Problembehandlungsanforderungen erforderlich ist. Sie können zwischen allgemeinen Konnektivitätstests, einer ausführlichen Ausgabe für eine tiefergehende Analyse oder Tests einzelner Endpunkte für gezielte Diagnosen wählen. Alle drei Optionen bieten wertvolle Einblicke in die Netzwerkkonnektivität des Agents und können dabei helfen, potenzielle Probleme zu erkennen.

Konnektivitätstesttools befinden sich in der Netzwerkkonfigurationsgruppe des Menüs des Agents.

Allgemeine Netzwerküberprüfungen

Wählen Sie für allgemeine Konnektivitätstests die Option "Netzwerkkonnektivität testen " aus. Dieses Tool überprüft die HTTPS-Konnektivität mit wichtigen Azure-Endpunkten, einschließlich der Endpunkte, die für die Agentregistrierung und -vorgänge erforderlich sind. Das Tool verwendet den Befehl zum Testen von azcmagent check Azure Arc-Endpunkten und überprüft dann Storage Mover-spezifische Endpunkte. Die Ergebnisse dieser Tests umfassen:

  • HTTPS-Reichweite
  • DNS-Auflösungsstatus
  • IP-Typ, entweder privat oder öffentlich
  • Proxyverwendung

Hinweis

Dieser Test enthält keine Speicherkonto- oder Key Vault-Endpunkte, die während der Auftragsausführung verwendet werden.

Ausführliche Netzwerküberprüfungen

Die Test network connectivity verbosely Option bietet eine detailliertere Analyse von Netzwerkverbindungsproblemen. Diese erweiterte Version der allgemeinen Netzwerkprüfung liefert detaillierte Ausgaben von azcmagent und curl, einschließlich HTTP-Antwortcodes und TLS-Paketdaten. Es ist nützlich, SSL-bezogene Probleme zu diagnostizieren oder bestimmte Fehlermeldungen zu überprüfen.

Einzelendpunkttests

Mit Test single endpoint connectivity der Option können Sie die Konnektivität eines bestimmten Endpunkts testen. Neben dem Testen von Speicherkonto- und Key Vault-Endpunkten, die nicht von der allgemeinen Netzwerküberprüfung abgedeckt werden, ermöglicht dieses Tool das gezielte Testen eines bestimmten Endpunkts mithilfe von:

  • nslookup für DNS-Auflösung
  • traceroute für die Pfadanalyse
  • curl für HTTPS-Konnektivität

Im folgenden Beispiel wird die Beispielausgabe des Tools bereitgestellt:

1) Show network configuration
2) Update network configuration
3) Test network connectivity
4) Test network connectivity verbosely
5) Test single endpoint connectivity
6) Quit
 
Choice: 5
This option tests connectivity to one endpoint with your current network setup using tools like nslookup, traceroute, curl, etc.
Provide an Azure endpoint (URL or FQDN) to test: https://mydemoaccount.blob.core.windows.net/demo-container
Run in verbose mode? [y/N] n
+----------------------------------------------------------+
| Checking domain name resolution with nslookup... |
+----------------------------------------------------------+
  Testing 'mydemoaccount.blob.core.windows.net'...
 
Server:         203.50.10.50
Address:        203.50.10.50#53
 
Non-authoritative answer:
mydemoaccount.blob.core.windows.net  canonical name = blob.regionprdstr03a.store.core.windows.net.
Name:   blob.regionprdstr03a.store.core.windows.net
Address: 203.60.14.164
 
+------------------------------------------------------------+
|    Checking network path to endpoint with traceroute...    |
+------------------------------------------------------------+
  Testing 'mydemoaccount.blob.core.windows.net' port 443 over TCP...
 
traceroute to mydemoaccount.blob.core.windows.net (10.60.14.164), 30 hops max, 60 byte packets
1  demosrva901.network.microsoft.com (10.126.12.2)  0.401 ms  0.440 ms  0.507 ms
2  demosrvl1.network.microsoft.com (10.10.80.2)  0.279 ms demosrvl2.network.microsoft.com (10.10.80.6)  0.267 ms demosrvl1.network.microsoft.com (10.10.80.2)  0.305 ms
3  demosrvb1.network.microsoft.com (10.126.137.144)  0.303 ms demosrvb3.network.microsoft.com (10.126.137.156)  0.230 ms demosrvb2.network.microsoft.com (10.126.137.146)  0.279 ms
4  musmtv005anrs2.clouddatahub.net (10.126.137.139)  0.274 ms  0.262 ms demosrvs2.network.microsoft.com (10.126.137.141)  0.250 ms
5  10.161.128.7 (10.161.128.7)  0.123 ms 10.161.128.21 (10.161.128.21)  0.216 ms 10.161.128.7 (10.161.128.7)  0.218 ms
6  demosrvs1.network.microsoft.com (10.161.128.4)  0.323 ms  0.337 ms  0.273 ms
7  demosrvb3.network.microsoft.com (10.126.137.4)  0.329 ms demosrvb4.network.microsoft.com (10.126.137.6)  0.553 ms demosrvb2.network.microsoft.com (10.126.137.2)  0.306 ms
8  demosrvc2.network.network.microsoft.com (10.126.137.9)  0.393 ms  0.326 ms demosrvc1.network.network.microsoft.com (10.126.137.1)  0.382 ms
9  democussrvca901.network.microsoft.com (10.37.12.118)  0.800 ms 10.37.12.120 (10.37.12.120)  0.870 ms  0.814 ms
10  * * *
11  * * *
12  * * *
13  democussrvb21ca940.network.microsoft.com (10.37.12.104)  2.850 ms democussrvb21ca940.network.microsoft.com (10.37.12.106)  2.126 ms democussrvb21ca940.network.microsoft.com (10.37.12.104)  2.560 ms
14  democussrvb21an7k1.network.microsoft.com (10.37.171.33)  0.787 ms  0.826 ms  0.814 ms
15  10.37.171.70 (10.37.171.70)  1.077 ms  1.056 ms  1.040 ms
16  democussrvlb21an7k1.microsoft.com (10.37.168.4)  1.221 ms  1.295 ms  1.212 ms
17  democussrvlb21a7201.network.microsoft.com (169.220.17.1)  1.168 ms  1.351 ms  1.340 ms
18  ae60-0.region.ntwk.msn.net (203.44.15.46)  2.153 ms  1.319 ms  1.306 ms
19  ae22-0.region.ntwk.msn.net (203.44.232.202)  1.382 ms ae24-0.region.ntwk.msn.net (203.44.232.204)  1.370 ms  1.717 ms
20  be-120-0.region.ntwk.msn.net (203.44.22.167)  17.054 ms * *
21  be-2-0.region.ntwk.msn.net (203.44.17.23)  16.926 ms * be-2-0.region.ntwk.msn.net (203.44.17.21)  17.911 ms
22  * be-5-0.region.ntwk.msn.net (203.44.17.71)  116.530 ms  116.798 ms
23  169.10.19.29 (169.10.19.29)  18.540 ms  18.096 ms *
24  * 169.10.6.142 (169.10.6.142)  18.161 ms 169.10.11.182 (169.10.11.182)  18.559 ms
25  169.10.11.174 (169.10.11.174)  17.550 ms 169.10.11.170 (169.10.11.170)  17.132 ms *
26  * * *
27  * * 192.98.222.143 (192.98.222.143)  15.860 ms
28  * 127.106.199.121 (127.106.199.121)  16.719 ms 127.106.199.111 (127.106.199.111)  16.341 ms
29  127.106.199.112 (127.106.199.112)  16.521 ms * 127.106.199.109 (127.106.199.109)  16.200 ms
30  * * *
 
+------------------------------------------------+
|   Checking HTTPS connectivity with curl...   |
+------------------------------------------------+
  Testing 'https://mydemoaccount.blob.core.windows.net/sm-nfs4-file-share'...
 
This only checks that the endpoint is physically reachable over the network, and does not attempt authentication or authorization;
some 4XX or 5XX errors will be expected when testing certain Azure endpoints, even when the endpoints are reachable over the network.
See https://learn.microsoft.com/en-us/azure/storage-mover/deployment-planning for more info about RBAC roles for Storage Mover resources.
 
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
HTTP/1.1 409 Public access is not permitted on this storage account.
Transfer-Encoding: chunked
Server: Blob Service Version 1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 22cc22cc-dd33-ee44-ff55-66aa66aa66aa
Date: Thu, 23 Oct 2025 21:37:01 GMT

Dienst- und Auftragsstatusprüfungen

Innerhalb des Service and job Status Menüs stehen zwei Tools zur Bewertung des Status der Verbindung des Agents mit dem Storage Mover-Dienst und dem Status der Auftragsausführungen zur Verfügung. Diese Tools, der Dienstkommunikationsstatus und die Auftragszusammenfassung, Details und Kopierprotokolle, helfen bei der Bewertung des Registrierungsstatus des Agents und des Auftragsausführungszustands.

  • Dienstkommunikationsstatus: Überprüft die Verbindung des Agents mit dem Storage Mover-Dienst.
  • Auftragszusammenfassung, Details und Kopierprotokolle: Bieten Sie Einblicke in die Auftragsleistung, einschließlich Übertragungsraten und potenzieller Netzwerkfehler wie SSL-Abfangen.

Eingeschränkte Shell-Tools

Die Open restricted shell Option ermöglicht die Ausführung der folgenden grundlegenden Netzwerkbefehle. Diese Befehle sind nützlich für die manuelle Diagnose und Fehlerbehebung bei Konnektivitätsproblemen mit Quellfreigaben:

  • nslookup und ping für Endpunkttests.
  • mount, showmount und umount für SMB/NFS-Freigabediagnose.

SMB-Diagnose

Innerhalb der Troubleshooting Gruppe sammelt die SMB Troubleshooting Option SMB-Protokolldateien zur Aufnahme in das Support-Paket. Dies ist für die Diagnose von Problemen mit SMB-Quellfreigaben unerlässlich. Diese Protokolle bieten Einblicke in Authentifizierungsprobleme, Berechtigungsprobleme und Konnektivitätsfehler im Zusammenhang mit SMB-Freigaben.

Supportbundlesammlung

Die Collect support bundle Option aggregiert Protokolle von allen Diagnosetools mit Ausnahme der eingeschränkten Shelltools. Sie kann über SFTP mit dem Microsoft-Support geteilt werden und ist die umfassendste Ressource für ausführliche Problembehandlung.

Weitere Hilfe zum Sammeln des Supportpakets eines Agents finden Sie im Artikel zum Erstellen, Abrufen und Anzeigen des Supportpakets .

Häufige Netzwerkprobleme und -lösungen

In der folgenden Liste werden mehrere häufige Probleme und deren Lösungen beschrieben:

  • DNS-Auflösungsfehler
    Wenn Probleme mit der DNS-Auflösung auftreten, verwenden Sie das nslookup Tool, Endpunkttests und Netzwerkkonfigurationstools, um DNS-Einstellungen zu überprüfen.
  • HTTPS-Konnektivitätsfehler
    HTTPS-Konnektivitätsfehler können häufig behoben werden, indem die Firewall-/Proxy-Einstellungen überprüft, die IP-Adressen validiert und die ausführliche curl-Ausgabe überprüft werden.
  • Fehlkonfiguration des Arc Private Link-Bereichs
    Fehlkonfigurationen sind häufig die Ursache für die meisten Probleme mit dem Bereich für private Links. Um diese Probleme zu beheben, stellen Sie sicher, dass Sie während der Netzwerküberprüfung korrekte Antworten erhalten und die erforderlichen ENDPUNKT-IP-Typen überprüfen.
  • SSL-Abfangenfehler
    Suchen Sie in den ausführlichen Protokollen oder Kopierprotokollen nach „x509: Zertifikat von unbekannter autoritativer Stelle signiert“. Möglicherweise ist es erforderlich, Endpunkte auf die Whitelist zu setzen.

Nächste Schritte

Möglicherweise finden Sie Informationen in den folgenden Artikeln hilfreich:

  • Last updated on