Script di PowerShell per creare una risorsa di Application InsightsPowerShell script to create an Application Insights resource

Se si vuole monitorare una nuova applicazione oppure una nuova versione di un'applicazione con Azure Application Insights, è possibile configurare una nuova risorsa in Microsoft Azure.When you want to monitor a new application - or a new version of an application - with Azure Application Insights, you set up a new resource in Microsoft Azure. Questa risorsa verrà usata per analizzare e visualizzare i dati di telemetria provenienti dall'app.This resource is where the telemetry data from your app is analyzed and displayed.

Per automatizzare la creazione di una nuova risorsa con PowerShell.You can automate the creation of a new resource by using PowerShell.

Se, ad esempio, si intende sviluppare un'app per dispositivi mobili, è probabile che, in un dato momento, i clienti usino diverse versioni pubblicate dell'app.For example, if you are developing a mobile device app, it's likely that, at any time, there will be several published versions of your app in use by your customers. Se però si vuole evitare di combinare i risultati di telemetria delle diverse versioni,You don't want to get the telemetry results from different versions mixed up. è possibile fare in modo che il processo di compilazione crei una nuova risorsa per ogni compilazione.So you get your build process to create a new resource for each build.

Nota

Se si desidera creare un set di risorse simultaneamente, è consigliabile creare le risorse tramite un modello di Azure.If you want to create a set of resources all at the same time, consider creating the resources using an Azure template.

Script per creare una risorsa di Application InsightsScript to create an Application Insights resource

Vedere le specifiche dei cmdlet:See the relevant cmdlet specs:

Script di PowerShellPowerShell Script



###########################################
# Set Values
###########################################

# If running manually, uncomment before the first 
# execution to login to the Azure Portal:

# Add-AzureRmAccount / Login-AzureRmAccount

# Set the name of the Application Insights Resource

$appInsightsName = "TestApp"

# Set the application name used for the value of the Tag "AppInsightsApp" 

$applicationTagName = "MyApp"

# Set the name of the Resource Group to use.  
# Default is the application name.
$resourceGroupName = "MyAppResourceGroup"

###################################################
# Create the Resource and Output the name and iKey
###################################################

# Select the azure subscription
Select-AzureSubscription -SubscriptionName "MySubscription"

# Create the App Insights Resource


$resource = New-AzureRmResource `
  -ResourceName $appInsightsName `
  -ResourceGroupName $resourceGroupName `
  -Tag @{ applicationType = "web"; applicationName = $applicationTagName} `
  -ResourceType "Microsoft.Insights/components" `
  -Location "East US" `  # or North Europe, West Europe, South Central US
  -PropertyObject @{"Application_Type"="web"} `
  -Force

# Give owner access to the team

New-AzureRmRoleAssignment `
  -SignInName "myteam@fabrikam.com" `
  -RoleDefinitionName Owner `
  -Scope $resource.ResourceId 


# Display iKey
Write-Host "App Insights Name = " $resource.Name
Write-Host "IKey = " $resource.Properties.InstrumentationKey

Cosa fare con l'iKeyWhat to do with the iKey

Per identificare le singole risorse, viene usata una chiave di strumentazione (iKey),Each resource is identified by its instrumentation key (iKey). ovvero l'output dello script di creazione della risorsa.The iKey is an output of the resource creation script. Lo script di compilazione deve fornire l'iKey all'istanza di Application Insights SDK incorporata nell'app.Your build script should provide the iKey to the Application Insights SDK embedded in your app.

È possibile fornire l'iKey all'SDK in due modi diversi:There are two ways to make the iKey available to the SDK:

Vedere ancheSee also