Criar um teste do Internet Analyzer com a CLI (Pré-visualização)

  • Artigo

Importante

O Azure Internet Analyzer foi descontinuado a 15 de março de 2024. Para obter informações detalhadas, veja Descontinuação do Azure Internet Analyzer.

Existem duas formas de criar um recurso do Internet Analyzer: utilizar o portal do Azure ou utilizar a CLI. Esta secção ajuda-o a criar um novo recurso do Azure Internet Analyzer com a nossa experiência da CLI.

Importante

Esta pré-visualização pública é disponibilizada sem um contrato de nível de serviço e não deve ser utilizada para cargas de trabalho de produção. Algumas funcionalidades podem não ser suportadas, podem ter capacidades restringidas ou podem não estar disponíveis em todas as localizações do Azure. Veja os Termos Suplementares de Utilização para Pré-visualizações do Microsoft Azure para obter mais informações.

Antes de começar

A pré-visualização pública está disponível para utilização global; no entanto, o armazenamento de dados está limitado a E.U.A. Oeste 2 durante a pré-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 num perfil do Internet Analyzer. Os perfis permitem o agrupamento de testes relacionados; um único perfil pode conter um ou mais testes.
  • Pontos Finais Pré-configurados – configurámos pontos finais com uma variedade de configurações (regiões, tecnologias de aceleração, etc.). Pode utilizar qualquer um destes pontos finais pré-configurados nos seus testes.
  • Tabelas de indicadores – uma tabela de indicadores fornece resumos rápidos e significativos dos resultados da medição. Veja Interpretar a Tabela de Indicadores.
  • Time Series – uma série temporal mostra como uma métrica muda ao longo do tempo.

Criação de Perfis e Testes

  1. Obtenha acesso de pré-visualização do Internet Analyzer ao seguir o Como devo proceder para participar na pré-visualização? instruções das FAQ 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 conseguir abrir o browser predefinido, irá fazê-lo e carregar uma página de início de sessão do Azure. Caso contrário, abra uma página do browser em https://aka.ms/devicelogin e introduza o código de autorização apresentado no terminal.

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

  5. Selecione o ID da Subscrição ao qual foi concedido acesso à pré-visualização pública do Internet Analyzer.

    Depois de iniciar sessão, verá 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 subscrição, utilize o comando az account set com o ID da subscrição para o qual mudar. Para obter mais informações sobre a seleção de subscrições, veja Utilizar várias subscrições do Azure.

    Existem formas de iniciar sessão de forma não interativa, que são abordadas em detalhe em Iniciar sessão com a CLI do Azure.

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

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

  7. Instale a Extensão do Analisador de Internet da CLI do Azure:

    az extension add --name internet-analyzer

  8. Criar um novo perfil do Internet Analyzer:

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

  9. Listar todos os pontos finais pré-configurados disponíveis para o perfil criado recentemente:

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

  10. Crie um novo teste no perfil do InternetAnalyzer recentemente 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 e www.contoso.comwww.microsoft.com estão a alojar a imagem de um pixel (trans.gif) em caminhos personalizados. Se um caminho de objeto não for especificado explicitamente, o Internet Analyzer utilizará /apc/trans.gif como o caminho do objeto por predefinição, que é onde os pontos finais pré-configurados estão a alojar a imagem de um pixel. Tenha também em atenção que o esquema (https/http) não precisa de ser especificado; O Internet Analyzer só suporta pontos finais HTTPS, pelo que o HTTPS é assumido.

  11. O novo teste deve aparecer no 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 ficheiro JavaScript apontado pelo scriptFileUri do teste tem de ser incorporado na sua aplicação Web. Podem ser encontradas instruções específicas na página Incorporar Cliente do Analisador de Internet .

  13. Pode monitorizar o progresso do teste ao controlar o respetivo valor de "estado":

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

  14. Pode inspecionar os resultados recolhidos do teste ao gerar intervalos de tempo ou tabelas de indicadores para os mesmos:

    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

Passos seguintes