You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/operator-insights/data-product-create.md
+57-29Lines changed: 57 additions & 29 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,27 +24,18 @@ In this article, you learn how to create an Azure Operator Insights Data Product
24
24
- (Optional) If you plan to integrate Data Product with Microsoft Purview, you must have an active Purview account. Make note of the Purview collection ID when you [set up Microsoft Purview with a Data Product](purview-setup.md).
25
25
- After obtaining your subscription access, register the Microsoft.NetworkAnalytics and Microsoft.HybridNetwork Resource Providers (RPs) to continue. For guidance on registering RPs in your subscription, see [Register resource providers in Azure](../azure-resource-manager/management/resource-providers-and-types.md#azure-portal).
26
26
27
-
### For CMK-based data encryption or Microsoft Purview
27
+
##Prepare your Azure portal or Azure CLI environment
28
28
29
-
If you're using CMK-based data encryption or Microsoft Purview, you must set up Azure Key Vault and user-assigned managed identity (UAMI) as prerequisites.
30
-
31
-
#### Set up Azure Key Vault
29
+
You can use the Azure portal or the Azure CLI to follow the steps in this article.
32
30
33
-
Azure key Vault Resource is used to store your Customer Managed Key (CMK) for data encryption. Data Product uses this key to encrypt your data over and above the standard storage encryption. You need to have Subscription/Resource group owner permissions to perform this step.
34
31
35
32
# [Portal](#tab/azure-portal)
36
33
37
-
1.[Create an Azure Key Vault resource](../key-vault/general/quick-create-portal.md) in the same subscription and resource group where you intend to deploy the Data Product resource.
38
-
1. Provide your user account with the Key Vault Administrator role on the Azure Key Vault resource. This is done via the **Access Control (IAM)** tab on the Azure Key Vault resource.
39
-
1. Navigate to the object and select **Keys**. Select **Generate/Import**.
40
-
1. Enter a name for the key and select **Create**.
41
-
1. Select the newly created key and select the current version of the key.
42
-
1. Copy the Key Identifier URI to your clipboard to use when creating the Data Product.
34
+
Confirm that you can sign in to the [Azure portal](https://portal.azure.com) and can access the subscription.
43
35
44
36
# [Azure CLI](#tab/azure-cli)
45
-
<!-- CLI link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-cli.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
46
37
47
-
You can sign in to Azure and run Azure CLI commands in one of two ways:
38
+
You can run Azure CLI commands in one of two ways:
48
39
49
40
- You can run CLI commands from within the Azure portal, in Azure Cloud Shell.
50
41
- You can install the CLI and run CLI commands locally.
@@ -63,17 +54,14 @@ The button launches an interactive shell that you can use to run the steps outli
63
54
### Install the Azure CLI locally
64
55
65
56
You can also install and use the Azure CLI locally. If you plan to use Azure CLI locally, make sure you have installed the latest version of the Azure CLI. See [Install the Azure CLI](/cli/azure/install-azure-cli).
66
-
Azure Cloud Shell is a free Bash shell that you can run directly within the Azure portal. The Azure CLI is preinstalled and configured to use with your account. Select the Cloud Shell button on the menu in the upper-right section of the Azure portal:
67
-
68
-
To launch Azure Cloud Shell, sign in to the Azure portal.
69
57
70
58
To log into your local installation of the CLI, run the az sign-in command:
71
59
72
60
```azurecli-interactive
73
61
az login
74
62
```
75
63
76
-
## Change the active subscription
64
+
###Change the active subscription
77
65
78
66
Azure subscriptions have both a name and an ID. You can switch to a different subscription using [az account set](/cli/azure/account#az-account-set) specifying the desired subscription ID or name.
79
67
@@ -84,16 +72,55 @@ az account set --subscription "My Demos"
84
72
# change the active subscription using the subscription ID
85
73
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
86
74
```
75
+
---
87
76
88
77
## Create a resource group
89
78
90
-
A resource group is a logical container into which Azure resources are deployed and managed. Use the az group create command to create a resource group named myResourceGroup in the eastus location.
79
+
A resource group is a logical container into which Azure resources are deployed and managed.
80
+
81
+
# [Portal](#tab/azure-portal)
82
+
83
+
If you plan to use CMK-based data encryption or Microsoft Purview, set up a resource group now:
84
+
85
+
1. Sign in to the [Azure portal](https://portal.azure.com).
86
+
1. Select **Resource groups**.
87
+
1. Select **Create** and follow the prompts.
88
+
89
+
For more information, see [Create a resource group](/azure-resource-manager/management/manage-resource-groups-portal#create-resource-groups).
90
+
91
+
If you don't plan to use CMK-based date encryption or Microsoft Purview, you can set up a resource group now or when you [the create the Data Product resource](#create-an-azure-operator-insights-data-product-resource).
92
+
93
+
# [Azure CLI](#tab/azure-cli)
94
+
95
+
Use the az group create command to create a resource group named myResourceGroup in the eastus location.
91
96
92
97
```azurecli-interactive
93
98
az group create --name "myResourceGroup" --location "EastUS"
94
99
```
100
+
---
101
+
102
+
## Set up resources for CMK-based data encryption or Microsoft Purview
103
+
104
+
If you're using CMK-based data encryption or Microsoft Purview, you must set up Azure Key Vault and user-assigned managed identity (UAMI) as prerequisites.
95
105
96
-
## Create a key vault
106
+
### Set up Azure Key Vault
107
+
108
+
Azure key Vault Resource is used to store your Customer Managed Key (CMK) for data encryption. Data Product uses this key to encrypt your data over and above the standard storage encryption. You need to have Subscription/Resource group owner permissions to perform this step.
109
+
110
+
# [Portal](#tab/azure-portal)
111
+
112
+
1.[Create an Azure Key Vault resource](../key-vault/general/quick-create-portal.md) in the same subscription and resource group where you intend to deploy the Data Product resource.
113
+
1. Provide your user account with the Key Vault Administrator role on the Azure Key Vault resource. This is done via the **Access Control (IAM)** tab on the Azure Key Vault resource.
114
+
1. Navigate to the object and select **Keys**. Select **Generate/Import**.
115
+
1. Enter a name for the key and select **Create**.
116
+
1. Select the newly created key and select the current version of the key.
117
+
1. Copy the Key Identifier URI to your clipboard to use when creating the Data Product.
118
+
119
+
# [Azure CLI](#tab/azure-cli)
120
+
121
+
<!-- CLI link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-cli.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
122
+
123
+
#### Create a key vault
97
124
98
125
Use the Azure CLI az keyvault create command to create a Key Vault in the resource group from the previous step. You will need to provide some information:
99
126
@@ -117,7 +144,7 @@ Vault Name: The name you provided to the --name parameter above.
117
144
Vault URI: In the example, this is https://<your-unique-keyvault-name>.vault.azure.net/. Applications that use your vault through its REST API must use this URI.
118
145
At this point, your Azure account is the only one authorized to perform any operations on this new vault.
119
146
120
-
##Key vault role assignment
147
+
#### Assign roles for the key vault
121
148
122
149
Provide your user account with the Key Vault Administrator role on the Azure Key Vault resource.
123
150
@@ -126,19 +153,19 @@ az role assignment create --role "Key Vault Administrator" --assignee <<user ema
126
153
```
127
154
Replace the values for subscriptionid, resource-group-name, and key-vault-name with the appropriate values.
128
155
129
-
## Create a Key
156
+
####Create a Key
130
157
131
158
```azurecli-interactive
132
159
az keyvault key create --vault-name "<your-unique-keyvault-name>" -n ExampleKey --protection software
133
160
```
134
161
135
162
From the output screen copy the KeyID and store it in your clipboard for later use.
136
163
137
-
<!-- PowerShell link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-powershell.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
138
-
139
164
---
140
165
141
-
#### Set up user-assigned managed identity
166
+
<!-- PowerShell link is [Create an Azure Key Vault resource](../key-vault/general/quick-create-powershell.md) in the same subscription and resource group where you intend to deploy the Data Product resource. -->
167
+
168
+
### Set up a user-assigned managed identity
142
169
143
170
# [Portal](#tab/azure-portal)
144
171
@@ -149,6 +176,8 @@ From the output screen copy the KeyID and store it in your clipboard for later u
149
176
150
177
<!-- Managed identity link for the CLI: /entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-azcli -->
151
178
179
+
#### Create a user-assigned managed identity
180
+
152
181
To create a user-assigned managed identity, your account needs the Managed Identity Contributor role assignment.
153
182
154
183
Use the az identity create command to create a user-assigned managed identity. The -g parameter specifies the resource group where to create the user-assigned managed identity. The -n parameter specifies its name. Replace the <RESOURCEGROUP> and <USERASSIGNEDIDENTITYNAME> parameter values with your own values.
Copy the principalId from the output screen and store it in your clipboard for later use.
165
194
166
-
## Assign User-Assigned Managed Identity to Key Vault
195
+
####Assign the user-assigned managed identity to the key vault
167
196
168
197
```azurecli-interactive
169
198
az role assignment create --role "Key Vault Administrator" --assignee <<pricipalID from above step>> --scope /subscriptions/{subscriptionid}/resourcegroups/{resource-group-name}/providers/Microsoft.KeyVault/vaults/{key-vault-name}
170
199
```
171
200
172
-
<!-- Managed identity link for PowerShell: /entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-powershell -->
173
-
174
201
---
175
202
203
+
<!-- Managed identity link for PowerShell: /entra/identity/managed-identities-azure-resources/how-manage-user-assigned-managed-identities?pivots=identity-mi-methods-powershell -->
176
204
177
-
## Create an Azure Operator Insights Data Product resource in the Azure portal
205
+
## Create an Azure Operator Insights Data Product resource
178
206
179
207
You create the Azure Operator Insights Data Product resource.
180
208
@@ -256,7 +284,7 @@ For ownersemail, vaulturi, keyname, version, purviewaccount, collection, uami an
256
284
257
285
---
258
286
259
-
## Deploy Sample Insights
287
+
## Deploy sample insights
260
288
261
289
Once your Data Product instance is created, you can deploy a sample insights dashboard. This dashboard works with the sample data that came along with the Data Product instance.
0 commit comments