app-insights-create-new-resource.md

title	description	services	documentationcenter	author	manager	ms.assetid	ms.service	ms.workload	ms.tgt_pltfrm	ms.devlang	ms.topic	ms.date	ms.author
Create a new Azure Application Insights resource | Microsoft Docs	Manually set up Application Insights monitoring for a new live application.	application-insights		alancameronwills	douge	878b007e-161c-4e36-8ab2-3d7047d8a92d	application-insights	tbd	ibiza	na	article	12/02/2016	awills

Create an Application Insights resource

Azure Application Insights displays data about your application in a Microsoft Azure resource. Creating a new resource is therefore part of setting up Application Insights to monitor a new application. In many cases, this can be done automatically by the IDE, and that's the recommended way where it's available. But in some cases, you create a resource manually - for example, to have separate resources for development and production builds of your application.

After you have created the resource, you get its instrumentation key and use that to configure the SDK in the application. This sends the telemetry to the resource.

Sign up to Microsoft Azure

If you haven't got a Microsoft account, get one now. (If you use services like Outlook.com, OneDrive, Windows Phone, or XBox Live, you already have a Microsoft account.)

You'll also need a subscription to Microsoft Azure. If your team or organization has an Azure subscription, the owner can add you to it, using your Windows Live ID. You're only charged for what you use, and the default basic plan allows for a certain amount of experimental use free of charge.

When you've got access to a subscription, login to Application Insights at http://portal.azure.com, and use your Live ID to login.

Create an Application Insights resource

In the portal.azure.com, add an Application Insights resource:

• Application type affects what you see on the overview blade and the properties available in metric explorer. If you don't see your type of app, choose General.
• Subscription is your payment account in Azure.
• Resource group is a convenience for managing properties like access control. If you have already created other Azure resources, you can choose to put this new resource in the same group.
• Location is where we keep your data.
• Pin to dashboard puts a quick-access tile for your resource on your Azure Home page. Recommended.

When your app has been created, a new blade opens. This is where you'll see performance and usage data about your app.

To get back to it next time you login to Azure, look for your app's quick-start tile on the start board (home screen). Or click Browse to find it.

Copy the instrumentation key

The instrumentation key identifies the resource that you created. You'll need it to give to the SDK.

Install the SDK in your app

Install the Application Insights SDK in your app. This step depends heavily on the type of your application.

Use the instrumentation key to configure the SDK that you install in your application.

The SDK includes standard modules that send telemetry without you having to write any code. To track user actions or diagnose issues in more detail, use the API to send your own telemetry.

See telemetry data

Close the quick start blade to return to your application blade in the Azure portal.

Click the Search tile to see Diagnostic Search, where the first events will appear.

Click Refresh after a few seconds if you're expecting more data.

Creating a resource automatically

You can write a PowerShell script to create a resource automatically.

Next steps

• Create a dashboard
• Diagnostic Search
• Explore metrics
• Write Analytics queries