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

Artigo
10/16/2019

Importante

O Analisador de Internet do Azure foi desativado em 15 de março de 2024. Para obter informações detalhadas, confira Desativação do Analisador de Internet do Azure.

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

Importante

Essa versão prévia pública é fornecida sem um SLA e não deve ser usada para cargas de trabalho de produção. Determinados recursos podem não ter suporte, podem ter restrição 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 versão prévia pública está disponível para uso global. No entanto, o armazenamento de dados está 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 - testes são criados em um perfil do Analisador da Internet. Os perfis permitem que os 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 pontos de extremidade pré-configurados em seus testes.
Scorecards - um scorecard fornece resumos rápidos e significativos dos resultados da medição. Consulte Interpretar 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

Obtenha acesso à versão prévia do Analisador de Internet seguindo as instruções em Como fazer para participar da versão prévia? nas Perguntas frequentes do Analisador de Internet do Azure.
Instale a CLI do Azure.
Execute o login comando para iniciar uma sessão de 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.
Entre com suas credenciais de conta no navegador.
Selecione sua ID de assinatura que tenha recebido acesso à visualização pública do analisador da Internet.

Depois de entrar, você deve ver uma lista de assinaturas associadas à sua conta do Azure. A informação de assinatura com isDefault: true é a assinatura ativada no momento depois de entrar. 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 modo não interativo, como mostrado em detalhes em Entrar com a CLI do Azure.

[Opcional] Criar um novo grupo de recursos do Azure:

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

Instalar a extensão do Analisador da Internet da CLI do Azure:
```
az extension add --name internet-analyzer
```

Criar um novo perfil do Analisador da Internet:

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

Listar 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"

Criar um novo teste no perfil do Analisador da Internet 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 www.contoso.com e www.microsoft.com estejam hospedando a imagem de um pixel (trans.gif) em caminhos personalizados. Se um caminho de objeto não for especificado explicitamente, o Analisador da Internet usará /apc/trans.gif como o caminho do objeto por padrão, que é onde os pontos de extremidade pré-configurados estão hospedando a imagem de um pixel. Observe também que o esquema (HTTPS/HTTP) não precisa ser especificado; o Analisador da Internet só dá suporte a pontos de extremidade HTTPS, portanto, pressupõe-se que seja HTTPS.

O novo teste deve aparecer sob o perfil do Analisador da Internet:

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

Saída de exemplo:

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

Para começar a gerar medições, o arquivo JavaScript apontado pelo scriptFileUri do teste deve ser inserido em seu aplicativo Web. Confira instruções específicas na página Inserir cliente do Analisador de Internet.

Você pode monitorar o progresso do teste controlando seu valor de "status":

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

Você pode inspecionar os resultados coletados do teste gerando séries temporais ou scorecards 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

Procure a referência à CLI do Analisador de Internet para obter a lista completa de comandos e exemplos de uso com suporte.
Leia as Perguntas frequentes sobre o Analisador de Internet.
Saiba mais sobre como inserir o Cliente do Analisador de Internet e criar um ponto de extremidade personalizado.

Compartilhar via

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

Antes de começar

Modelo de objeto

Criação de perfil e teste

Próximas etapas

Recursos adicionais