使用 CLI 创建 Internet 分析器测试(预览版)

重要

Azure Internet 分析器于 2024 年 3 月 15 日 停用。 有关详细信息,请参阅 Azure Internet 分析器停用

可通过两种方法创建 Internet 分析器资源 - 使用 Azure 门户 或使用 CLI。 本部分介绍如何使用 CLI 体验创建新的 Azure Internet 分析器资源。

重要

此公共预览版不附带服务级别协议,不应用于生产工作负荷。 某些功能可能不受支持,可能具有受约束的功能,或者可能无法在所有 Azure 位置使用。 有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款

开始之前

公共预览版在全球范围内可用,但其数据存储仅限于预览版期间 美国西部 2

对象模型

Internet 分析器 CLI 公开以下类型的资源:

  • 测试 - 测试 将一段时间内两个 Internet 终结点(A 和 B)的最终用户性能进行比较。
  • 配置文件 - 测试是在 Internet 分析器配置文件下创建的。 配置文件允许对相关测试进行分组;单个配置文件可能包含一个或多个测试。
  • 预配置终结点 - 我们已设置具有各种配置的终结点(区域、加速技术等)。 可以在测试中使用这些预配置终结点中的任何一个。
  • 记分卡 - 记分卡 提供度量结果的快速且有意义的摘要。 请参阅 解读您的记分卡
  • 时序 - 时序 显示指标随时间的变化。

用户档案和测试创建

  1. 按照 Azure Internet 分析器常见问题解答 中的 如何参与预览? 说明获取 Internet 分析器预览版访问权限。

  2. 安装 Azure CLI

  3. login运行命令以启动 CLI 会话:

    az login
    

    如果 CLI 可以打开默认浏览器,它将这样做并加载 Azure 登录页。 否则,请在 https://aka.ms/devicelogin 处打开浏览器页,然后输入终端中显示的授权代码。

  4. 在浏览器中使用帐户凭据登录。

  5. 选择已被授予 Internet 分析器公共预览版访问权限的订阅 ID。

    登录后,你将看到与你的 Azure 帐户关联的订阅列表。 登录后,isDefault: true 关联的订阅信息是当前激活的订阅。 若要选择另一个订阅,请使用 az account set 命令并指定订阅 ID 以进行切换。 有关订阅选择的详细信息,请参阅使用多个 Azure 订阅

    可通过多种方式以非交互方式登录,其中详细介绍 了如何使用 Azure CLI 登录

  6. [可选] 创建新的 Azure 资源组:

    az group create --location eastus --name "MyInternetAnalyzerResourceGroup"
    
  7. 安装 Azure CLI Internet 分析器扩展:

    az extension add --name internet-analyzer
    
  8. 创建新的 Internet 分析器配置文件:

    az internet-analyzer profile create --location eastus --resource-group "MyInternetAnalyzerResourceGroup" --name "MyInternetAnalyzerProfile" --enabled-state Enabled
    
  9. 列出新创建的配置文件中可用的所有预配置端点:

    az internet-analyzer preconfigured-endpoint list --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile"
    
  10. 在新建的 InternetAnalyzer 配置文件下创建新的测试:

    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
    

    假定上述命令中的www.contoso.comwww.microsoft.com都在自定义路径下托管一像素图像(trans.gif)。 如果未显式指定对象路径,Internet 分析器将默认用作 /apc/trans.gif 对象路径,即预配置终结点托管单像素图像的位置。 另请注意,不需要指定架构(https/http);Internet 分析器仅支持 HTTPS 终结点,因此假定使用 HTTPS。

  11. 新测试应显示在 Internet 分析器配置文件下:

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

    示例输出:

    [
        {
            "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. 若要开始生成度量,测试的 scriptFileUri 指向的 JavaScript 文件必须嵌入到 Web 应用程序中。 可以在 嵌入 Internet 分析器客户端 页上找到特定说明。

  13. 可以通过跟踪测试的“状态”值来监视测试的进度:

    az internet-analyzer test show --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile" --name "MyFirstInternetAnalyzerTest"
    
  14. 可以通过为其生成时间序列或记分卡来检查测试收集的结果。

    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
    

后续步骤