Erstellen eines Internet Analyzer-Tests mithilfe der Befehlszeilenschnittstelle (Vorschau)

Artikel
10/16/2019

Wichtig

Azure Internet Analyzer wurde am 15. März 2024 eingestellt. Ausführliche Informationen finden Sie unter Einstellung von Azure Internet Analyzer.

Es gibt zwei Möglichkeiten zum Erstellen einer Internet Analyzer-Ressource: über das Azure-Portal oder mithilfe der CLI. In diesem Abschnitt erfahren Sie, wie Sie eine neue Azure Internet Analyzer-Ressource mit der Befehlszeilenschnittstelle erstellen.

Wichtig

Diese öffentliche Vorschauversion wird ohne Servicelevelvereinbarung bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Unter Umständen werden bestimmte Features nicht unterstützt, verfügen über eingeschränkte Funktionen und sind nicht an allen Azure-Standorten verfügbar. Weitere Informationen finden Sie unter Ergänzende Nutzungsbedingungen für Microsoft Azure-Vorschauversionen.

Voraussetzungen

Die öffentliche Vorschau ist für die globale Verwendung verfügbar. Allerdings ist der Datenspeicher in der Vorschauphase auf USA, Westen 2 beschränkt.

Objektmodell

Die Internet Analyzer-Befehlszeilenschnittstelle macht die folgenden Ressourcentypen verfügbar:

Tests: Ein Test vergleicht die Endbenutzerleistung von zwei Internetendpunkten (A und B) im Zeitverlauf.
Profile: Tests werden unter einem Internet Analyzer-Profil erstellt. Profile ermöglichen das Gruppieren verwandter Tests. Ein einzelnes Profil kann einen Test oder mehrere Tests enthalten.
Vorkonfigurierte Endpunkte: Wir haben Endpunkte mit verschiedenen Konfigurationen (Regionen, Beschleunigungstechnologien usw.) eingerichtet. Sie können in Ihren Tests einen dieser vorkonfigurierten Endpunkte verwenden.
Scorecards: Eine Scorecard bietet kurze und aussagekräftige Zusammenfassungen der Messergebnisse. Informationen finden Sie unter Interpretieren Ihrer Scorecard.
Zeitreihen: Eine Zeitreihe zeigt, wie sich eine Metrik im Laufe der Zeit ändert.

Profil- und Testerstellung

Befolgen Sie die Anweisungen im Abschnitt Wie nehme ich an der Vorschauversion teil? der häufig gestellten Fragen zu Azure Internet Analyzer, um Zugriff auf die Vorschauversion von Internet Analyzer zu erhalten.
Installieren Sie die Azure-Befehlszeilenschnittstelle.
Führen Sie den Befehl login aus, um eine CLI-Sitzung zu starten:
```
az login
```
Die CLI öffnet Ihren Standardbrowser, sofern sie dazu in der Lage ist, und lädt eine Azure-Anmeldeseite. Öffnen Sie andernfalls die Browserseite https://aka.ms/devicelogin, und geben Sie den in Ihrem Terminal angezeigten Autorisierungscode ein.
Melden Sie sich im Browser mit Ihren Anmeldeinformationen an.
Wählen Sie die Abonnement-ID aus, der Zugriff auf die öffentliche Vorschau von Internet Analyzer gewährt wurde.

Nach der Anmeldung sehen Sie eine Liste der mit Ihrem Azure-Konto verknüpften Abonnements. Die Abonnementinformationen mit isDefault: true ist das momentan aktivierte Abonnement nach der Anmeldung. Zur Auswahl eines anderen Abonnements verwenden Sie den Befehl az account set mit der ID des Abonnements, zu dem Sie wechseln möchten. Weitere Informationen zur Abonnementauswahl finden Sie unter Verwenden mehrerer Azure-Abonnements.

Es gibt auch Wege, wie Sie sich nicht interaktiv anmelden können. Diese werden unter Anmelden mit der Azure CLI ausführlich beschrieben.

[Optional] Erstellen Sie eine neue Azure-Ressourcengruppe:

az group create --location eastus --name "MyInternetAnalyzerResourceGroup"

Installieren Sie die Azure CLI-Erweiterung für Internet Analyzer:
```
az extension add --name internet-analyzer
```

Erstellen Sie ein neues Internet Analyzer-Profil:

az internet-analyzer profile create --location eastus --resource-group "MyInternetAnalyzerResourceGroup" --name "MyInternetAnalyzerProfile" --enabled-state Enabled

Listen Sie alle vorkonfigurierten Endpunkte auf, die für das neu erstellte Profil verfügbar sind:

az internet-analyzer preconfigured-endpoint list --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile"

Erstellen Sie einen neuen Test unter dem neu erstellten Internet Analyzer-Profil:
```
az internet-analyzer test create --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile" --endpoint-a-name "contoso" --endpoint-a-endpoint "www.contoso.com/some/path/to/trans.gif" --endpoint-b-name "microsoft" --endpoint-b-endpoint "www.microsoft.com/another/path/to/trans.gif" --name "MyFirstInternetAnalyzerTest" --enabled-state Enabled
```
Beim obigen Befehl wird angenommen, dass sowohl für www.contoso.com als auch für www.microsoft.com das 1 Pixel große Bild (trans.gif) unter benutzerdefinierten Pfaden gehostet wird. Wird ein Objektpfad nicht explizit angegeben, verwendet Internet Analyzer standardmäßig /apc/trans.gif als Objektpfad. Dort wird das 1 Pixel große Bild von den vorkonfigurierten Endpunkten gehostet. Beachten Sie auch, dass das Schema (HTTPS/HTTP) nicht angegeben werden muss. Internet Analyzer unterstützt nur HTTPS-Endpunkte, daher wird von HTTPS ausgegangen.

Der neue Test sollte im Internet Analyzer-Profil angezeigt werden:

az internet-analyzer test list --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile"

Beispielausgabe:

[
    {
        "description": null,
        "enabledState": "Enabled",
        "endpointA": {
        "endpoint": "www.contoso.com/some/path/to/1k.jpg",
        "name": "contoso"
        },
        "endpointB": {
        "endpoint": "www.microsoft.com/another/path/to/1k.jpg",
        "name": "microsoft"
        },
        "id": "/subscriptions/faa9ddd0-9137-4659-99b7-cdc55a953342/resourcegroups/MyInternetAnalyzerResourceGroup/providers/Microsoft.Network/networkexperimentprofiles/MyInternetAnalyzerProfile/experiments/MyFirstInternetAnalyzerTest",
        "location": null,
        "name": "MyFirstInternetAnalyzerTest",
        "resourceGroup": "MyInternetAnalyzerResourceGroup",
        "resourceState": "Enabled",
        "scriptFileUri": "https://fpc.msedge.net/client/v2/d8c6fc64238d464c882cee4a310898b2/ab.min.js",
        "status": "Created",
        "tags": null,
        "type": "Microsoft.Network/networkexperimentprofiles/experiments"
    }
]

Damit mit dem Generieren von Messungen begonnen werden kann, muss die JavaScript-Datei, auf die mit dem scriptFileUri-Element des Tests verwiesen wird, in Ihre Webanwendung eingebettet werden. Genaue Anweisungen finden Sie auf der Seite Einbetten des Internet Analyzer-Clients.

Der Fortschritt des Tests kann anhand seines Statuswerts nachverfolgt werden:

az internet-analyzer test show --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile" --name "MyFirstInternetAnalyzerTest"

Sie können die gesammelten Ergebnisse des Tests überprüfen, indem Sie Zeitreihen oder Scorecards dafür erstellen:

az internet-analyzer show-scorecard --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile" --name "MyFirstInternetAnalyzerTest" --aggregation-interval "Daily" --end-date-time-utc "2019-10-24T00:00:00"

az internet-analyzer show-timeseries --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile" --name "MyFirstInternetAnalyzerTest" --aggregation-interval "Hourly" --start-date-time-utc "2019-10-23T00:00:00" --end-date-time-utc "2019-10-24T00:00:00" --timeseries-type MeasurementCounts

Nächste Schritte

Eine vollständige Liste der unterstützten Befehle sowie Anwendungsbeispiele finden Sie in der Referenz zur Befehlszeilenschnittstelle für Internet Analyzer.
Lesen Sie die häufig gestellten Fragen zu Internet Analyzer.
Informieren Sie sich ausführlicher über das Einbetten des Internet Analyzer-Clients und das Erstellen eines benutzerdefinierten Endpunkts.

Erstellen eines Internet Analyzer-Tests mithilfe der Befehlszeilenschnittstelle (Vorschau)

Voraussetzungen

Objektmodell

Profil- und Testerstellung

Nächste Schritte

Zusätzliche Ressourcen