Creación de una prueba de Internet Analyzer mediante la CLI (versión preliminar)

Hay dos maneras de crear un recurso de Internet Analyzer mediante Azure Portal o la CLI. Esta sección le ayuda a crear un nuevo recurso de Azure Internet Analyzer mediante nuestra experiencia de la CLI.

Antes de empezar

La versión preliminar pública está disponible para usarse globalmente; sin embargo, el almacenamiento de datos se limita a Oeste de EE. UU. 2 durante la versión preliminar.

Modelo de objetos

La CLI de Internet Analyzer expone los siguientes tipos de recursos:

• Pruebas : una prueba compara el rendimiento del usuario final de dos puntos de conexión de Internet (A y B) a lo largo del tiempo.
• Perfiles: las pruebas se crean en un perfil de Internet Analyzer. Los perfiles permiten agrupar las pruebas relacionadas; un único perfil puede contener una o varias pruebas.
• Puntos de conexión preconfigurados: hemos configurado puntos de conexión con una variedad de configuraciones (regiones, tecnologías de aceleración, etc.). Puede usar cualquiera de estos puntos de conexión preconfigurados en las pruebas.
• Cuadros de mandos : un cuadro de mandos proporciona resúmenes rápidos y significativos de los resultados de la medición. Consulte Interpretación de su Tarjeta de Puntuación.
• Serie temporal: una serie temporal muestra cómo cambia una métrica a lo largo del tiempo.

Creación de perfiles y pruebas

1. Obtenga acceso a la versión preliminar de Internet Analyzer siguiendo las instrucciones de la sección ¿Cómo puedo participar en la versión preliminar? en el FAQ de Azure Internet Analyzer.

2. Instalación de la CLI de Azure.

3. Ejecute el comando para iniciar una sesión de la login CLI:

   az login
   

   Si la CLI puede abrir el explorador predeterminado, lo hará y cargará una página de inicio de sesión de Azure. En caso contrario, abra una página del explorador en https://aka.ms/devicelogin y escriba el código de autorización que se muestra en el terminal.

4. Inicie sesión con las credenciales de su cuenta en el explorador.

5. Seleccione el identificador de suscripción al que se ha concedido acceso a la versión preliminar pública de Internet Analyzer.

   Después de iniciar sesión, verá una lista de suscripciones asociadas con su cuenta de Azure. The subscription information with isDefault: true is the currently activated subscription after logging in. Para seleccionar otra suscripción, use el comando az account set con el identificador de suscripción al que cambiar. Para más información sobre la selección de suscripción, consulte Uso de varias suscripciones de Azure.

   There are ways to sign in non-interactively, which are covered in detail in Sign in with Azure CLI.

6. [Opcional] Cree un nuevo grupo de recursos de Azure:

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

7. Instale la extensión de Internet Analyzer de la CLI de Azure:

   az extension add --name internet-analyzer
   

8. Cree un nuevo perfil de Internet Analyzer:

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

9. Enumere todos los puntos de conexión preconfigurados disponibles para el perfil recién creado:

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

10. Cree una nueva prueba en el perfil de InternetAnalyzer recién creado:

    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
    

    El comando anterior supone que tanto www.contoso.com como www.microsoft.com están hospedando la imagen de un solo píxel (trans.gif) en rutas de acceso personalizadas. Si no se especifica explícitamente una ruta de acceso de objeto, Internet Analyzer usará /apc/trans.gif como ruta de acceso de objeto de forma predeterminada, que es donde los puntos de conexión preconfigurados hospedan la imagen de un píxel. Tenga en cuenta también que no es necesario especificar el esquema (https/http); Internet Analyzer solo admite puntos de conexión HTTPS, por lo que se asume HTTPS.

11. La nueva prueba debe aparecer en el perfil de Internet Analyzer:

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

    Ejemplo de resultado:

    [
        {
            "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"
        }
    ]
    

12. Para empezar a generar medidas, el archivo JavaScript al que apunta el scriptFileUri de la prueba debe estar incrustado en la aplicación web. Puede encontrar instrucciones específicas en la página Insertar cliente de Internet Analyzer.

13. Puede supervisar el progreso de la prueba realizando un seguimiento de su valor de "estado":

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

14. Puede inspeccionar los resultados recopilados de la prueba mediante la generación de timeeries o cuadros de mandos para ello:

    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
    

Pasos siguientes

• Examine la referencia de la CLI de Internet Analyzer para obtener la lista completa de comandos y ejemplos de uso admitidos.
• Lea las preguntas más frecuentes de Internet Analyzer.
• Obtenga más información sobre cómo incrustar el cliente de Internet Analyzer y crear un punto de conexión personalizado .