Compartilhar via


Criar um teste do Analisador de Internet usando a CLI (versão prévia)

Importante

O Azure Internet Analyzer foi desativado no 15 de março de 2024. Para informações detalhadas, consulte desativação do Analisador de Internet do Azure.

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

Importante

Essa versão de avaliação pública é fornecida sem um contrato de nível de serviço e não deve ser usada para cargas de trabalho de produção. Alguns recursos podem não ter suporte, podem ter recursos restritos ou podem não estar disponíveis em todos os locais do Azure. Veja os Termos de Uso Adicionais para Visualizações do Microsoft Azure para obter detalhes.

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 versão prévia.

Modelo de objeto

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

  • Testes – um teste compara o desempenho do usuário final de dois pontos de extremidade da Internet (A e B) ao longo do tempo.
  • Perfis – Os testes são criados em um perfil do Analisador de Internet. Os perfis permitem que testes relacionados sejam agrupados; 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 endereços de destino preconfigurados em seus testes.
  • Scorecards – Um scorecard fornece resumos rápidos e significativos dos resultados da medida. Consulte Interpretação do Seu Scorecard.
  • 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 de visualização do Analisador da Internet seguindo as instruções do Como participar da visualização nas Perguntas Frequentes do Analisador da Internet do Azure.

  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 o navegador padrão, ela o fará e carregará uma página de entrada do Azure. Caso contrário, abra uma página de navegador em https://aka.ms/devicelogin e insira o código de autorização exibido no terminal.

  4. Entre com suas credenciais de conta no navegador.

  5. Selecione sua ID de Assinatura que recebeu acesso à visualização pública do Analisador de Internet.

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

    Há maneiras de entrar de forma não interativa, que são abordadas detalhadamente na entrada 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. Crie um novo perfil do Analisador de Internet:

    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 tanto www.contoso.com quanto 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 Analisador de Internet usará /apc/trans.gif como o caminho do objeto por padrão, que é 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 Analisador de Internet dá suporte apenas a pontos de extremidade HTTPS, portanto, HTTPS é assumido.

  11. O novo teste deve aparecer no perfil do Analisador de Internet:

    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 inserido em seu aplicativo Web. Instruções específicas podem ser encontradas na página Inserir Cliente do Analisador de Internet .

  13. Você pode monitorar o progresso do teste mantendo o controle de 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 quadros de pontuações 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óximas etapas