Skapa och konfigurera Application Insights-resurser

Viktigt!

Den här artikeln gäller för arbetsytebaserade Application Insights-resurser . Klassiska Application Insights-resurser har dragits tillbaka. Övergå till arbetsytebaserade Application Insights för att dra nytta av nya funktioner.

Application Insights integreras med Log Analytics och skickar telemetri till en gemensam Log Analytics-arbetsyta. Den här konfigurationen ger fullständig åtkomst till Log Analytics-funktioner, konsoliderar loggar på en plats och möjliggör enhetlig rollbaserad åtkomstkontroll i Azure , vilket eliminerar behovet av frågor mellan appar och arbetsytor.

Bland de förbättrade funktionerna finns:

Kundhanterade nycklar - Kryptera dina vilande data med nycklar som endast är tillgängliga för dig.
Azure Private Link - Anslut Azure PaaS-tjänster på ett säkert sätt till ditt virtuella nätverk med hjälp av privata slutpunkter.
ByOS (Bring Your Own Storage) - Hantera data från .NET Profiler och Snapshot Debugger med principer för kryptering, livslängd och nätverksåtkomst.
Åtagandenivåer - Spara upp till 30% jämfört med betala-efter-användning.

Den här artikeln visar hur du skapar och konfigurerar Application Insights-resurser. Tillsammans med själva Application Insights-resursen kan du lägga till olika konfigurationer som att ange det dagliga taket och prisplanen. Du kan också skapa tillgänglighetstester, konfigurera måttaviseringar och automatisera processen med Hjälp av Azure Resource Manager.

Anteckning

Datainmatning och kvarhållning för arbetsytebaserade Application Insights-resurser faktureras via Log Analytics-arbetsytan där data finns. Mer information om fakturering finns i prisinformation för Azure Monitor-loggar.

Förutsättningar

En aktiv Azure-prenumeration.
Nödvändiga behörigheter för att skapa resurser.

Ytterligare krav

Inga ytterligare krav.

För att få åtkomst till Application Insights Azure CLI-kommandon måste du först köra:

az extension add -n application-insights

Om du inte kör az extension add kommandot visas ett felmeddelande som säger: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Skapa en Application Insights-resurs

Anteckning

Om du inte ansluter till en befintlig Log Analytics-arbetsyta när resursen skapas skapas en ny Log Analytics-resurs automatiskt tillsammans med din Application Insights-resurs.

När du skapar eller uppdaterar en arbetsytebaserad Application Insights-resurs och länkar den till en Log Analytics arbetsyta i en annan prenumeration måste identiteten som utför åtgärden ha behörighet på målarbetsytan för Microsoft.OperationalInsights/workspaces/sharedKeys/action. Det här kravet gäller även när båda prenumerationerna finns i samma Microsoft Entra klientorganisation. Om identiteten inte har den här behörigheten kan åtgärden misslyckas med ett 403 (Forbidden) fel. Bevilja den minsta behörighetsroll som innehåller den här åtgärden på målarbetsytan eller använd en arbetsyta i samma prenumeration som Application Insights-resursen.

Logga in på Azure-portalen.
Välj Skapa en resurs.
Öppna kategorin Övervakning och diagnostik och välj sedan Application Insights.
Ange all relevant information och Granska + skapa sedan din Application Insights-resurs.

När du har skapat resursen hittar du motsvarande arbetsyteinformation i fönstret Översikt för Application Insights.

Välj den blå länktexten för att gå till den associerade Log Analytics-arbetsytan där du kan dra nytta av den nya enhetliga arbetsytans frågemiljö.

Anteckning

Vi tillhandahåller fortfarande fullständig bakåtkompatibilitet för dina klassiska Application Insights-resursfrågor, arbetsböcker och loggbaserade aviseringar. Om du vill fråga eller visa den nya arbetsytebaserade tabellstrukturen eller schemat måste du först gå till Log Analytics-arbetsytan. Välj Loggar (analys) i Application Insights-fönstret för åtkomst till den klassiska Application Insights-frågeupplevelsen.

I följande Azure CLI exempel används kommandot az monitor app-insights component create.

# Set variables
resourceGroupName="<ResourceGroupName>"
resourceName="<ResourceName>"
azureRegion="<AzureRegion>"
workspaceName="<WorkspaceName>"

# Get the subscription ID from the current Azure CLI context
subscriptionId=$(az account show --query id --output tsv)

# Build the full resource ID for the Log Analytics workspace
workspaceResourceId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.OperationalInsights/workspaces/$workspaceName"

# Create a workspace-based Application Insights resource
az monitor app-insights component create \
  --app "$resourceName" \
  --location "$azureRegion" \
  --resource-group "$resourceGroupName" \
  --kind web \
  --application-type web \
  --workspace "$workspaceResourceId"

Anteckning

Azure CLI-kommandon använder Azure Resource Manager-slutpunkten i den aktuella CLI-kontexten, så management.azure.com inte behöver anges i kommandosyntaxen.

I följande Azure PowerShell exempel används cmdleten New-AzApplicationInsights.

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$resourceName = "<ResourceName>"
$azureRegion = "<AzureRegion>"
$workspaceName = "<WorkspaceName>"

# Get the subscription ID from the current Azure PowerShell context
$subscriptionId = (Get-AzContext).Subscription.Id

# Build the full resource ID for the Log Analytics workspace
$workspaceResourceId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.OperationalInsights/workspaces/$workspaceName"

# Define the parameters for the Application Insights resource
$newAzApplicationInsightsParams = @{
    ResourceGroupName   = $resourceGroupName
    Name                = $resourceName
    Location            = $azureRegion
    Kind                = "web"
    ApplicationType     = "web"
    WorkspaceResourceId = $workspaceResourceId
}

# Create a workspace-based Application Insights resource
New-AzApplicationInsights @newAzApplicationInsightsParams

Anteckning

Azure PowerShell-cmdletar använder Azure Resource Manager-slutpunkten i den aktuella Az-kontexten, så management.azure.com behöver inte anges i cmdletsyntaxen.

I följande REST-exempel används REST API-åtgärden Components.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "kind": "web",
  "location": "<AzureRegion>",
  "properties": {
    "Application_Type": "web",
    "WorkspaceResourceId": "/subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<WorkspaceName>"
  }
}

I följande Bicep-exempel används resurstypen Microsoft.Insights/components.

param subscriptionId string = '<SubscriptionId>'
param resourceGroupName string = '<ResourceGroupName>'
param resourceName string = '<ResourceName>'
param azureRegion string = '<AzureRegion>'
param workspaceName string = '<WorkspaceName>'

var workspaceResourceId = '/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/${workspaceName}'

resource applicationInsightsComponent 'Microsoft.Insights/components@<ApiVersion>' = {
  name: resourceName
  location: azureRegion
  kind: 'web'
  properties: {
    Application_Type: 'web'
    WorkspaceResourceId: workspaceResourceId
  }
}

Tips/Råd

Du kan använda VS Code Bicep-tillägget från Microsoft för att förenkla distributionsprocessen.

Besök utgivarens GitHub-lagringsplats för tilläggsrelaterade frågor.

I följande ARM-exempel (JSON) används Microsoft. Insikter/komponenter resurstyp.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "subscriptionId": {
      "type": "string",
      "defaultValue": "<SubscriptionId>"
    },
    "resourceGroupName": {
      "type": "string",
      "defaultValue": "<ResourceGroupName>"
    },
    "resourceName": {
      "type": "string",
      "defaultValue": "<ResourceName>"
    },
    "azureRegion": {
      "type": "string",
      "defaultValue": "<AzureRegion>"
    },
    "workspaceName": {
      "type": "string",
      "defaultValue": "<WorkspaceName>"
    }
  },
  "variables": {
    "workspaceResourceId": "[format('/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.OperationalInsights/workspaces/{2}', parameters('subscriptionId'), parameters('resourceGroupName'), parameters('workspaceName'))]"
  },
  "resources": [
    {
      "type": "Microsoft.Insights/components",
      "apiVersion": "<ApiVersion>",
      "name": "[parameters('resourceName')]",
      "location": "[parameters('azureRegion')]",
      "kind": "web",
      "properties": {
        "Application_Type": "web",
        "WorkspaceResourceId": "[variables('workspaceResourceId')]"
      }
    }
  ]
}

Konfigurera övervakning

När du har skapat en Application Insights-resurs konfigurerar du övervakning.

Hämta anslutningssträngen

Den anslutningssträng identifierar den resurs som du vill associera telemetridata med. Du kan också använda den för att ändra slutpunkterna som resursen använder som mål för telemetrin. Du måste kopiera anslutningssträng och lägga till den i programmets kod eller i en miljövariabel.

Så här hämtar du anslutningssträngen för application insights-resursen:

Öppna din Application Insights-resurs på Azure-portalen.
På översiktsfönstret i avsnittet Essentials, leta efter anslutningssträng.
Om du hovrar över anslutningssträngen visas en ikon som gör att du kan kopiera den till Urklipp.

I följande Azure CLI-exempel används kommandot az monitor app-insights component show.

# Set variables
resourceGroupName="<ResourceGroupName>"
resourceName="<ResourceName>"

# Retrieve the Application Insights component
az monitor app-insights component show \
  --resource-group "$resourceGroupName" \
  --app "$resourceName"

Leta efter fältet connectionString i JSON-svaret.

I följande Azure PowerShell exempel används cmdleten Get-AzApplicationInsights.

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$resourceName = "<ResourceName>"

# Define parameters for Get-AzApplicationInsights
$getAzApplicationInsightsParams = @{
    ResourceGroupName = $resourceGroupName
    Name              = $resourceName
}

# Retrieve the Application Insights component
Get-AzApplicationInsights @getAzApplicationInsightsParams

Leta efter egenskapen ConnectionString i utdata.

I följande REST-exempel används REST API-åtgärden Components.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}?api-version={apiVersion}
Authorization: Bearer {accessToken}

Leta efter fältet properties.connectionString i JSON-svaret.

Programövervakning med OpenTelemetry

För programövervakning med OpenTelemetry installerar du lämplig Azure Monitor OpenTelemetry Distro och pekar reťazec pripojenia på din nyligen skapade resurs.

Information om hur du konfigurerar programövervakning med OpenTelemetry finns i följande språkspecifika dokumentation:

Anteckning

För webbappar som riktar sig till webbläsare rekommenderar vi att du använder Application Insights JavaScript SDK.

Automatisk instrumentering

För övervakningstjänster som Azure Functions och Azure App Service kan du först skapa din Application Insights-resurs och sedan peka på den när du aktiverar övervakning. Du kan också skapa en ny Application Insights-resurs under aktiveringsprocessen.

Konfigurera Application Insights-resurser

Ändra den associerade arbetsytan

När du har skapat en Application Insights-resurs kan du ändra den associerade Log Analytics-arbetsytan.

Viktigt!

REST-anrop, ARM-mallar och Bicep mallar använder put-semantik (create-or-update). När du uppdaterar en Application Insights-komponent med hjälp av dessa metoder ska du ta med alla nödvändiga egenskaper som du vill behålla. Egenskaper som inte ingår kan återställas eller tas bort.

I Application Insights-resursen väljer du Egenskaper>Ändra arbetsyta>Log Analytics arbetsytor.

I följande Azure CLI-exempel används kommandot az monitor app-insights component update.

# Set variables
resourceGroupName="<ResourceGroupName>"
resourceName="<ResourceName>"
workspaceName="<WorkspaceName>"

# Get the subscription ID from the current Azure CLI context
subscriptionId=$(az account show --query id --output tsv)

# Build the full resource ID for the Log Analytics workspace
workspaceResourceId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.OperationalInsights/workspaces/$workspaceName"

# Update a workspace-based Application Insights resource
az monitor app-insights component update \
  --resource-group "$resourceGroupName" \
  --app "$resourceName" \
  --workspace "$workspaceResourceId"

I följande Azure PowerShell exempel används cmdleten Update-AzApplicationInsights.

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$resourceName = "<ResourceName>"
$workspaceName = "<WorkspaceName>"

# Get the subscription ID from the current Azure PowerShell context
$subscriptionId = (Get-AzContext).Subscription.Id

# Build the full resource ID for the Log Analytics workspace
$workspaceResourceId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.OperationalInsights/workspaces/$workspaceName"

# Define the parameters for the Application Insights resource
$updateAzApplicationInsightsParams = @{
    ResourceGroupName   = $resourceGroupName
    Name                = $resourceName
    WorkspaceResourceId = $workspaceResourceId
}

# Update a workspace-based Application Insights resource
Update-AzApplicationInsights @updateAzApplicationInsightsParams

I följande REST-exempel används REST API-åtgärden Components.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "location": "<AzureRegion>",
  "kind": "web",
  "properties": {
    "Application_Type": "web",
    "WorkspaceResourceId": "/subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<WorkspaceName>"
  }
}

I följande Bicep-exempel används resurstypen Microsoft.Insights components.

param subscriptionId string = '<SubscriptionId>'
param resourceGroupName string = '<ResourceGroupName>'
param resourceName string = '<ResourceName>'
param azureRegion string = '<AzureRegion>'
param workspaceName string = '<WorkspaceName>'

var workspaceResourceId = '/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/${workspaceName}'

resource applicationInsightsComponent 'Microsoft.Insights/components@<ApiVersion>' = {
  name: resourceName
  location: azureRegion
  kind: 'web'
  properties: {
    Application_Type: 'web'
    WorkspaceResourceId: workspaceResourceId
  }
}

I följande ARM-exempel (JSON) används Microsoft. Insights-komponenter resurstyp.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "subscriptionId": {
      "type": "string",
      "defaultValue": "<SubscriptionId>"
    },
    "resourceGroupName": {
      "type": "string",
      "defaultValue": "<ResourceGroupName>"
    },
    "resourceName": {
      "type": "string",
      "defaultValue": "<ResourceName>"
    },
    "azureRegion": {
      "type": "string",
      "defaultValue": "<AzureRegion>"
    },
    "workspaceName": {
      "type": "string",
      "defaultValue": "<WorkspaceName>"
    }
  },
  "variables": {
    "workspaceResourceId": "[format('/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.OperationalInsights/workspaces/{2}', parameters('subscriptionId'), parameters('resourceGroupName'), parameters('workspaceName'))]"
  },
  "resources": [
    {
      "type": "Microsoft.Insights/components",
      "apiVersion": "<ApiVersion>",
      "name": "[parameters('resourceName')]",
      "location": "[parameters('azureRegion')]",
      "kind": "web",
      "properties": {
        "Application_Type": "web",
        "WorkspaceResourceId": "[variables('workspaceResourceId')]"
      }
    }
  ]
}

Exportera telemetri

Den äldre funktionen för kontinuerlig export stöds inte för arbetsytebaserade resurser. Använd i stället Diagnostikinställningar.

Anteckning

Export av diagnostikinställningar kan öka kostnaderna. Mer information finns i Exportera telemetri från Application Insights. Prisinformation för den här funktionen finns på sidan med priser för Azure Monitor. Innan faktureringen börjar skickas meddelanden. Om du fortsätter att använda telemetriexport efter meddelandeperioden debiteras du enligt tillämpligt pris.

I Application Insights-resursen väljer du Diagnostikinställningar>Lägg till diagnostikinställning.

Du kan välja alla tabeller eller en delmängd av tabeller som ska arkiveras till ett lagringskonto. Du kan också strömma till en händelsehubb.

I följande Azure CLI exempel används kommandot az monitor diagnostic-settings create. Den skapar en diagnostikinställning som skickar loggar och mått från en Application Insights-resurs till ett lagringskonto.

# Set variables
resourceGroupName="<ResourceGroupName>"
resourceName="<ResourceName>"
storageAccountName="<StorageAccountName>"
diagnosticSettingName="<DiagnosticSettingName>"

# Get the subscription ID from the current Azure CLI context
subscriptionId=$(az account show --query id --output tsv)

# Build the full resource ID for the Application Insights component
resourceId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/components/$resourceName"

# Build the full resource ID for the storage account
storageAccountId="/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Storage/storageAccounts/$storageAccountName"

# Create the diagnostic setting
az monitor diagnostic-settings create \
  --name "$diagnosticSettingName" \
  --resource "$resourceId" \
  --storage-account "$storageAccountId" \
  --logs '[{"category":"AppRequests","enabled":true}]' \
  --metrics '[{"category":"AllMetrics","enabled":true}]'

I följande Azure PowerShell exempel används cmdleten New-AzDiagnosticSetting. Den skapar en diagnostikinställning som skickar loggar och mått från en Application Insights-resurs till ett lagringskonto.

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$resourceName = "<ResourceName>"
$storageAccountName = "<StorageAccountName>"
$diagnosticSettingName = "<DiagnosticSettingName>"

# Get the subscription ID from the current Azure PowerShell context
$subscriptionId = (Get-AzContext).Subscription.Id

# Build the full resource ID for the Application Insights component
$resourceId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Insights/components/$resourceName"

# Build the full resource ID for the storage account
$storageAccountId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.Storage/storageAccounts/$storageAccountName"

# Create log and metric settings objects
$log = New-AzDiagnosticSettingLogSettingsObject `
  -Category 'AppRequests' `
  -Enabled $true

$metric = New-AzDiagnosticSettingMetricSettingsObject `
  -Category 'AllMetrics' `
  -Enabled $true

# Define parameters for New-AzDiagnosticSetting
$newAzDiagnosticSettingParams = @{
    Name             = $diagnosticSettingName
    ResourceId       = $resourceId
    StorageAccountId = $storageAccountId
    Log              = @($log)
    Metric           = @($metric)
}

# Create the diagnostic setting
New-AzDiagnosticSetting @newAzDiagnosticSettingParams

I följande REST-exempel används REST API-åtgärden Diagnostikinställningar . Den skapar en diagnostikinställning som skickar loggar och mått från en Application Insights-resurs till ett lagringskonto.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/providers/Microsoft.Insights/diagnosticSettings/{diagnosticSettingName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "properties": {
    "storageAccountId": "/subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/Microsoft.Storage/storageAccounts/<StorageAccountName>",
    "logs": [
      {
        "category": "AppRequests",
        "enabled": true
      }
    ],
    "metrics": [
      {
        "category": "AllMetrics",
        "enabled": true
      }
    ]
  }
}

I följande Bicep-exempel används resurstypen Microsoft.Insights diagnosticSettings. Den skapar en diagnostikinställning som skickar loggar och mått från en Application Insights-resurs till ett lagringskonto.

param subscriptionId string = '<SubscriptionId>'
param resourceGroupName string = '<ResourceGroupName>'
param resourceName string = '<ResourceName>'
param storageAccountName string = '<StorageAccountName>'
param diagnosticSettingName string = '<DiagnosticSettingName>'

resource applicationInsightsComponent 'Microsoft.Insights/components@<ApiVersion>' existing = {
  name: resourceName
}

var storageAccountId = '/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.Storage/storageAccounts/${storageAccountName}'

resource diagnosticSetting 'Microsoft.Insights/diagnosticSettings@<ApiVersion>' = {
  name: diagnosticSettingName
  scope: applicationInsightsComponent
  properties: {
    storageAccountId: storageAccountId
    logs: [
      {
        category: 'AppRequests'
        enabled: true
      }
    ]
    metrics: [
      {
        category: 'AllMetrics'
        enabled: true
      }
    ]
  }
}

I följande ARM-mallexempel används Microsoft. Insights diagnosticSettings resurstyp. Den skapar en diagnostikinställning som skickar loggar och mått från en Application Insights-resurs till ett lagringskonto.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "subscriptionId": {
      "type": "string",
      "defaultValue": "<SubscriptionId>"
    },
    "resourceGroupName": {
      "type": "string",
      "defaultValue": "<ResourceGroupName>"
    },
    "resourceName": {
      "type": "string",
      "defaultValue": "<ResourceName>"
    },
    "storageAccountName": {
      "type": "string",
      "defaultValue": "<StorageAccountName>"
    },
    "diagnosticSettingName": {
      "type": "string",
      "defaultValue": "<DiagnosticSettingName>"
    }
  },
  "variables": {
    "storageAccountId": "[format('/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.Storage/storageAccounts/{2}', parameters('subscriptionId'), parameters('resourceGroupName'), parameters('storageAccountName'))]"
  },
  "resources": [
    {
      "type": "Microsoft.Insights/components/providers/diagnosticSettings",
      "apiVersion": "<ApiVersion>",
      "name": "[format('{0}/Microsoft.Insights/{1}', parameters('resourceName'), parameters('diagnosticSettingName'))]",
      "properties": {
        "storageAccountId": "[variables('storageAccountId')]",
        "logs": [
          {
            "category": "AppRequests",
            "enabled": true
          }
        ],
        "metrics": [
          {
            "category": "AllMetrics",
            "enabled": true
          }
        ]
      }
    }
  ]
}

Ange datakvarhållning

Datakvarhållning för Application Insights-resurser kan ställas in i den associerade Log Analytics-arbetsytan.

Mer information finns i Konfigurera standardperioden för interaktiv kvarhållning för Analytics-tabeller.

I följande Bicep-exempel används resurstypen Microsoft.OperationalInsights workspaces. Den anger datakvarhållningsperioden för den associerade Log Analytics arbetsytan.

param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'
param retentionInDays int = <RetentionInDays>

resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@<ApiVersion>' = {
  name: workspaceName
  location: azureRegion
  properties: {
    retentionInDays: retentionInDays
  }
}

I följande ARM-exempel (JSON) används resurstypen Microsoft.OperationalInsights workspaces. Den anger datakvarhållningsperioden för den associerade Log Analytics arbetsytan.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "defaultValue": "<WorkspaceName>"
    },
    "azureRegion": {
      "type": "string",
      "defaultValue": "<AzureRegion>"
    },
    "retentionInDays": {
      "type": "int",
      "defaultValue": <RetentionInDays>
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "<ApiVersion>",
      "name": "[parameters('workspaceName')]",
      "location": "[parameters('azureRegion')]",
      "properties": {
        "retentionInDays": "[parameters('retentionInDays')]"
      }
    }
  ]
}

Ange det dagliga taket

Det dagliga taket måste anges oberoende av varandra för både Application Insights och den underliggande Log Analytics-arbetsytan. Det effektiva dagliga taket är minst av de två inställningarna.

Information om hur du anger det dagliga taket i Azure-portalen finns i Ange dagligt tak på Log Analytics-arbetsytan.

Anteckning

För närvarande tillhandahåller Azure inte ett sätt att sätta en daglig gräns för Application Insights via Azure CLI.

Log Analytics:

I följande Azure CLI-exempel används kommandot az monitor log-analytics workspace update.

# Set variables
resourceGroupName="<ResourceGroupName>"
workspaceName="<WorkspaceName>"
dailyCapInGb="<DailyCapInGb>"

# Update the daily cap for the Log Analytics workspace
az monitor log-analytics workspace update \
  --resource-group "$resourceGroupName" \
  --workspace-name "$workspaceName" \
  --set workspaceCapping.dailyQuotaGb=$dailyCapInGb

Följande Azure PowerShell exempel använder cmdletarna Set-AzApplicationInsightsDailyCap och Set-AzOperationalInsightsWorkspace.

Application Insights:

Följande Azure PowerShell exempel använder cmdleten Set-AzApplicationInsightsDailyCap.

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$resourceName = "<ResourceName>"
$dailyCapInGb = "<DailyCapInGb>"

# Define the parameters for the daily cap
$setAzApplicationInsightsDailyCapParams = @{
    ResourceGroupName = $resourceGroupName
    Name              = $resourceName
    DailyCapGB        = $dailyCapInGb
}

# Set the daily cap for the Application Insights resource
Set-AzApplicationInsightsDailyCap @setAzApplicationInsightsDailyCapParams

Log Analytics:

Följande Azure PowerShell exempel använder cmdleten Set-AzOperationalInsightsWorkspace.

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$workspaceName = "<WorkspaceName>"
$dailyCapInGb = "<DailyCapInGb>"

# Define the parameters for the daily cap
$setAzOperationalInsightsWorkspaceParams = @{
    ResourceGroupName = $resourceGroupName
    Name              = $workspaceName
    DailyQuotaGb      = $dailyCapInGb
}

# Set the daily cap for the Log Analytics workspace
Set-AzOperationalInsightsWorkspace @setAzOperationalInsightsWorkspaceParams

Anteckning

För närvarande ger Azure inte något sätt att ange det dagliga taket för Application Insights via REST-API:et.

Log Analytics:

Följande REST-exempel använder REST API-åtgärden Workspaces.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "properties": {
    "workspaceCapping": {
      "dailyQuotaGb": <DailyCapInGb>
    }
  }
}

Anteckning

För närvarande erbjuder Azure inget sätt att ange det dagliga taket för Application Insights med en Bicep-mall.

Log Analytics:

I följande Bicep-exempel används resurstypen Microsoft.OperationalInsights workspaces.

param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'
param dailyCapInGb int

resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@<ApiVersion>' = {
  name: workspaceName
  location: azureRegion
  properties: {
    workspaceCapping: {
      dailyQuotaGb: dailyCapInGb
    }
  }
}

Anteckning

För tillfället erbjuder Azure inget sätt att ställa in det dagliga taket för Application Insights med hjälp av en ARM-mall.

Log Analytics:

I följande ARM-exempel (JSON) används resurstypen Microsoft.OperationalInsights workspaces.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "defaultValue": "<WorkspaceName>"
    },
    "azureRegion": {
      "type": "string",
      "defaultValue": "<AzureRegion>"
    },
    "dailyCapInGb": {
      "type": "int"
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "<ApiVersion>",
      "name": "[parameters('workspaceName')]",
      "location": "[parameters('azureRegion')]",
      "properties": {
        "workspaceCapping": {
          "dailyQuotaGb": "[parameters('dailyCapInGb')]"
        }
      }
    }
  ]
}

Ange prisplanen

Prisplanen för Application Insights-resurser kan anges på den associerade Log Analytics-arbetsytan. Mer information om tillgängliga prisplaner finns i Kostnadsberäkningar och alternativ för Azure Monitor-loggar.

Anteckning

Om du ser oväntade avgifter eller höga kostnader i Application Insights kan den här guiden hjälpa dig. Den omfattar vanliga orsaker som hög telemetrivolym, datainmatningstoppar och felkonfigurerad sampling. Det är särskilt användbart om du felsöker problem som rör kostnadstoppar, telemetrivolym, sampling som inte fungerar, datatak, hög inmatning eller oväntad fakturering. Information om hur du kommer igång finns i Felsöka hög datainmatning i Application Insights.

Information om hur du anger prisplanen i Azure-portalen finns i Application Insights-fakturering.

Följande Azure CLI exempel använder kommandot az monitor log-analytics workspace update.

Betala efter användning:

# Set variables
resourceGroupName="<ResourceGroupName>"
workspaceName="<WorkspaceName>"

# Set the pricing plan to pay-as-you-go
az monitor log-analytics workspace update \
  --resource-group "$resourceGroupName" \
  --workspace-name "$workspaceName" \
  --set PerGB2018

Åtagandenivå:

# Set variables
resourceGroupName="<ResourceGroupName>"
workspaceName="<WorkspaceName>"
capacityReservationInGb="<CapacityReservationInGb>"

# Set the pricing plan to commitment tier
az monitor log-analytics workspace update \
  --resource-group "$resourceGroupName" \
  --workspace-name "$workspaceName" \
  --set CapacityReservation \
  --level "$capacityReservationInGb"

Följande Azure PowerShell exempel använder cmdleten Set-AzOperationalInsightsWorkspace.

Betala efter användning:

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$workspaceName = "<WorkspaceName>"

# Define the parameters for the pricing plan
$setAzOperationalInsightsWorkspaceParams = @{
    ResourceGroupName = $resourceGroupName
    Name              = $workspaceName
    Sku               = "PerGB2018"
}

# Set the pricing plan to pay-as-you-go
Set-AzOperationalInsightsWorkspace @setAzOperationalInsightsWorkspaceParams

Åtagandenivå:

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$workspaceName = "<WorkspaceName>"
$capacityReservationInGb = "<CapacityReservationInGb>"

# Define the parameters for the pricing plan
$setAzOperationalInsightsWorkspaceParams = @{
    ResourceGroupName = $resourceGroupName
    Name              = $workspaceName
    Sku               = "CapacityReservation"
    SkuCapacity       = $capacityReservationInGb
}

# Set the pricing plan to commitment tier
Set-AzOperationalInsightsWorkspace @setAzOperationalInsightsWorkspaceParams

I följande REST-exempel används REST API-åtgärden För arbetsytor . Prisplanen lagras i själva arbetsytans sku-egenskap.

Betala efter användning:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "properties": {
    "sku": {
      "name": "pergb2018"
    }
  }
}

Åtagandenivå:

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "properties": {
    "sku": {
      "name": "capacityreservation",
      "capacityReservationLevel": <CapacityReservationInGb>
    }
  }
}

Följande Bicep-exempel använder resurstypen Microsoft.OperationalInsights workspaces.

Betala efter användning:

param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'

resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@<ApiVersion>' = {
  name: workspaceName
  location: azureRegion
  properties: {
    sku: {
      name: 'pergb2018'
    }
  }
}

Åtagandenivå:

param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'
param capacityReservationInGb int

resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@<ApiVersion>' = {
  name: workspaceName
  location: azureRegion
  properties: {
    sku: {
      name: 'capacityreservation'
      capacityReservationLevel: capacityReservationInGb
    }
  }
}

Följande ARM-exempel (JSON) använder resurstypen Microsoft.OperationalInsights workspaces.

Betala efter användning:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "defaultValue": "<WorkspaceName>"
    },
    "azureRegion": {
      "type": "string",
      "defaultValue": "<AzureRegion>"
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "<ApiVersion>",
      "name": "[parameters('workspaceName')]",
      "location": "[parameters('azureRegion')]",
      "properties": {
        "sku": {
          "name": "pergb2018"
        }
      }
    }
  ]
}

Åtagandenivå:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "workspaceName": {
      "type": "string",
      "defaultValue": "<WorkspaceName>"
    },
    "azureRegion": {
      "type": "string",
      "defaultValue": "<AzureRegion>"
    },
    "capacityReservationInGb": {
      "type": "int"
    }
  },
  "resources": [
    {
      "type": "Microsoft.OperationalInsights/workspaces",
      "apiVersion": "<ApiVersion>",
      "name": "[parameters('workspaceName')]",
      "location": "[parameters('azureRegion')]",
      "properties": {
        "sku": {
          "name": "capacityreservation",
          "capacityReservationLevel": "[parameters('capacityReservationInGb')]"
        }
      }
    }
  ]
}

Inaktivera IP-maskering

Application Insights lagrar som standard inte IP-adresser. Information om hur du inaktiverar IP-maskering finns i Geoplats- och IP-adresshantering.

Skapa ytterligare resurser

Skapa ett tillgänglighetstest

Information om hur du skapar ett tillgänglighetstest i Azure-portalen finns i Tillgänglighetstester för Application Insights.

I följande Azure CLI exempel används kommandot az monitor app-insights web-test create. Det skapar ett standardtillgänglighetstest med standardinställningar.

# Set variables
resourceGroupName="<ResourceGroupName>"
resourceName="<ResourceName>"
azureRegion="<AzureRegion>"
webTestName="<WebTestName>"
requestUrl="<RequestUrl>"

# Get the subscription ID from the current Azure CLI context
subscriptionId=$(az account show --query id --output tsv)

# Create a standard availability test
az monitor app-insights web-test create \
  --resource-group "$resourceGroupName" \
  --location "$azureRegion" \
  --web-test-kind standard \
  --name "$webTestName" \
  --defined-web-test-name "$webTestName" \
  --request-url "$requestUrl" \
  --retry-enabled true \
  --ssl-check true \
  --ssl-lifetime-check 7 \
  --frequency 300 \
  --locations Id="us-ca-sjc-azr" \
  --locations Id="apac-sg-sin-azr" \
  --locations Id="us-il-ch1-azr" \
  --locations Id="us-va-ash-azr" \
  --locations Id="emea-au-syd-edge" \
  --http-verb GET \
  --timeout 120 \
  --expected-status-code 200 \
  --enabled true \
  --tags "hidden-link:/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/microsoft.insights/components/$resourceName=Resource"

Anteckning

Webbtestregionen (--location) skiljer sig från den geografiska platsen (--locationsobservera pluralformen) där flera kan väljas. --location refererar till den Azure-region där webbtestet skapas och hanteras, medan --locations refererar till den geografiska plats eller de platser som webbtestet körs från. En fullständig lista över alla geografiska platser finns i Tillgänglighetstester för Application Insights.

I följande Azure PowerShell exempel används cmdleten New-AzApplicationInsightsWebTest. Det skapar ett standardtillgänglighetstest med standardinställningar.

# Set variables
$resourceGroupName = "<ResourceGroupName>"
$resourceName = "<ResourceName>"
$azureRegion = "<AzureRegion>"
$webTestName = "<WebTestName>"
$requestUrl = "<RequestUrl>"

# Get the subscription ID from the current Azure PowerShell context
$subscriptionId = (Get-AzContext).Subscription.Id

# Define the geographic locations from which the web test is executed
$geoLocation = @()
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "us-ca-sjc-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "apac-sg-sin-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "us-il-ch1-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "us-va-ash-azr"
$geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "emea-au-syd-edge"

# Define parameters for New-AzApplicationInsightsWebTest
$newAzApplicationInsightsWebTestParams = @{
    ResourceGroupName              = $resourceGroupName
    Location                       = $azureRegion
    Name                           = $webTestName
    TestName                       = $webTestName
    Kind                           = "standard"
    RequestUrl                     = $requestUrl
    RetryEnabled                   = $true
    RuleSslCheck                   = $true
    RuleSslCertRemainingLifetimeCheck = 7
    Frequency                      = 300
    GeoLocation                    = $geoLocation
    RequestHttpVerb                = "GET"
    Timeout                        = 120
    RuleExpectedHttpStatusCode     = 200
    Enabled                        = $true
    Tag                            = @{
        "hidden-link:/subscriptions/$subscriptionId/resourceGroups/$resourceGroupName/providers/microsoft.insights/components/$resourceName" = "Resource"
    }
}

# Create a standard availability test
New-AzApplicationInsightsWebTest @newAzApplicationInsightsWebTestParams

Anteckning

Webbtestregionen (-Location) skiljer sig från den geografiska plats (-GeoLocation) där flera kan väljas. -Location refererar till den Azure-region där webbtestet skapas och hanteras, medan -GeoLocation refererar till den geografiska plats eller de platser som webbtestet körs från. En fullständig lista över alla geografiska platser finns i Tillgänglighetstester för Application Insights.

I följande REST-exempel används REST API-åtgärden Web Tests. Det skapar ett standardtillgänglighetstest med standardinställningar.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/webtests/{webTestName}?api-version={apiVersion}
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "location": "<AzureRegion>",
  "tags": {
    "hidden-link:/subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroupName>/providers/microsoft.insights/components/<ResourceName>": "Resource"
  },
  "properties": {
    "Name": "<WebTestName>",
    "SyntheticMonitorId": "<WebTestName>",
    "Enabled": true,
    "Frequency": 300,
    "Timeout": 120,
    "Kind": "standard",
    "RetryEnabled": true,
    "Request": {
      "RequestUrl": "<RequestUrl>",
      "HttpVerb": "GET"
    },
    "ValidationRules": {
      "ExpectedHttpStatusCode": 200,
      "SSLCheck": true,
      "SSLCertRemainingLifetimeCheck": 7
    },
    "Locations": [
      { "Id": "us-ca-sjc-azr" },
      { "Id": "apac-sg-sin-azr" },
      { "Id": "us-il-ch1-azr" },
      { "Id": "us-va-ash-azr" },
      { "Id": "emea-au-syd-edge" }
    ]
  }
}

Anteckning

Webbtestregionen (location) skiljer sig från den geografiska platsen (Locationsobservera pluralformen) där flera kan väljas. location refererar till den Azure-region där webbtestet skapas och hanteras, medan Locations refererar till den geografiska plats eller de platser som webbtestet körs från. En fullständig lista över alla geografiska platser finns i Tillgänglighetstester för Application Insights.

I följande Bicep-exempel används resurstypen Microsoft.Insights webtests. Det skapar ett standardtillgänglighetstest med standardinställningar.

param subscriptionId string = '<SubscriptionId>'
param resourceGroupName string = '<ResourceGroupName>'
param resourceName string = '<ResourceName>'
param azureRegion string = '<AzureRegion>'
param webTestName string = '<WebTestName>'
param requestUrl string = '<RequestUrl>'

resource webTest 'Microsoft.Insights/webtests@<ApiVersion>' = {
  name: webTestName
  location: azureRegion
  tags: {
    'hidden-link:/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/microsoft.insights/components/${resourceName}': 'Resource'
  }
  properties: {
    SyntheticMonitorId: webTestName
    Name: webTestName
    Enabled: true
    Frequency: 300
    Timeout: 120
    Kind: 'standard'
    RetryEnabled: true
    Locations: [
      { Id: 'us-ca-sjc-azr' }
      { Id: 'apac-sg-sin-azr' }
      { Id: 'us-il-ch1-azr' }
      { Id: 'us-va-ash-azr' }
      { Id: 'emea-au-syd-edge' }
    ]
    Request: {
      RequestUrl: requestUrl
      HttpVerb: 'GET'
    }
    ValidationRules: {
      ExpectedHttpStatusCode: 200
      SSLCheck: true
      SSLCertRemainingLifetimeCheck: 7
    }
  }
}

Anteckning

Webbtestregionen (location) skiljer sig från den geografiska plats (Locations) där flera kan väljas. location refererar till den Azure-region där webbtestet skapas och hanteras, medan Locations refererar till den geografiska plats eller de platser som webbtestet körs från. En fullständig lista över alla geografiska platser finns i Tillgänglighetstester för Application Insights.

Mer information om hur du skapar tillgänglighetstester med Bicep finns i Microsoft.Insights-webbtest.

I följande ARM-exempel (JSON) används Microsoft. Insights webtests resurstyp. Det skapar ett standardtillgänglighetstest med standardinställningar.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "subscriptionId": {
      "type": "string",
      "defaultValue": "<SubscriptionId>"
    },
    "resourceGroupName": {
      "type": "string",
      "defaultValue": "<ResourceGroupName>"
    },
    "resourceName": {
      "type": "string",
      "defaultValue": "<ResourceName>"
    },
    "azureRegion": {
      "type": "string",
      "defaultValue": "<AzureRegion>"
    },
    "webTestName": {
      "type": "string",
      "defaultValue": "<WebTestName>"
    },
    "requestUrl": {
      "type": "string",
      "defaultValue": "<RequestUrl>"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/webtests",
      "apiVersion": "<ApiVersion>",
      "name": "[parameters('webTestName')]",
      "location": "[parameters('azureRegion')]",
      "tags": {
        "[format('hidden-link:/subscriptions/{0}/resourceGroups/{1}/providers/microsoft.insights/components/{2}', parameters('subscriptionId'), parameters('resourceGroupName'), parameters('resourceName'))]": "Resource"
      },
      "properties": {
        "SyntheticMonitorId": "[parameters('webTestName')]",
        "Name": "[parameters('webTestName')]",
        "Enabled": true,
        "Frequency": 300,
        "Timeout": 120,
        "Kind": "standard",
        "RetryEnabled": true,
        "Locations": [
          { "Id": "us-ca-sjc-azr" },
          { "Id": "apac-sg-sin-azr" },
          { "Id": "us-il-ch1-azr" },
          { "Id": "us-va-ash-azr" },
          { "Id": "emea-au-syd-edge" }
        ],
        "Request": {
          "RequestUrl": "[parameters('requestUrl')]",
          "HttpVerb": "GET"
        },
        "ValidationRules": {
          "ExpectedHttpStatusCode": 200,
          "SSLCheck": true,
          "SSLCertRemainingLifetimeCheck": 7
        }
      }
    }
  ]
}

Anteckning

Lägga till en måttavisering

Tips/Råd

Varje Application Insights-resurs levereras med mått som är tillgängliga direkt. Om separata komponenter rapporterar till samma Application Insights-resurs kanske det inte är meningsfullt att avisera om dessa mått.

Information om hur du skapar en måttavisering i Azure-portalen finns i Självstudie: Skapa en måttavisering för en Azure-resurs.

Information om hur du automatiserar skapandet av måttaviseringar finns i mallartikeln Måttaviseringar.

Skapa fler Application Insights-resurser

Hur många Application Insights-resurser ska jag distribuera?

När du utvecklar nästa version av ett webbprogram vill du inte blanda ihop Application Insights-telemetrin från den nya versionen och den redan släppta versionen.

För att undvika förvirring skickar du telemetrin från olika utvecklingssteg för att separera Application Insights-resurser med separata anslutningssträng.

Om systemet är en instans av Azure Cloud Services finns det en annan metod för att ställa in separata anslutningssträng.

När du ska använda en enda Application Insights-resurs

Använd en enda Application Insights-resurs för:

Effektivisera DevOps/ITOps-hantering för program som distribueras tillsammans, vanligtvis utvecklade och hanterade av samma team.
Centralisera viktiga prestandaindikatorer, till exempel svarstider och felfrekvenser, på en instrumentpanel som standard. Segmentera efter rollnamn i metrics Explorer om det behövs.
När det inte finns något behov av olika rollbaserad åtkomstkontroll i Azure mellan programkomponenter.
När identiska måttaviseringsvillkor, kontinuerlig export och hantering av fakturering/kvoter mellan komponenter räcker.
När det är acceptabelt för en API-nyckel att komma åt data från alla komponenter på samma sätt och 10 API-nycklar uppfyller behoven för alla komponenter.
När samma inställningar för smart identifiering och arbetsobjektintegrering är lämpliga för alla roller.

Anteckning

Om du vill konsolidera flera Application Insights-resurser kan du peka dina befintliga programkomponenter på en ny konsoliderad Application Insights-resurs. Telemetrin som lagras i den gamla resursen överförs inte till den nya resursen. Ta bara bort den gamla resursen när du har tillräckligt med telemetri i den nya resursen för affärskontinuitet.

Övriga beaktanden

Om du vill aktivera portalupplevelser lägger du till anpassad kod för att tilldela meningsfulla värden till attributet Cloud_RoleName . Utan dessa värden fungerar inte portalfunktionerna.

För Azure Service Fabric-program och klassiska molntjänster konfigurerar SDK automatiskt tjänster genom att läsa från Azure-rollmiljön. För andra apptyper behöver du vanligtvis ange den explicit.

Live-mått kan inte dela upp data efter rollnamn.

Spårning av version och lansering

När du publicerar en ny version av programmet vill du kunna separera telemetrin från olika versioner. Du kan ange egenskapen Programversion så att du kan filtrera sök - och måttutforskarens resultat.

Det finns flera olika metoder för att ange egenskapen Programversion .

Alternativ 1: Ange versionen direkt

För OpenTelemetry-baserad instrumentation anger du programmetadata konsekvent med hjälp av resursattribut.
Alternativ 2: Ange versionen i BuildInfo.config (endast ASP.NET)

Application Insights-webbmodulen hämtar versionen från BuildLabel noden. Inkludera den här filen i projektet och kom ihåg att ange egenskapen Kopiera alltid i Prieskumník riešení.
```
<?xml version="1.0" encoding="utf-8"?>
<DeploymentEvent xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/VisualStudio/DeploymentEvent/2013/06">
  <ProjectName>AppVersionExpt</ProjectName>
  <Build type="MSBuild">
    <MSBuild>
      <BuildLabel kind="label">1.0.0.2</BuildLabel>
    </MSBuild>
  </Build>
</DeploymentEvent>
```
Generera BuildInfo.config automatiskt i Microsoft Build Engine. Lägg till följande rader i .csproj filen:
```
<PropertyGroup>
  <GenerateBuildInfoConfigFile>true</GenerateBuildInfoConfigFile>
  <IncludeServerNameInBuildInfo>true</IncludeServerNameInBuildInfo>
</PropertyGroup>
```
Det här steget genererar en fil med namnet yourProjectName.BuildInfo.config. Publiceringsprocessen byter namn på den till BuildInfo.config.

Byggetiketten innehåller en platshållare (*AutoGen_...*) när du skapar med Visual Studio. När platshållaren skapas med Microsoft Build Engine fylls den med rätt versionsnummer.

Om du vill tillåta att Microsoft Build Engine genererar versionsnummer anger du versionen som 1.0.* i AssemblyReference.cs.

Versionsanteckningar

Om du använder Azure DevOps kan du få en anteckningsmarkör tillagd i dina diagram när du släpper en ny version.

Automatisera processen för att skapa resurser

Processen för att skapa resurser kan automatiseras med hjälp av Bicep- eller JSON-mallar med Azure Resource Manager. Du kan paketera flera resurser tillsammans för att skapa dem i en distribution. Du kan till exempel skapa en Application Insights-resurs med tillgänglighetstester, måttaviseringar och en diagnostikinställning för att skicka telemetri till ett Azure Storage-konto.

Generera en mall i Azure-portalen

Du kan generera en mall från befintliga resurser.

Endast Application Insights

Gå till Application Insights-resursen i Azure-portalen.
Öppna Exportmallen som visas under Automation i det vänstra navigeringsfältet.
(Valfritt): Om du vill använda dina egna parametrar avmarkerar du Inkludera parametrar.
Ladda ned mallfilen eller distribuera den direkt i Azure-portalen.

Flera resurser

Gå till resursgruppen för application insights-resursen.
Markera alla resurser som du vill inkludera i mallen i fönstret Översikt och välj sedan Exportera mall i det övre navigeringsfältet.
(Valfritt): Om du vill använda dina egna parametrar avmarkerar du Inkludera parametrar.
Ladda ned mallfilen eller distribuera den direkt i Azure-portalen.

Skapa en mall från grunden

Om du vill lära dig hur du skapar en ARM-mall från grunden går du till vår ARM-malldokumentation som innehåller självstudier för att skapa en mall, lägga till resurser, lägga till parametrar med mera.

Tillgängliga egenskaper för Application Insights, tillgänglighetstester, måttaviseringar, diagnostikinställningar och andra resurser finns i vår Azure-resursreferensdokumentation under nodenReferensövervakareInsikter>>.

Tips/Råd

Du kan också använda snabbstartsmallar som är tillgängliga längst ned på varje dokumentationssida för Azure-resursreferenser som är länkad i det här avsnittet. Mer information om hur du använder mallar finns i Självstudie: Använda Azure-snabbstartsmallar.

Nästa steg

Läs vanliga frågor och svar: Skapa och konfigurera Application Insights-resurser – Vanliga frågor och svar
Utforska mått
Skriva Log Analytics-frågor
Delade resurser för flera roller
Skicka Azure Diagnostics till Application Insights.
Skapa utgåveanteckningar.

Feedback

Var den här sidan till hjälp?

Uppdaterades senast 2026-08-27

Skapa och konfigurera Application Insights-resurser

Förutsättningar

Ytterligare krav

Skapa en Application Insights-resurs

Konfigurera övervakning

Hämta anslutningssträngen

Programövervakning med OpenTelemetry

Automatisk instrumentering

Konfigurera Application Insights-resurser

Ändra den associerade arbetsytan

Exportera telemetri

Ange datakvarhållning

Ange det dagliga taket

Ange prisplanen

Inaktivera IP-maskering

Skapa ytterligare resurser

Skapa ett tillgänglighetstest

Lägga till en måttavisering

Skapa fler Application Insights-resurser

Hur många Application Insights-resurser ska jag distribuera?

När du ska använda en enda Application Insights-resurs

Övriga beaktanden

Spårning av version och lansering

Versionsanteckningar

Automatisera processen för att skapa resurser

Generera en mall i Azure-portalen

Endast Application Insights

Flera resurser

Skapa en mall från grunden

Nästa steg

Feedback

Ytterligare resurser