Skip to content

Commit 5a3ab2c

Browse files
SyntaxC4SyntaxC4
authored
Merge pull request #94307 from MicrosoftDocs/release-ignite-internet-analyzer
Ignite
2 parents 38ef9a7 + ab93797 commit 5a3ab2c

13 files changed

+702
-0
lines changed

‎articles/index.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1659,6 +1659,12 @@ featureFlags:
16591659
<p>Azure Private Link</p>
16601660
</a>
16611661
</li>
1662+
<li>
1663+
<a href="/azure/internet-analyzer/">
1664+
<img src="media/index/internet-analyzer.svg" alt="" />
1665+
<p>Azure Internet Analyzer</p>
1666+
</a>
1667+
</li>
16621668
</ul>
16631669
<h3>Security</h3>
16641670
<ul>
@@ -5582,6 +5588,25 @@ featureFlags:
55825588
</div>
55835589
</a>
55845590
</li>
5591+
<li>
5592+
<a href="/azure/internet-analyzer/">
5593+
<div class="cardSize">
5594+
<div class="cardPadding">
5595+
<div class="card">
5596+
<div class="cardImageOuter">
5597+
<div class="cardImage">
5598+
<img src="media/index/internet-analyzer.svg" alt="" />
5599+
</div>
5600+
</div>
5601+
<div class="cardText">
5602+
<h3>Azure Internet Analyzer</h3>
5603+
<p>Test how application and content delivery architectures in Azure impact your customers’ performance with this client-side measurement platform</p>
5604+
</div>
5605+
</div>
5606+
</div>
5607+
</div>
5608+
</a>
5609+
</li>
55855610
</ul>
55865611
</li>
55875612
<li>

‎articles/internet-analyzer/TOC.yml

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
- name: Internet Analyzer Documentation
2+
href: index.yml
3+
- name: Overview
4+
items:
5+
- name: About Internet Analyzer
6+
href: internet-analyzer-overview.md
7+
- name: Tutorial
8+
items:
9+
- name: Create an Internet Analyzer test using Portal
10+
href: internet-analyzer-create-test-portal.md
11+
- name: Create an Internet Analyzer test using CLI
12+
herf: internet-analyzer-cli.md
13+
- name: How-to guides
14+
items:
15+
- name: Embed client
16+
href: internet-analyzer-embed-client.md
17+
- name: Configure a custom endpoint
18+
href: internet-analyzer-custom-endpoint.md
19+
- name: Interpreting your scorecard
20+
href: internet-analyzer-scorecard.md
21+
- name: Resources
22+
items:
23+
- name: Internet Analyzer FAQ
24+
href: internet-analyzer-faq.md
25+
- name: Azure Roadmap
26+
href: https://azure.microsoft.com/roadmap/?category=networking
27+
- name: Blog
28+
href: https://azure.microsoft.com/blog/topics/networking
29+
- name: Forum
30+
href: https://social.msdn.microsoft.com/Forums/azure/home?forum=WAVirtualMachinesVirtualNetwork
31+
- name: Preview SLA
32+
href: https://azure.microsoft.com/support/legal/preview-supplemental-terms
33+
- name: SLA
34+
href: https://azure.microsoft.com/support/legal/sla
35+

‎articles/internet-analyzer/index.yml

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
### YamlMime:Landing
2+
3+
title: Azure Internet Analyzer documentation (Preview)
4+
summary: Internet Analyzer is a client-side measurement platform that enables you to test how networking infrastructure changes will impact your customers’ performance. Whether you’re migrating from on-premises to Azure or evaluating a new Azure service, Internet Analyzer allows you to learn from your users’ data and Microsoft’s rich analytics to better understand and optimize your network architecture with Azure—before you migrate.
5+
6+
metadata:
7+
title: Azure Internet Analyzer documentation (Preview)
8+
description: Internet Analyzer is a client-side measurement platform that enables you to test how networking infrastructure changes will impact your customers’ performance. Whether you’re migrating from on-premises to Azure or evaluating a new Azure service, Internet Analyzer allows you to learn from your users’ data and Microsoft’s rich analytics to better understand and optimize your network architecture with Azure—before you migrate.
9+
services: internet-analyzer
10+
ms.service: internet-analyzer
11+
ms.topic: landing-page
12+
author: megan-beatty #github alias
13+
ms.author: mebeatty
14+
ms.date: 10/16/2019
15+
16+
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | whats-new
17+
18+
landingContent:
19+
# Cards and links should be based on top customer tasks or top subjects
20+
# Start card title with a verb
21+
# Card
22+
- title: About Internet Analyzer
23+
linkLists:
24+
- linkListType: overview
25+
links:
26+
- text: What is Azure Internet Analyzer?
27+
url: internet-analyzer-overview.md
28+
29+
# Card
30+
- title: Get started
31+
linkLists:
32+
- linkListType: tutorial
33+
links:
34+
- text: Create an Internet Analyzer using Portal
35+
url: internet-analyzer-create-test-portal.md
36+
- text: Create an Internet Analyzer using CLI
37+
url: internet-analyzer-cli.md
38+
- linkListType: how-to-guide
39+
links:
40+
- text: Embed the Internet Analyzer Client
41+
url: internet-analyzer-embed-client.md
42+
- text: Configure a Custom Endpoint
43+
url: internet-analyzer-custom-endpoint.md
44+
45+
# Card
46+
- title: Resources
47+
linkLists:
48+
- linkListType: reference
49+
links:
50+
- text: Internet Analyzer FAQ
51+
url: internet-analyzer-faq.md
52+
- text: Interpreting your scorecard
53+
url: internet-analyzer-scorecard.md
54+

‎articles/internet-analyzer/internet-analyzer-cli.md

Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
---
2+
title: 'Create an Internet Analyzer test using CLI | Microsoft Docs'
3+
description: In this article, learn how to create your first Internet Analyzer test.
4+
services: internet-analyzer
5+
author: diego-perez-botero
6+
7+
ms.service: internet-analyzer
8+
ms.topic: tutorial
9+
ms.date: 10/16/2019
10+
ms.author: mebeatty
11+
# Customer intent: As someone interested in migrating to Azure/ AFD/ CDN, I want to set up an Internet Analyzer test to understand the expected performance impact to my end users.
12+
13+
---
14+
# Create an Internet Analyzer test using CLI (Preview)
15+
16+
There are two ways to create an Internet Analyzer resource - using the [Azure portal](internet-analyzer-create-test-portal.md) or using CLI. This section helps you create a new Azure Internet Analyzer resource using our CLI experience.
17+
18+
19+
> [!IMPORTANT]
20+
> This public preview is provided without a service level agreement and should not be used for production workloads. Certain features may not be supported, may have constrained capabilities, or may not be available in all Azure locations. See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for details.
21+
>
22+
23+
## Before you begin
24+
25+
The public preview is available to use globally; however, data storage is limited to *US West 2* during preview.
26+
27+
## Object model
28+
The Internet Analyzer CLI exposes the following types of resources:
29+
* **Tests** - A test compares the end-user performance of two internet endpoints (A and B) over time.
30+
* **Profiles** - Tests are created under an Internet Analyzer profile. Profiles allow for related tests to be grouped; a single profile may contain one or more tests.
31+
* **Preconfigured Endpoints** - We have set up endpoints with a variety of configurations (regions, acceleration technologies, etc.). You may use any of these preconfigured endpoints in your tests.
32+
* **Scorecards** - A scorecard provides quick and meaningful summaries of measurement results. Refer to [Interpreting your Scorecard](internet-analyzer-scorecard.md).
33+
* **Time Series** - A time series shows how a metric changes over time.
34+
35+
## Profile and Test Creation
36+
1. Get Internet Analyzer preview access by following the **How do I participate in the preview?** instructions from the [Azure Internet Analyzer FAQ](internet-analyzer-faq.md).
37+
2. [Install the Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli?view=azure-cli-latest).
38+
3. Run the `login` command to start a CLI session:
39+
```azurecli-interactive
40+
az login
41+
```
42+
43+
If the CLI can open your default browser, it will do so and load an Azure sign-in page.
44+
Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.
45+
46+
4. Sign in with your account credentials in the browser.
47+
48+
5. Select your Subscription ID that has been granted access to the Internet Analyzer public preview.
49+
50+
After logging in, you see a list of subscriptions associated with your Azure account. The subscription information with `isDefault: true` is the currently activated subscription after logging in. To select another subscription, use the [az account set](https://docs.microsoft.com/cli/azure/account#az-account-set) command with the subscription ID to switch to. For more information about subscription selection, see [Use multiple Azure subscriptions](https://docs.microsoft.com/cli/azure/manage-azure-subscriptions-azure-cli?view=azure-cli-latest).
51+
52+
There are ways to sign in non-interactively, which are covered in detail in [Sign in with Azure CLI](https://docs.microsoft.com/cli/azure/authenticate-azure-cli?view=azure-cli-latest).
53+
54+
6. **[Optional]** Create a new Azure Resource Group:
55+
```azurecli-interactive
56+
az group create --location eastus --name "MyInternetAnalyzerResourceGroup"
57+
```
58+
59+
7. Install the Azure CLI Internet Analyzer Extension:
60+
```azurecli-interactive
61+
az extension add --name internet-analyzer
62+
```
63+
64+
8. Create a new Internet Analyzer profile:
65+
```azurecli-interactive
66+
az internet-analyzer profile create --location eastus --resource-group "MyInternetAnalyzerResourceGroup" --name "MyInternetAnalyzerProfile" --enabled-state Enabled
67+
```
68+
69+
9. List all preconfigured endpoints available to the newly created profile:
70+
```azurecli-interactive
71+
az internet-analyzer preconfigured-endpoint list --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile"
72+
```
73+
74+
10. Create a new test under the newly created InternetAnalyzer profile:
75+
```azurecli-interactive
76+
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
77+
```
78+
79+
The command above assumes that both www.contoso.com and www.microsoft.com are hosting the one-pixel image ([trans.gif](https://fpc.msedge.net/apc/trans.gif)) under custom paths. If an object path isn't specified explicitly, Internet Analyzer will use `/apc/trans.gif` as the object path by default, which is where the preconfigured endpoints are hosting the one-pixel image. Also note that the schema (https/http) doesn't need to be specified; Internet Analyzer only supports HTTPS endpoints, so HTTPS is assumed.
80+
81+
11. The new test should appear under the Internet Analyzer profile:
82+
```azurecli-interactive
83+
az internet-analyzer test list --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile"
84+
```
85+
86+
Example output:
87+
````
88+
[
89+
{
90+
"description": null,
91+
"enabledState": "Enabled",
92+
"endpointA": {
93+
"endpoint": "www.contoso.com/some/path/to/1k.jpg",
94+
"name": "contoso"
95+
},
96+
"endpointB": {
97+
"endpoint": "www.microsoft.com/another/path/to/1k.jpg",
98+
"name": "microsoft"
99+
},
100+
"id": "/subscriptions/faa9ddd0-9137-4659-99b7-cdc55a953342/resourcegroups/MyInternetAnalyzerResourceGroup/providers/Microsoft.Network/networkexperimentprofiles/MyInternetAnalyzerProfile/experiments/MyFirstInternetAnalyzerTest",
101+
"location": null,
102+
"name": "MyFirstInternetAnalyzerTest",
103+
"resourceGroup": "MyInternetAnalyzerResourceGroup",
104+
"resourceState": "Enabled",
105+
"scriptFileUri": "https://fpc.msedge.net/client/v2/d8c6fc64238d464c882cee4a310898b2/ab.min.js",
106+
"status": "Created",
107+
"tags": null,
108+
"type": "Microsoft.Network/networkexperimentprofiles/experiments"
109+
}
110+
]
111+
````
112+
113+
12. To begin generating measurements, the JavaScript file pointed to by the test's **scriptFileUri** must be embedded in your Web application. Specific instructions can be found on the [Embed Internet Analyzer Client](internet-analyzer-embed-client.md) page.
114+
115+
13. You can monitor the test's progress by keeping track of its "status" value:
116+
```azurecli-interactive
117+
az internet-analyzer test show --resource-group "MyInternetAnalyzerResourceGroup" --profile-name "MyInternetAnalyzerProfile" --name "MyFirstInternetAnalyzerTest"
118+
```
119+
120+
14. You can inspect the test's collected results by generating timeseries or scorecards for it:
121+
```azurecli-interactive
122+
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"
123+
```
124+
125+
```azurecli-interactive
126+
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
127+
```
128+
129+
130+
## Next steps
131+
132+
* Read the [Internet Analyzer FAQ](internet-analyzer-faq.md)
133+
* Learn more about embedding the [Internet Analyzer Client](internet-analyzer-embed-client.md) and creating a [custom endpoint](internet-analyzer-custom-endpoint.md).

‎articles/internet-analyzer/internet-analyzer-create-test-portal.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
title: 'Create an Internet Analyzer test using Portal | Microsoft Docs'
3+
description: In this article, learn how to create your first Internet Analyzer test.
4+
services: internet-analyzer
5+
author: megan-beatty
6+
7+
ms.service: internet-analyzer
8+
ms.topic: tutorial
9+
ms.date: 10/16/2019
10+
ms.author: mebeatty
11+
## Customer intent: As someone interested in migrating to Azure/ AFD/ CDN, I want to set up an Internet Analyzer test to understand the expected performance impact to my end users.
12+
13+
---
14+
# Create an Internet Analyzer test using Portal (Preview)
15+
16+
There are two ways to create an Internet Analyzer resource- using the Azure portal or using [CLI](internet-analyzer-cli.md). This section helps you create a new Azure Internet Analyzer resource using our portal experience.
17+
18+
> [!IMPORTANT]
19+
> This public preview is provided without a service level agreement and should not be used for production workloads. Certain features may not be supported, may have constrained capabilities, or may not be available in all Azure locations. See the [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/) for details.
20+
>
21+
22+
## Before you begin
23+
24+
The public preview is available to use globally; however, data storage is limited to *US West 2* during preview.
25+
26+
## Basics
27+
28+
1. Get Internet Analyzer preview access by following the **How do I participate in the preview?** instructions from the [Azure Internet Analyzer FAQ](internet-analyzer-faq.md).
29+
2. From the home page in the [Azure portal](https://preview.portal.azure.com), click **+ Create a resource**. Internet Analyzer is currently only available from the preview version of the Azure portal.
30+
3. On the **New** page, search for "Internet Analyzer" in the *Search the Marketplace* field.
31+
4. Click **Internet Analyzer (preview)**. Make sure the publisher is *Microsoft* and the category is *Networking*.
32+
5. On the **Internet Analyzer (preview)** page, click **Create** to open the **Create an Internet Analyzer** page.
33+
6. Specify the following configuration settings for your Internet Analyzer resource:
34+
35+
* **Subscription:** The Azure subscription to host the new Internet Analyzer resource. ***Use the same Subscription ID used to request preview access.***
36+
* **Resource Group:** The Azure resource group that the new Internet Analyzer resource will be created in. If you don’t have an existing resource group, you can create a new one.
37+
* **Name:** The name of the new Internet Analyzer resource profile.
38+
* **Region:** The Azure public region that the resource will be created in. During preview, only *US West 2* is available.
39+
40+
7. When you have finished specifying your profile settings, click **Review + create**.
41+
42+
## Configuration
43+
44+
Completing the basic steps is a prerequisite to configuring a test and embedding the JavaScript client. Once you have created a profile, go to **Settings > Configuration** to configure your first test.
45+
46+
1. Give your test a name in the **Test Name** box.
47+
2. Add a description for your test in the **Description** field.
48+
3. Click **Configure Endpoint** - a tab will appear from the right-hand side. Select the type of endpoint you'd like to configure- a single Azure region, multiple Azure regions, or a custom endpoint.
49+
50+
>
51+
***Preconfigured endpoints: single and multiple Azure region combinations***
52+
* Select a region or set of regions from a [preconfigured list of Azure endpoints](internet-analyzer-faq.md).
53+
* Next, select the type of application or content delivery architecture you'd like to evaluate.
54+
* Single Azure region: Site acceleration ([Azure Front Door](https://azure.microsoft.com/services/frontdoor/)), static content caching ([Azure CDN for Microsoft](https://azure.microsoft.com/services/cdn/)), or none.
55+
* Multiple Azure regions: Site acceleration ([Azure Front Door](https://azure.microsoft.com/services/frontdoor/)), DNS steering ([Azure Traffic Manager](https://azure.microsoft.com/services/traffic-manager/))
56+
57+
***Custom endpoints***
58+
* Follow the instructions on the [Create Custom Endpoint](internet-analyzer-custom-endpoint.md) page.
59+
* Paste the HTTPS URL location of the one-pixel image in the portal.
60+
>
61+
62+
4. Click **Add** to add the endpoint to your test.
63+
5. Repeat steps 1-4 to configure your second endpoint. Endpoint B is always measured relative to Endpoint A - when configuring endpoints, consider which endpoint should be your test control.
64+
6. Click the **Save** button to save your test. Once you save a test, you can no longer edit the endpoints of a particular test.
65+
7. Select the test(s) you want to start and click **Start test**. This will change the ***State*** of your test(s) to ***Running***. You may start tests at any time, but the JavaScript client must be embedded for the test to start collecting measurements.
66+
8. Add more tests at any point. Note that the unique JavaScript client will not be generated until one test is created.
67+
68+
## Embed Client
69+
70+
To begin any test, the JavaScript client must be embedded in your Web application. After configuring at least one test, click **Review + create**, go to **Settings > Configuration**, and copy the JavaScript client. Specific instructions can be found on the [Embed Internet Analyzer Client](internet-analyzer-embed-client.md) page.
71+
72+
## Next steps
73+
74+
* Read the [Internet Analyzer FAQ](internet-analyzer-faq.md)
75+
* Learn more about embedding the [Internet Analyzer Client](internet-analyzer-embed-client.md) and creating a [custom endpoint](internet-analyzer-custom-endpoint.md).

0 commit comments

Comments
 (0)