Felsöka nätverksproblem med Azure Storage Mover-agenten

Azure Storage Mover-agenten är en viktig del av Azure Storage Mover-tjänsten, ett kraftfullt verktyg för sömlös migrering av data till Azure. Agentens funktioner är starkt beroende av tillförlitlig nätverksanslutning. När nätverksproblem uppstår tillhandahåller Azure Storage Mover-agenten en robust uppsättning verktyg för att diagnostisera och lösa nätverksproblem.

Genom att följa en strukturerad metod, börja med konfigurationskontroller, gå vidare med anslutningstester och tillämpa slutpunktsdiagnostik kan administratörer säkerställa tillförlitlig drift och lyckade datamigreringar. För beständiga eller komplexa problem erbjuder supportpaketet en väg till djupare analys och hjälp från Microsoft Support.

Dessa interna diagnostikverktyg kan användas med vanliga verktyg och tekniker för nätverksfelsökning.

Den här artikeln beskriver tillgängliga metoder för felsökning av problem med agentnätverk. Rekommenderade felsökningssteg omfattar konfigurationskontroller, anslutningstester, slutpunktsdiagnostik och användning av supportverktyg.

Översikt över nätverkskonfiguration

Det rekommenderade första steget för att diagnostisera nätverksproblem är att inspektera agentens nätverkskonfiguration. Den här kontrollen kan göras via verktyget Visa nätverkskonfiguration som finns i gruppen Nätverkskonfiguration på agentens meny.

Verktyget Visa nätverkskonfiguration visar viktig information, till exempel:

  • DHCP-status
  • IP-adress och nätmask
  • MAC-adress
  • Länk och driftstillstånd
  • Hastighet och MTU
  • DNS-servrar och routningstabell
  • Standardinställningar för gateway och proxy
  • NTP-serverkonfiguration

I följande exempel visas exempelutdata från verktyget:

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]

När en agent nätverkskonfiguration inspekteras anger alla fält som innehåller tomma eller felaktiga värden en potentiell felkonfiguration av hypervisorns nätverkskortinställningar eller agentens gränssnittsinställningar. Till exempel ett tomt IP address värde eller en Link annan Operstate status än up antyder att agenten kanske inte är korrekt ansluten till nätverket. I sådana fall bör administratörer verifiera inställningarna för hypervisor-nätverkskortet eller konfigurera om agentens gränssnittsinställningar.

Anslutningstestning

När nätverkskonfigurationen har verifierats är nästa steg att testa anslutningen till agentens viktiga Azure-slutpunkter. Agenten tillhandahåller flera verktyg för detta ändamål och gör att du kan välja den detaljnivå som krävs för dina felsökningsbehov. Du kan välja mellan allmänna anslutningstester, utförliga utdata för djupare analys eller testning av enskilda slutpunkter för riktad diagnostik. Alla tre alternativen ger värdefulla insikter om agentens nätverksanslutning och kan hjälpa dig att identifiera potentiella problem.

Verktyg för anslutningstestning finns i gruppen Nätverkskonfiguration på agentens meny.

Allmänna nätverkskontroller

För allmän anslutningstestning väljer du alternativet Testa nätverksanslutning . Det här verktyget verifierar HTTPS-anslutningen till viktiga Azure-slutpunkter, inklusive de slutpunkter som krävs för agentregistrering och åtgärder. Verktyget använder azcmagent check kommandot för att testa Azure Arc-slutpunkter och kontrollerar sedan Storage Mover-specifika slutpunkter. Resultatet av dessa tester är:

  • HTTPS-nåbarhet
  • Status för DNS-upplösning
  • IP-typ, antingen privat eller offentlig
  • Proxyanvändning

Anmärkning

Det här testet innehåller inte lagringskonto- eller Key Vault-slutpunkter som används under jobbkörningen.

Utförliga nätverkskontroller

Alternativet Test network connectivity verbosely ger en mer detaljerad analys av problem med nätverksanslutningen. Den här förbättrade versionen av den allmänna nätverkskontrollen ger detaljerade utdata från azcmagent och curl, inklusive HTTP-svarskoder och TLS-paketdata. Det är användbart för att diagnostisera SSL-relaterade problem eller inspektera specifika felmeddelanden.

Testning av en slutpunkt

Med Test single endpoint connectivity alternativet kan du testa anslutningen för en specifik slutpunkt. Förutom att testa lagringskonto- och Key Vault-slutpunkter som inte omfattas av den allmänna nätverkskontrollen tillåter det här verktyget riktad testning av en specifik slutpunkt med hjälp av:

  • nslookup för DNS-upplösning
  • traceroute för sökvägsanalys
  • curl för HTTPS-anslutning

I följande exempel visas exempelutdata från verktyget:

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

Statuskontroller för tjänst och jobb

Service and job Status På menyn finns två verktyg för att utvärdera agentens kopplingshälsa till Storage Mover Service och status för jobbs verkställande. Dessa verktyg, tjänstkommunikationsstatus och jobbsammanfattning, information och kopieringsloggar, hjälper till att utvärdera agentens registreringsstatus och jobbkörningsstatus.

  • Tjänstkommunikationsstatus: Verifierar agentens anslutning till Storage Mover Service.
  • Jobbsammanfattning, information och kopieringsloggar: Ge insikter om jobbprestanda, inklusive överföringshastigheter och potentiella nätverksfel som SSL-avlyssning.

Begränsade gränssnittsverktyg

Alternativet Open restricted shell tillåter körning av följande grundläggande nätverkskommandon. Dessa kommandon är användbara för manuell diagnostik och felsökning av anslutningsproblem med källresursen:

  • nslookup och ping för slutpunktstestning.
  • mount, showmountoch umount för SMB/NFS-delningsdiagnostik.

SMB-diagnostik

Inom Troubleshooting-gruppen samlar SMB Troubleshooting-alternativet in SMB-loggar för inkludering i supportpaketet. Det är viktigt för att diagnostisera problem med SMB-källresurser. Dessa loggar ger insikter om autentiseringsproblem, behörighetsproblem och anslutningsfel relaterade till SMB-resurser.

Insamling av supportpaket

Alternativet Collect support bundle aggregerar loggar från alla diagnostikverktyg förutom de begränsade gränssnittsverktygen. Den kan delas med Microsoft Support via SFTP och är den mest omfattande resursen för djupgående felsökning.

För mer hjälp med att samla in en agents supportpaket, hänvisa till artikeln Skapa, hämta och visa supportpaketet.

Vanliga nätverksproblem och lösningar

I följande lista beskrivs flera vanliga problem och deras lösningar:

  • DNS-upplösningsfel
    När du stöter på problem med DNS-matchning använder nslookup du verktyget, slutpunktstestning och verktyg för nätverkskonfiguration för att verifiera DNS-inställningarna.
  • HTTPS-anslutningsfel
    HTTPS-anslutningsfel kan ofta lösas genom att kontrollera brandväggs-/proxyinställningar, verifiera IP-adresser och granska utförliga curl-utdata.
  • Felkonfigurering av Arc Private Link-omfång
    Felkonfigurationer är ofta orsaken till de flesta problem med Private Link-omfånget. Lös dessa problem genom att se till att du får rätt svar under nätverkskontroller och verifierar nödvändiga IP-typer för slutpunkter.
  • SSL-avlyssningsfel
    Leta efter "x509: certifikat signerat av okänd utfärdare" i utförliga loggar eller kopieringsloggar. Det kan vara nödvändigt att vitlista slutpunkter.

Nästa steg

Det kan vara bra med information i följande artiklar:

  • Last updated on