使用 CLI(预览版)创建 Internet 分析器测试
重要
Azure Internet Analyzer 已于 2024 年 3 月 15 日停用。 有关详细信息,请参阅 Azure Internet 分析器停用。
创建 Internet 分析器资源有两种方法:使用 Azure 门户或使用 CLI。 本本分将介绍如何使用 CLI 体验创建新的 Azure Internet 分析器资源。
重要
此公共预览版在提供时没有附带服务级别协议,不应用于生产工作负荷。 某些功能可能不受支持或受到约束,或者不一定在所有 Azure 位置都可用。 有关详细信息,请参阅 Microsoft Azure 预览版补充使用条款。
开始之前
公开预览版可以全局使用;但是,在预览期间,只有美国西部 2 支持数据存储 。
对象模型
Internet 分析器 CLI 将公开以下类型的资源:
- 测试 - 测试比较了两个 Internet 终结点(A 和 B)随时间变化的最终用户性能。
- 配置文件 - 测试是在 Internet 分析器配置文件下创建的。 配置文件允许对相关测试进行分组;单个配置文件可以包含一个或多个测试。
- 预配置的终结点 - 我们已使用各种配置(区域、加速技术等)设置了终结点。 你可以在测试中使用任何这些预配置的终结点。
- 记分卡 - 记分卡提供了快速而有意义的测量结果摘要。 请参阅解释记分卡。
- 时序 - 时序显示指标如何随时间变化。
配置文件和测试创建
按照 Azure Internet 分析器常见问题解答的“如何参与预览?”中的说明获得 Internet 分析器的预览版访问权限。
运行
login
命令以启动 CLI 会话:az login
如果 CLI 可以打开默认浏览器,它将这样做并加载 Azure 登录页。 否则,请在 https://aka.ms/devicelogin 处打开浏览器页,然后输入终端中显示的授权代码。
在浏览器中使用帐户凭据登录。
选择已获得 Internet 分析器公共预览版访问权限的订阅 ID。
登录后,你将看到与你的 Azure 帐户关联的订阅列表。 在使用
isDefault: true
的情况下显示的订阅信息是登录后当前已激活的订阅。 若要选择另一个订阅,请将 az account set 命令与要切换到的订阅 ID 配合使用。 有关订阅选择的详细信息,请参阅使用多个 Azure 订阅。有多种方法可用来以非交互方式登录,使用 Azure CLI 登录中详细介绍了这些方法。
[可选] 创建新的 Azure 资源组:
az group create --location eastus --name "MyInternetAnalyzerResourceGroup"
安装 Azure CLI Internet 分析器扩展:
az extension add --name internet-analyzer
创建新的 Internet 分析器配置文件:
az internet-analyzer profile create --location eastus --resource-group "MyInternetAnalyzerResourceGroup" --name "MyInternetAnalyzerProfile" --enabled-state Enabled
列出所有可用于新创建的配置文件的预配置终结点:
az internet-analyzer preconfigured-endpoint list --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile"
在新创建的 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.com
和www.microsoft.com
都在自定义路径下承载单像素图像 (trans.gif)。 如果未显式指定对象路径,则 Internet 分析器将默认使用/apc/trans.gif
作为对象路径,这是预配置的终结点承载单像素图像的位置。 另请注意,无需指定架构 (https/http);Internet 分析器仅支持 HTTPS 终结点,因此假定使用 HTTPS。新测试应出现在 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" } ]
若要开始生成测量,必须将测试的“scriptFileUri”指向的 JavaScript 文件嵌入 Web 应用程序中 。 可在嵌入 Internet 分析器客户端页上找到具体的说明。
可以通过跟踪测试的“状态”值来监视测试的进度:
az internet-analyzer test show --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile" --name "MyFirstInternetAnalyzerTest"
可以通过为测试生成时序或记分卡来检查测试收集的结果:
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
后续步骤
- 有关支持的命令和用法示例的完整列表,请浏览 Internet 分析器 CLI 参考。
- 阅读 Internet 分析器常见问题解答。
- 了解有关嵌入 Internet 分析器客户端和创建自定义终结点的详细信息。