Criar um teste do Internet Analyzer usando CLI (Visualização)

Há duas maneiras de criar um recurso do Internet Analyzer - usando o portal do Azure ou usando a CLI. Esta seção ajuda você a criar um novo recurso do Azure Internet Analyzer usando nossa experiência de CLI.

Antes de começar

A visualização pública está disponível para uso global; no entanto, o armazenamento de dados é limitado ao Oeste dos EUA 2 durante a visualização.

Modelo de objeto

A CLI do Internet Analyzer expõe os seguintes tipos de recursos:

• Testes - Um teste compara o desempenho do utilizador final de dois pontos finais da Internet (A e B) ao longo do tempo.
• Perfis - Os testes são criados sob um perfil do Internet Analyzer. Os perfis permitem agrupar os testes relacionados; Um único perfil pode conter um ou mais testes.
• Pontos de extremidade pré-configurados - Configuramos pontos de extremidade com uma variedade de configurações (regiões, tecnologias de aceleração, etc.). Você pode usar qualquer um desses pontos de extremidade pré-configurados em seus testes.
• Scorecards - Um scorecard fornece resumos rápidos e significativos dos resultados da medição. Consulte Interpretando o seu plano de avaliação.
• Série Temporal - Uma série temporal mostra como uma métrica muda ao longo do tempo.

Criação de Perfil e Teste

1. Obtenha acesso à pré-visualização do Internet Analyzer seguindo as instruções Como participo na pré-visualização? das Perguntas frequentes do Azure Internet Analyzer.

2. Instale a CLI do Azure.

3. Execute o login comando para iniciar uma sessão da CLI:

   az login
   

   Se a CLI puder abrir seu navegador padrão, ela fará isso e carregará uma página de entrada do Azure. Caso contrário, abra uma página do navegador em https://aka.ms/devicelogin e insira o código de autorização exibido no seu terminal.

4. Inicie sessão com as credenciais da sua conta no browser.

5. Selecione a ID de Assinatura à qual foi concedido acesso à visualização pública do analisador de Internet.

   Depois de iniciar sessão, vê uma lista de subscrições associadas à sua conta do Azure. As informações da subscrição com isDefault: true são a subscrição atualmente ativada após iniciar sessão. Para selecionar outra assinatura, use o comando az account set com o ID da assinatura para o qual alternar. Para obter mais informações sobre a seleção de assinaturas, consulte Usar várias assinaturas do Azure.

   Há maneiras de entrar de forma não interativa, que são abordadas em detalhes em Entrar com a CLI do Azure.

6. [Opcional] Crie um novo Grupo de Recursos do Azure:

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

7. Instale a extensão do Azure CLI Internet Analyzer:

   az extension add --name internet-analyzer
   

8. Crie um novo perfil do Internet Analyzer:

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

9. Liste todos os pontos de extremidade pré-configurados disponíveis para o perfil recém-criado:

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

10. Crie um novo teste no perfil do InternetAnalyzer recém-criado:

    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
    

    O comando acima pressupõe que ambos www.contoso.com e www.microsoft.com estão hospedando a imagem de um pixel (trans.gif) em caminhos personalizados. Se um caminho de objeto não for especificado explicitamente, o Internet Analyzer usará /apc/trans.gif como caminho do objeto por padrão, sendo este o local onde os pontos de extremidade pré-configurados hospedam a imagem de um pixel. Observe também que o esquema (https/http) não precisa ser especificado; O Internet Analyzer suporta apenas pontos de extremidade HTTPS, portanto, HTTPS é assumido.

11. O novo teste deve aparecer sob o perfil do Internet Analyzer:

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

    Exemplo de saída:

    [
        {
            "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 começar a gerar medidas, o arquivo JavaScript apontado pelo scriptFileUri do teste deve ser incorporado em seu aplicativo Web. Instruções específicas podem ser encontradas na página Embed Internet Analyzer Client .

13. Você pode monitorar o progresso do teste acompanhando seu valor de "status":

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

14. Você pode inspecionar os resultados coletados do teste gerando séries temporais ou cartões de pontuação para ele.

    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
    

Próximos passos

• Navegue pela referência da CLI do Internet Analyzer para obter a lista completa de comandos suportados e exemplos de uso.
• Leia as Perguntas frequentes do Internet Analyzer.
• Saiba mais sobre como incorporar o Internet Analyzer Client e criar um ponto de extremidade personalizado.