workspace-enabled resources + pricing

Author: mrbullwinkle

articles/azure-monitor/app/create-new-resource.md

@@ -22,12 +22,13 @@ Sign in to the [Azure portal](https://portal.azure.com), and create an Applicati
 
    | Settings        |  Value           | Description  |
    | ------------- |:-------------|:-----|
-   | **Name**      | Unique value | Name that identifies the app you are monitoring. |
-   | **Resource Group**     | myResourceGroup      | Name for the new or existing resource group to host App Insights data. |
-   | **Location** | East US | Choose a location near you, or near where your app is hosted. |
+   | **Name**      | `Unique value` | Name that identifies the app you are monitoring. |
+   | **Resource Group**     | `myResourceGroup`      | Name for the new or existing resource group to host App Insights data. |
+   | **Region** | `East US` | Choose a location near you, or near where your app is hosted. |
+   | **Resource Mode** | `Classic` or `Workspace-based` | Workspace-based resources are currently in public preview and allow you to send your Application Insights telemetry to a common Log Analytics workspace. For more information see the [article on workspace-based resources]().
 
 > [!NOTE]
-> While you can use the same resource name across different resource groups, it can be beneficial to use a globally unique name. This can be useful if you plan to [perform cross resource queries](https://docs.microsoft.com/azure/azure-monitor/log-query/cross-workspace-query#identifying-an-application) as it simplifies the required syntax.
+> While you can use the same resource name across different resource groups, it can be beneficial to use a globally unique name.
 
 Enter the appropriate values into the required fields, and then select **Review + create**.
 

articles/azure-monitor/app/create-workspace-resource.md

@@ -0,0 +1,200 @@
+---
+title: Create a new Azure Application Insights resource | Microsoft Docs
+description: Manually set up Application Insights monitoring for a new live application.
+author: mrbullwinkle
+ms.author: mbullwin
+ms.topic: conceptual
+ms.date: 12/02/2019
+
+---
+
+## Workspace-based Application Insights resources (preview)
+
+Workspace-based resources support full integration between Application Insights and Log Analytics. You can now choose to send your Application Insights telemetry to a common Log Analytics workspace, which allows you full access to all the features of Log Analytics while keeping application, infrastructure, and platform logs in a single consolidated location.
+
+This also allows for common Role-Based Access Control (RBAC) across your resources, and eliminates the need for cross-app/workspace queries.
+
+> [!NOTE]
+> Data ingestion and retention for workspace-based Application Insights resources are billed through the Log Analytics workspace where the data is located. [Learn more]( https://docs.microsoft.com/azure/azure-monitor/app/pricing#workspace-based-application-insights) about billing for workspace-based Application Insights resources.
+
+To test out the new experience, sign in to the [Azure portal](https://portal.azure.com), and create an Application Insights resource:
+
+![Workspace-based Application Insights resource](./media/create-workspace-resource/create-workspace-based.png)
+
+If you don't already have an existing Log Analytics Workspace, [consult the Log Analytics workspace creation documentation](https://docs.microsoft.com/azure/azure-monitor/learn/quick-create-workspace).
+
+For the public preview **workspace-based resources are currently limited to West US 2, East US, and the Azure Government region.**
+
+Once your resource is created, you will see the corresponding workspace info in the **Overview** pane:
+
+![Workspace Name](./media/create-workspace-resource/workspace-name.png)
+
+Clicking the blue link text will take you to the associated Log Analytics workspace where you can take advantage of the new unified workspace query environment.
+
+> [!NOTE]
+> We still provide full backwards compatibility for your Application Insights classic resource queries, workbooks, and log-based alerts within the Application Insights experience. To query/view against the new workspace-based table structure/schema you must first navigate to your Log Analytics workspace. During the preview, selecting **Logs** from within the Application Insights panes will give you access to the classic Application Insights query experience.
+
+## Copy the connection string
+
+The [connection string]() identifies the resource that you want to associate your telemetry data with. It also allows you to modify the endpoints your resource will use as a destination for your telemetry. You will need to copy the connection string and add it to your application's code or to an environment variable.
+
+![Click and copy the instrumentation key](./media/create-new-resource/instrumentation-key.png)
+
+## Monitoring configuration
+
+Once a workspace-based Application Insights resource has been created, configuring monitoring is relatively straightforward. 
+
+### Code-based application monitoring
+
+For code-based application monitoring, you would just install the appropriate Application Insights SDK and point it to the instrumentation key or connection string to your newly created resource.  
+
+For detailed documentation on setting up an Application Insights SDK for code-based monitoring consult the language/framework specific documentation:
+
+- [ASP.NET](https://docs.microsoft.com/azure/azure-monitor/app/asp-net)
+- [ASP.NET Core ](https://docs.microsoft.com/azure/azure-monitor/app/asp-net-core)
+- [Background tasks & modern console applications (.NET/.NET Core)](https://docs.microsoft.com/azure/azure-monitor/app/worker-service)
+- [Classic console applications (.NET)](https://docs.microsoft.com/azure/azure-monitor/app/console) 
+- [Java ](https://docs.microsoft.com/azure/azure-monitor/app/java-get-started?tabs=maven)
+- [JavaScript](https://docs.microsoft.com/azure/azure-monitor/app/javascript)
+- [Node.js](https://docs.microsoft.com/azure/azure-monitor/app/nodejs)
+- [Python](https://docs.microsoft.com/en-us/azure/azure-monitor/app/opencensus-python)
+
+### Codeless monitoring and Visual Studio resource creation
+
+For codeless monitoring of services like Azure Functions and Azure App Services, you will also need to first create your workspace-based Application Insights resource and then point to that resource during the monitoring configuration phase.
+
+While these services offer the option to create a new Application Insights resource within their own resource creation process, resources created via these UI options are currently restricted to the classic Application Insights experience.
+
+The same applies to the resource creation experience in Visual Studio. You must select an existing workspace-based resource from with the Visual Studio monitoring enablement UI. Selecting create new resource from within Visual Studio will create a classic Application Insights resource.
+
+## Creating a resource automatically
+
+### Azure CLI
+
+To access the preview Application Insights Azure CLI commands, you first need to run:
+
+```azurecli
+ az extension add -n application-insights
+```
+
+If you don't run the `az extension add` command, you will see an error message that states: `az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.`
+
+Now you can run the following to create your Application Insights resource:
+
+```azurecli
+az monitor app-insights component create --app
+                                         --location
+                                         --resource-group
+                                         [--application-type]
+                                         [--ingestion-access {Disabled, Enabled}]
+                                         [--kind]
+                                         [--only-show-errors]
+                                         [--query-access {Disabled, Enabled}]
+                                         [--tags]
+                                         [--workspace]
+```
+
+#### Example
+
+```azurecli
+az monitor app-insights component create --app demoApp --location eastus --kind web -g my_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"
+```
+
+For the full Azure CLI documentation for this command,  consult the [Azure CLI documentation](https://docs.microsoft.com/cli/azure/ext/application-insights/monitor/app-insights/component?view=azure-cli-latest#ext-application-insights-az-monitor-app-insights-component-create).
+
+### Azure PowerShell
+
+The `New-AzApplicationInsights` PowerShell command does not currently support creating a workspace-based Application Insights resource. To create a workspace-based resource with PowerShell, you can use the Azure Resource Manager templates below and deploy with PowerShell.
+
+### Azure Resource Manager templates
+
+#### Template file
+
+```json
+{
+    "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
+    "contentVersion": "1.0.0.0",
+    "parameters": {
+        "name": {
+            "type": "string"
+        },
+        "type": {
+            "type": "string"
+        },
+        "regionId": {
+            "type": "string"
+        },
+        "tagsArray": {
+            "type": "object"
+        },
+        "requestSource": {
+            "type": "string"
+        },
+        "workspaceResourceId": {
+            "type": "string"
+        }
+    },
+    "resources": [
+        {
+            "name": "[parameters('name')]",
+            "type": "microsoft.insights/components",
+            "location": "[parameters('regionId')]",
+            "tags": "[parameters('tagsArray')]",
+            "apiVersion": "2020-02-02-preview",
+            "properties": {
+                "ApplicationId": "[parameters('name')]",
+                "Application_Type": "[parameters('type')]",
+                "Flow_Type": "Redfield",
+                "Request_Source": "[parameters('requestSource')]",
+                "WorkspaceResourceId": "[parameters('workspaceResourceId')]"
+            }
+        }
+    ]
+}
+```
+
+#### Parameters file
+
+```json
+{
+    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
+    "contentVersion": "1.0.0.0",
+    "parameters": {
+        "type": {
+            "value": "web"
+        },
+        "name": {
+            "value": "customresourcename"
+        },
+        "regionId": {
+            "value": "eastus"
+        },
+        "tagsArray": {
+            "value": {}
+        },
+        "requestSource": {
+            "value": "Custom"
+        },
+        "workspaceResourceId": {
+            "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
+        }
+    }
+}
+
+```
+
+## Modifying the associated workspace
+
+Once a workspace-based Application Insights resource has been created, you can modify the associated Log Analytics Workspace.
+
+From within the Application Insights resource pane, select **Properties** > **Change Workspace** > **Log Analytics Workspaces**
+
+## Next steps
+
+* [Explore metrics](../../azure-monitor/platform/metrics-charts.md)
+* [Write Analytics queries](../../azure-monitor/app/analytics.md)
+
+[api]: ../../azure-monitor/app/api-custom-events-metrics.md
+[diagnostic]: ../../azure-monitor/app/diagnostic-search.md
+[metrics]: ../../azure-monitor/platform/metrics-charts.md
+[start]: ../../azure-monitor/app/app-insights-overview.md