Tworzenie monitora połączeń przy użyciu elementu ARMClient

Artykuł
04/13/2023

Ważne

Od 1 lipca 2021 r. nie będzie można dodawać nowych testów w istniejącym obszarze roboczym ani włączać nowego obszaru roboczego w usłudze Network monitor wydajności. Nie będzie można również dodawać nowych monitorów połączeń w Monitor połączenia (wersja klasyczna). Możesz nadal używać testów i monitorów połączeń utworzonych przed 1 lipca 2021 r. Aby zminimalizować zakłócenia usługi w bieżących obciążeniach, zmigruj testy z monitor wydajności sieci lub przeprowadź migrację z Monitor połączenia (klasycznej) do nowej Monitor połączenia na platformie Azure Network Watcher przed 29 lutego 2024 r.

Dowiedz się, jak utworzyć Monitor połączenia do monitorowania komunikacji między zasobami przy użyciu elementu ARMClient. Obsługuje wdrożenia hybrydowe i wdrożenia w chmurze platformy Azure.

Zanim rozpoczniesz

W monitorach połączeń tworzonych w Monitor połączenia można dodać zarówno maszyny lokalne, jak i maszyny wirtualne platformy Azure jako źródła. Te monitory połączeń mogą również monitorować łączność z punktami końcowymi. Punkty końcowe mogą znajdować się na platformie Azure lub w innym adresie URL lub adresie IP.

Monitor połączenia obejmuje następujące jednostki:

Zasób monitora połączeń — zasób platformy Azure specyficzny dla regionu. Wszystkie poniższe jednostki są właściwościami zasobu monitora połączeń.
Punkt końcowy — źródło lub miejsce docelowe, które uczestniczy w kontroli łączności. Przykładami punktów końcowych są maszyny wirtualne platformy Azure, agenci lokalni, adresy URL i adresy IP.
Konfiguracja testu — konfiguracja specyficzna dla protokołu dla testu. Na podstawie wybranego protokołu można zdefiniować port, progi, częstotliwość testu i inne parametry.
Grupa testowa — grupa zawierająca źródłowe punkty końcowe, docelowe punkty końcowe i konfiguracje testowe. Monitor połączeń może zawierać więcej niż jedną grupę testową.
Test — kombinacja źródłowego punktu końcowego, docelowego punktu końcowego i konfiguracji testu. Test jest najbardziej szczegółowym poziomem, na którym są dostępne dane monitorowania. Dane monitorowania obejmują procent testów, które zakończyły się niepowodzeniem, oraz czas rundy (RTT).

Kroki tworzenia monitora połączeń przy użyciu klienta ARMClient

Użyj następującego kodu, aby utworzyć monitor połączeń przy użyciu elementu ARMClient.

$connectionMonitorName = "sampleConnectionMonitor"

$ARM = "https://management.azure.com"

$SUB = "subscriptions/<subscription id 1>;"

$NW = "resourceGroups/NetworkWatcherRG/providers/Microsoft.Network/networkWatchers/NetworkWatcher\_<region>"

$body =

"{

location: '<region>',

properties: {

endpoints: [{

name: 'endpoint_workspace_machine',

type: 'MMAWorkspaceMachine',

resourceId: '/subscriptions/<subscription id>/resourcegroups/<resource group>/providers/Microsoft.OperationalInsights/workspaces/sampleWorkspace',

//Example 1: Choose a machine

address : '<non-Azure machine FQDN>'
}

//Example 2: Select IP from chosen machines

address : '<non-Azure machine FQDN>

"scope": {
      "include": [
            {
                  "address": "<IP belonging to machine chosen above>"  
	    }
       ]
      }
   }    
   
name: 'endpoint_workspace_network',

type: 'MMAWorkspaceNetwork',

resourceId: '/subscriptions/<subscription id>/resourcegroups/<resource group>/providers/Microsoft.OperationalInsights/workspaces/sampleWorkspace',

 coverage level : 'high', //Optional
 
 //Include subnets. You can also exclude IPs from subnet to exclude from monitoring
 
 scope: {
      "include": [
            {
                  "address": "<subnet 1 mask>" // Eg: 10.10.1.0/28
            },
            {
                  "address": "<subnet 2 mask>" 
            }
      ],
      "exclude": [
      		{ 
      		"address" : "<ip-from-included-subnets-that-should-be-excluded>"
		}
      ]
     }
},

//Use a Azure VM as an endpoint
{

name: 'endpoint_virtualmachine',

resourceId: '/subscriptions/<subscription id>/resourceGroups/<resource group>/providers/Microsoft.Compute/virtualMachines/<vm-name>'

},

//Use an Azure VNET or Subnet as an endpoint

 {

name: 'endpoint_vnet_subnet',

resourceId: '<resource id of VNET or subnet'
coverage level: 'high' //Optional

//Scope is optional.

  "scope": {
      "include": [
            {
                  "address": "<subnet 1 mask>" // Eg: 10.10.1.0/28 .This subnet should match with any existing subnet in vnet
            }
      ],
    "exclude": [
            {
                  "address": "<ip-from-included-subnets-that-should-be-excluded>" // If used with include, IP should be part of the subnet defined above. Without include, this could be any address within vnet range or any specific subnet range as a whole.
            }
      ]
  }
   },

//Endpoint as a URL
{

name: 'azure portal'

address: '<URL>'

   },

//Endpoint as an IP 
 {

    name: 'ip',

     address: '<IP>'

 }

  ],

  testGroups: [{

    name: 'Connectivity to Azure Portal and Public IP',

    testConfigurations: ['http', 'https', 'tcpEnabled', 'icmpEnabled'],

    sources: ['vm1', 'workspace'],

    destinations: ['azure portal', 'ip']

   },

{

    name: 'Connectivty from Azure VM 1 to Azure VM 2',

   // Choose your protocol
   
    testConfigurations: ['http', 'https', 'tcpDisabled', 'icmpDisabled'],

    sources: ['vm1'],

    destinations: ['vm2'],

    disable: true

   }

  ],

  testConfigurations: [{

    name: 'http',

    testFrequencySec: <frequency>,

    protocol: 'HTTP',

    successThreshold: {

     checksFailedPercent: <threshold for checks failed %>,

     roundTripTimeMs: <threshold for RTT>

    }

   }, {

    name: 'https',

    testFrequencySec: <frequency>,

    protocol: 'HTTP',

    httpConfiguration: {
    
     port: '<port of choice>'
  
    preferHTTPS: true // If port chosen isn't 80 or 443
    
    method: 'GET', //Choose GET or POST
    
    path: '/', //Specify path for request
         
    requestHeaders: [
            {
              "name": "Content-Type",
              "value": "appication/json"
            }
          ],
          
    validStatusCodeRanges: [ "102", "200-202", "3xx" ], //Samples
          
    },

    successThreshold: {

     checksFailedPercent: <choose your checks failed threshold>,

     roundTripTimeMs: <choose your RTT threshold>

    }

   }, 
   {

    name: 'tcpEnabled',

    testFrequencySec: <frequency>,

    protocol: 'TCP',

    tcpConfiguration: {

     port: 80

    },

    successThreshold: {

     checksFailedPercent: <choose your checks failed threshold>,

     roundTripTimeMs: <choose your RTT threshold>

    }

   }, {

    name: 'icmpEnabled',

    testFrequencySec: <frequency>,

    protocol: 'ICMP',

    successThreshold: {

     checksFailedPercent: <choose your checks failed threshold>,

     roundTripTimeMs: <choose your RTT threshold>

    }

   }, {

    name: 'icmpDisabled',

    testFrequencySec: <frequency>,

    protocol: 'ICMP',

    icmpConfiguration: {

     disableTraceRoute: true

    },

    successThreshold: {

     checksFailedPercent: <choose your checks failed threshold>,

     roundTripTimeMs: <choose your RTT threshold>

    }

   }, {

    name: 'tcpDisabled',

    testFrequencySec: <frequency>,

    protocol: 'TCP',

    tcpConfiguration: {

     port: 80,

     disableTraceRoute: true

    },

    successThreshold: {

     checksFailedPercent: <choose your checks failed threshold>,

     roundTripTimeMs: <choose your RTT threshold>

    }

   }

  ]

 }

} "

Oto polecenie wdrożenia:

armclient PUT $ARM/$SUB/$NW/connectionMonitors/$connectionMonitorName/?api-version=2019-07-01 $body -verbose

Opis właściwości

connectionMonitorName — nazwa zasobu monitora połączeń
SUB — identyfikator subskrypcji, w której chcesz utworzyć monitor połączeń
NW — Network Watcher identyfikator zasobu, w którym zostanie utworzony cm
location — region, w którym zostanie utworzony monitor połączeń
Punkty końcowe
- name — unikatowa nazwa dla każdego punktu końcowego
- resourceId — w przypadku punktów końcowych platformy Azure identyfikator zasobu odnosi się do identyfikatora zasobu usługi Azure Resource Manager dla maszyn wirtualnych. W przypadku punktów końcowych innych niż Azure identyfikator zasobu odnosi się do identyfikatora zasobu usługi Azure Resource Manager dla obszaru roboczego usługi Log Analytics połączonego z agentami spoza platformy Azure.
- address — dotyczy tylko wtedy, gdy identyfikator zasobu nie jest określony lub jeśli identyfikator zasobu jest obszarem roboczym usługi Log Analytics. Jeśli jest używany z identyfikatorem zasobu usługi Log Analytics, oznacza to nazwę FQDN agenta, który może być używany do monitorowania. Jeśli jest używany bez identyfikatora zasobu, może to być adres URL lub adres IP dowolnego publicznego punktu końcowego.
- filter — w przypadku punktów końcowych innych niż azure użyj filtru, aby wybrać agentów z obszaru roboczego usługi Log Analytics, który będzie używany do monitorowania w zasobie monitora połączeń. Jeśli filtry nie są ustawione, wszyscy agenci należący do obszaru roboczego usługi Log Analytics mogą służyć do monitorowania
  - type — ustaw typ jako "Adres agenta"
  - address — ustaw adres jako nazwę FQDN agenta lokalnego
Grupy testowe
- name — nazwij grupę testową.
- testConfigurations — konfiguracje testów oparte na tym, które źródłowe punkty końcowe łączą się z docelowymi punktami końcowymi
- sources — wybierz z punktów końcowych utworzonych powyżej. Punkty końcowe źródłowe oparte na platformie Azure muszą mieć zainstalowane rozszerzenie azure Network Watcher, a punkty końcowe źródłowe nienależące do platformy Azure muszą mieć zainstalowanego agenta usługi Azure Log Analytics. Aby zainstalować agenta dla źródła, zobacz Instalowanie agentów monitorowania.
- destinations — wybierz z punktów końcowych utworzonych powyżej. Możesz monitorować łączność z maszynami wirtualnymi platformy Azure lub dowolnym punktem końcowym (publicznym adresem IP, adresem URL lub nazwą FQDN), określając je jako lokalizacje docelowe. W jednej grupie testowej można dodawać maszyny wirtualne platformy Azure, adresy URL Office 365, adresy URL Dynamics 365 i niestandardowe punkty końcowe.
- disable — to pole służy do wyłączania monitorowania dla wszystkich źródeł i miejsc docelowych, które określa grupa testowa.
Konfiguracje testów
- name — nazwa konfiguracji testu.
- testFrequencySec — określ, jak często źródła będą wysyłać polecenia ping do miejsc docelowych w określonym protokole i porcie. Możesz wybrać 30 sekund, 1 minutę, 5 minut, 15 minut lub 30 minut. Źródła przetestują łączność z miejscami docelowymi na podstawie wybranej wartości. Jeśli na przykład wybierzesz 30 sekund, źródła będą sprawdzać łączność z miejscem docelowym co najmniej raz w 30-sekundowym okresie.
- protocol — możesz wybrać protokół TCP, ICMP, HTTP lub HTTPS. W zależności od protokołu można wykonać niektóre konfiguracje specyficzne dla protokołu
  - preferHTTPS — określ, czy używać protokołu HTTPS za pośrednictwem protokołu HTTP, gdy używany port nie jest ani 80, ani 443
  - port — określ wybrany port docelowy.
  - disableTraceRoute — dotyczy to konfiguracji testowych, których protokół to TCP lub ICMP. Uniemożliwia odnajdywanie topologii topologii i przeskoku RTT ze przeskoku źródłami.
  - metoda — dotyczy to konfiguracji testowych, których protokół to HTTP. Wybierz metodę żądania HTTP — GET lub POST
  - path — określ parametry ścieżki do dołączania do adresu URL
  - validStatusCodes — wybierz odpowiednie kody stanu. Jeśli kod odpowiedzi nie jest zgodny z tą listą, zostanie wyświetlony komunikat diagnostyczny
  - requestHeaders — określ niestandardowe ciągi nagłówka żądania, które zostaną przekazane do miejsca docelowego
- successThreshold — można ustawić progi dla następujących parametrów sieci:
  - checkFailedPercent — ustaw procent testów, które mogą zakończyć się niepowodzeniem, gdy źródła sprawdzają łączność z miejscami docelowymi przy użyciu określonych kryteriów. W przypadku protokołu TCP lub ICMP procent nieudanych testów można porównać do wartości procentowej utraty pakietów. W przypadku protokołu HTTP to pole reprezentuje procent żądań HTTP, które nie otrzymały odpowiedzi.
  - roundTripTimeMs — ustaw wartość RTT w milisekundach, aby określić, jak długie źródła mogą potrwać, aby połączyć się z miejscem docelowym za pośrednictwem konfiguracji testowej.

Limity skalowania

Monitory połączeń mają następujące limity skalowania:

Maksymalna liczba monitorów połączeń na subskrypcję na region: 100
Maksymalna liczba grup testowych na monitor połączenia: 20
Maksymalna liczba źródeł i miejsc docelowych na monitor połączenia: 100
Maksymalna liczba konfiguracji testowych na monitor połączenia: 20 za pośrednictwem klasy ARMClient

Następne kroki

Dowiedz się , jak analizować dane monitorowania i ustawiać alerty
Dowiedz się , jak diagnozować problemy w sieci