Application Insights kan worden geïntegreerd met Log Analytics en verzendt telemetrie naar een algemene Log Analytics-werkruimte. Deze instelling biedt volledige toegang tot Log Analytics-functies, consolideert logboeken op één locatie en maakt geïntegreerd op rollen gebaseerd toegangsbeheer van Azure mogelijk, waardoor er geen query's voor meerdere apps/werkruimten meer nodig zijn.
Verbeterde mogelijkheden zijn onder andere:
In dit artikel leest u hoe u Application Insights-resources maakt en configureert. Samen met de Application Insights-resource zelf kunt u verschillende configuraties toevoegen, zoals het instellen van de dagelijkse limiet en het prijsplan. U kunt ook beschikbaarheidstests maken, metrische waarschuwingen instellen en het proces automatiseren met behulp van Azure Resource Manager.
Notitie
Gegevensinvoer en -retentie voor werkruimtegebaseerde Application Insights-resources worden gefactureerd via de Log Analytics-werkruimte waar de gegevens zich bevinden. Zie prijzen voor Azure Monitor-logboeken voor meer informatie over facturering.
Vereiste voorwaarden
- Een actief Azure-abonnement.
- De benodigde machtigingen voor het maken van resources.
Aanvullende vereisten
Geen aanvullende vereisten.
Als u toegang wilt krijgen tot Azure CLI-opdrachten van Application Insights, moet u eerst het volgende uitvoeren:
az extension add -n application-insights
Als u de az extension add opdracht niet uitvoert, ziet u een foutbericht met de az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'status .
U kunt Bicep-sjablonen implementeren via de Azure CLI, Azure PowerShell en in Azure Portal. Controleer de respectieve tabbladen op aanvullende vereisten.
U kunt ARM-sjablonen implementeren via de Azure CLI, Azure PowerShell en azure Portal. Controleer de respectieve tabbladen op aanvullende vereisten.
Een Application Insights-resource maken
- Meld u aan bij het Azure-portaal.
- Selecteer Een hulpmiddel maken.
- Open de categorie Bewaking en diagnostische gegevens en selecteer vervolgens Application Insights.
- Voer alle relevante informatie in en controleer en maak uw Application Insights-resource.
Notitie
Als u tijdens het maken van resources geen verbinding maakt met een bestaande Log Analytics-werkruimte, wordt er automatisch een nieuwe Log Analytics-resource gemaakt samen met uw Application Insights-resource.
Nadat u de resource hebt gemaakt, kunt u de bijbehorende werkruimtegegevens vinden in het deelvenster Overzicht van Application Insights.
Selecteer de blauwe koppelingstekst om naar de bijbehorende Log Analytics-werkruimte te gaan, waar u kunt profiteren van de nieuwe queryomgeving voor een geïntegreerde werkruimte.
Notitie
We bieden nog steeds volledige compatibiliteit met eerdere versies voor uw klassieke Application Insights-resourcequery's, werkmappen en waarschuwingen op basis van logboeken. Als u een query wilt uitvoeren op de nieuwe tabelstructuur of het nieuwe schema op basis van een werkruimte, moet u eerst naar uw Log Analytics-werkruimte gaan. Selecteer Logboeken (Analytics) in de Application Insights-deelvensters voor toegang tot de klassieke Application Insights-query-ervaring.
Als u een Application Insights-resource op basis van een werkruimte wilt maken, is een Log Analytics-werkruimte vereist. Als u er nog geen hebt, kunt u de volgende Azure CLI-opdracht gebruiken om er een te maken.
Tijdelijke aanduidingen: <resource-group-name>, <log-analytics-workspace-name><azure-region-name>
az monitor log-analytics workspace create --resource-group <resource-group-name> --workspace-name <log-analytics-workspace-name> --location <azure-region-name>
Als u een Application Insights-resource wilt maken, voert u de volgende Azure CLI-opdracht uit in uw terminal.
Tijdelijke aanduidingen: <application-insights-resource-name>, <azure-region-name>, <resource-group-name>, <log-analytics-workspace-name>
az monitor app-insights component create --app <application-insights-resource-name> --location <azure-region-name> --resource-group <resource-group-name> --workspace <log-analytics-workspace-name>
Voor meer informatie, zie de Azure CLI-documentatie voor Application Insights en Log Analytics over hoe u Application Insights-resources en Log Analytics-werkruimten kunt maken met de Azure CLI.
Als u een Application Insights-resource op basis van een werkruimte wilt maken, is een Log Analytics-werkruimte vereist. Als u er nog geen hebt, kunt u de volgende Azure PowerShell-opdracht gebruiken om er een te maken.
Tijdelijke aanduidingen: <resource-group-name>, <log-analytics-workspace-name><azure-region-name>
New-AzOperationalInsightsWorkspace -ResourceGroupName <resource-group-name> -Name <log-analytics-workspace-name> -Location <azure-region-name>
Als u een Application Insights-resource wilt maken, voert u de volgende Azure PowerShell-opdracht uit in uw terminal.
Tijdelijke aanduidingen: <resource-group-name>, <application-insights-resource-name>, <azure-region-name>,<subscription-id>, <log-analytics-workspace-name>
New-AzApplicationInsights -ResourceGroupName <resource-group-name> -Name <application-insights-resource-name> -Location <azure-region-name> -WorkspaceResourceId /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>
Zie de Azure PowerShell-documentatie voor Application Insights en Log Analytics voor meer informatie over het maken van Application Insights-resources en Log Analytics-werkruimten met behulp van Azure PowerShell.
Als u een Application Insights-resource op basis van een werkruimte wilt maken, is een Log Analytics-werkruimte vereist. Als u er nog geen hebt, kunt u de volgende REST API-aanroep gebruiken om er een te maken.
Tijdelijke aanduidingen: <subscription-id>, <resource-group-name>, <log-analytics-workspace-name>, <access-token>, <azure-region-name>
PUT https://management.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>?api-version=2023-09-01
Authorization: Bearer <access-token>
Content-Type: application/json
{
"location": "<azure-region-name>"
}
Gebruik de volgende aanvraag om een Application Insights-resource te maken met behulp van de REST API.
Tijdelijke aanduidingen: <subscription-id>, <resource-group-name>, <application-insights-resource-name>, <access-token>, <application-type>, <azure-region-name><log-analytics-workspace-name>
PUT https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Insights/components/<application-insights-resource-name>?api-version=2020-02-02
Authorization: Bearer <access-token>
Content-Type: application/json
{
"kind": "<application-type>",
"location": "<azure-region-name>",
"properties": {
"Application_Type": "<application-type>",
"WorkspaceResourceId": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>"
}
}
Zie de REST API-documentatie voor Application Insights en Log Analytics voor meer informatie over het maken van Application Insights-resources en Log Analytics-werkruimten met behulp van de REST API.
U maakt als volgt een nieuwe Application Insights-resource met behulp van een Bicep-sjabloon.
Een sjabloon maken
Maak een nieuw BICEP-bestand (bijvoorbeeld my-template.bicep), kopieer de volgende inhoud naar het bestand:
param name string
param type string
param regionId string
param requestSource string
param workspaceResourceId string
resource appInsights 'Microsoft.Insights/components@2020-02-02' = {
name: name
location: regionId
tags: tagsArray
kind: 'other'
properties: {
Application_Type: type
Request_Source: requestSource
WorkspaceResourceId: workspaceResourceId
}
}
Een parameterbestand maken
Maak een nieuw BICEPPARAM-bestand (bijvoorbeeld my-parameters.bicepparam), kopieer de volgende inhoud naar het bestand en vervang de tijdelijke aanduidingen <application-insights-resource-name>, , <application-type><azure-region-name>, , <subscription-id>en <resource-group-name><log-analytics-workspace-name> vervang deze door uw specifieke waarden:
using 'my-template.bicep'
param name string = '<application-insights-resource-name>'
param type string = '<application-type>'
param regionId string = '<azure-region-name>'
param requestSource string = 'CustomDeployment'
param workspaceResourceId string = '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<log-analytics-workspace-name>'
De sjabloon gebruiken om een nieuwe Application Insights-resource te maken
Meld u in PowerShell aan bij Azure met behulp van $Connect-AzAccount.
Stel uw context in op een abonnement met Set-AzContext "<subscription ID>".
Voer een nieuwe implementatie uit om een nieuwe Application Insights-resource te maken:
New-AzResourceGroupDeployment -ResourceGroupName <your-resource-group> -TemplateFile my-template.bicep -TemplateParameterFile my-parameters.bicepparam
-
-ResourceGroupName is de groep waarin u de nieuwe resources wilt maken.
-
-TemplateFile moet komen vóór de aangepaste parameters.
-
-TemplateParameterFile is de naam van het parameterbestand.
U kunt andere parameters toevoegen. U vindt de bijbehorende beschrijvingen in de sectie parameters van de sjabloon.
U maakt als volgt een nieuwe Application Insights-resource met behulp van een ARM-sjabloon.
Een sjabloon maken
Maak een nieuw .json-bestand (bijvoorbeeld my-template.json) en kopieer de volgende inhoud naar het bestand:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string",
"metadata": {
"description": "Name of Application Insights resource."
}
},
"type": {
"type": "string",
"metadata": {
"description": "Type of app you are deploying. This field is for legacy reasons and will not impact the type of Application Insights resource you deploy."
}
},
"regionId": {
"type": "string",
"metadata": {
"description": "Which Azure region to deploy the resource to. This must be a valid Azure regionId."
}
},
"tagsArray": {
"type": "object",
"metadata": {
"description": "See documentation on tags: https://free.blessedness.top/azure/azure-resource-manager/management/tag-resources."
}
},
"requestSource": {
"type": "string",
"metadata": {
"description": "Source of Azure Resource Manager deployment"
}
},
"workspaceResourceId": {
"type": "string",
"metadata": {
"description": "Log Analytics workspace ID to associate with your Application Insights resource."
}
}
},
"resources": [
{
"type": "Microsoft.Insights/components",
"apiVersion": "2020-02-02",
"name": "[parameters('name')]",
"location": "[parameters('regionId')]",
"tags": "[parameters('tagsArray')]",
"kind": "other",
"properties": {
"Application_Type": "[parameters('type')]",
"Request_Source": "[parameters('requestSource')]",
"WorkspaceResourceId": "[parameters('workspaceResourceId')]"
}
}
]
}
Notitie
Zie Eigenschapswaarden voor meer informatie over resource-eigenschappen.
Flow_Type en Request_Source worden niet gebruikt, maar zijn opgenomen in dit voorbeeld voor volledigheid.
Een parameterbestand maken
Maak een nieuw .json-bestand (bijvoorbeeld my-parameters.json), kopieer de volgende inhoud naar het bestand en vervang de tijdelijke aanduidingen <application-insights-resource-name>, <application-type>, <azure-region-name>, <subscription-id>, en <resource-group-name><log-analytics-workspace-name> door uw specifieke waarden:
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"value": "<application-insights-resource-name>"
},
"type": {
"value": "<application-type>"
},
"regionId": {
"value": "<azure-region-name>"
},
"tagsArray": {
"value": {}
},
"requestSource": {
"value": "CustomDeployment"
},
"workspaceResourceId": {
"value": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<log-analytics-workspace-name>"
}
}
}
De sjabloon gebruiken om een nieuwe Application Insights-resource te maken
Meld u in PowerShell aan bij Azure met behulp van $Connect-AzAccount.
Stel uw context in op een abonnement met Set-AzContext "<subscription ID>".
Voer een nieuwe implementatie uit om een nieuwe Application Insights-resource te maken:
New-AzResourceGroupDeployment -ResourceGroupName <your-resource-group> -TemplateFile my-template.json -TemplateParameterFile my-parameters.json
-
-ResourceGroupName is de groep waarin u de nieuwe resources wilt maken.
-
-TemplateFile moet komen vóór de aangepaste parameters.
-
-TemplateParameterFile is de naam van het parameterbestand.
Nadat u een Application Insights-resource hebt gemaakt, configureert u bewaking.
De verbindingsreeks ophalen
De verbindingsreeks identificeert de resource waarmee u uw telemetriegegevens wilt koppelen. U kunt deze ook gebruiken om de eindpunten te wijzigen die uw resource gebruikt als bestemming voor uw telemetrie. U moet de verbindingsreeks kopiëren en toevoegen aan de code van uw toepassing of aan een omgevingsvariabele.
De verbindingsreeks van uw Application Insights-resource ophalen:
- Open uw Application Insights-resource in de Azure-portal.
- Zoek in het deelvenster Overzicht in de sectie Essentials naar Verbindingsreeks.
- Als u de muisaanwijzer boven de verbindingsreeks plaatst, wordt er een pictogram weergegeven waarmee u deze naar het klembord kunt kopiëren.
Als u de verbindingsreeks wilt ophalen, voert u de volgende Azure CLI-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen <application-insights-resource-name> en <resource-group-name> door uw specifieke waarden:
az monitor app-insights component show --app <application-insights-resource-name> --resource-group <resource-group-name> --query connectionString --output tsv
Zie de az monitor app-insights component show voor meer informatie over de opdracht.
Als u de verbindingsreeks wilt ophalen, voert u de volgende Azure PowerShell-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen <resource-group-name> en <application-insights-resource-name> door uw specifieke waarden:
Get-AzApplicationInsights -ResourceGroupName <resource-group-name> -Name <application-insights-resource-name> | Select-Object -ExpandProperty ConnectionString
Zie de Get-AzApplicationInsights voor meer informatie over de opdracht.
Als u de details van uw Application Insights-resource wilt ophalen, gebruikt u de volgende aanvraag en vervangt u de tijdelijke aanduidingen <subscription-id>, <resource-group-name>en <application-insights-resource-name><access-token> door uw specifieke waarden:
GET https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Insights/components/<application-insights-resource-name>?api-version=2015-05-01
Authorization: Bearer <access-token>
Zoek het properties.connectionString veld in het JSON-antwoord.
Zie de REST API-documentatie voor meer informatie over het ophalen van informatie over Application Insights-resources met behulp van de REST API.
Niet van toepassing op Bicep-sjablonen.
Niet van toepassing op ARM-sjablonen.
Toepassingsbewaking met OpenTelemetry
Voor toepassingsbewaking met OpenTelemetry installeert u de juiste Azure Monitor OpenTelemetry Distro en wijst u de verbindingsreeks aan uw zojuist gemaakte resource.
Zie de volgende documentatie die specifiek is voor de taal voor informatie over het instellen van toepassingsbewaking met OpenTelemetry:
Automatische instrumentatie
Voor bewakingsservices zoals Azure Functions en Azure App Service kunt u eerst uw Application Insights-resource maken en deze vervolgens aanwijzen wanneer u bewaking inschakelt. U kunt ook een nieuwe Application Insights-resource maken tijdens het activeringsproces.
De gekoppelde werkruimte wijzigen
Nadat u een Application Insights-resource hebt gemaakt, kunt u de bijbehorende Log Analytics-werkruimte wijzigen.
Selecteer in uw Application Insights-resource Eigenschappen>Werkruimte wijzigen>Log Analytics-werkruimten.
Als u de Log Analytics-werkruimte wilt wijzigen, voert u de volgende Azure CLI-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen <application-insights-resource-name><resource-group-name>en <log-analytics-workspace-name> door uw specifieke waarden:
az monitor app-insights component update --app <application-insights-resource-name> --resource-group <resource-group-name> --workspace <log-analytics-workspace-name>
Zie de az monitor app-insights component update voor meer informatie over de opdracht.
Als u de Log Analytics-werkruimte wilt wijzigen, voert u de volgende Azure PowerShell-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen<resource-group-name>, <application-insights-resource-name><subscription-id>en <log-analytics-workspace-name> door uw specifieke waarden:
Update-AzApplicationInsights -ResourceGroupName <resource-group-name> -Name <application-insights-resource-name> -WorkspaceResourceId /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>
Zie de Update-AzApplicationInsights voor meer informatie over de opdracht.
Als u de Log Analytics-werkruimte wilt wijzigen met behulp van de REST API, gebruikt u de volgende aanvraag en vervangt u de tijdelijke aanduidingen<subscription-id>, <resource-group-name>, <application-insights-resource-name>, , <access-token>en <azure-region-name><log-analytics-workspace-name>door uw specifieke waarden:
PATCH https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Insights/components/<application-insights-resource-name>?api-version=2020-02-02
Authorization: Bearer <access-token>
Content-Type: application/json
{
"location": "<azure-region-name>",
"properties": {
"WorkspaceResourceId": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>"
}
}
Zie de REST API-documentatie voor meer informatie over het wijzigen van de gekoppelde werkruimte met behulp van de REST API.
Als u de Log Analytics-werkruimte wilt wijzigen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen<application-insights-resource-name>, <azure-region-name><application-type>en <log-analytics-workspace-name> door uw specifieke waarden:
param workspaceResourceId string = '/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>'
resource appInsights 'Microsoft.Insights/components@2020-02-02-preview' = {
name: '<application-insights-resource-name>'
location: '<azure-region-name>'
properties: {
Application_Type: '<application-type>'
WorkspaceResourceId: workspaceResourceId
}
}
Als u de Log Analytics-werkruimte wilt wijzigen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen<application-insights-resource-name>, <azure-region-name><application-type>en <log-analytics-workspace-name> door uw specifieke waarden:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"type": "Microsoft.Insights/components",
"apiVersion": "2020-02-02-preview",
"name": "<application-insights-resource-name>",
"location": "<azure-region-name>",
"properties": {
"Application_Type": "<application-type>",
"WorkspaceResourceId": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>"
}
}
]
}
Telemetrie exporteren
De verouderde functionaliteit voor continue export wordt niet ondersteund voor werkruimte-gebaseerde resources. Gebruik in plaats daarvan diagnostische instellingen.
Notitie
Het exporteren van diagnostische instellingen kan de kosten verhogen. Bekijk Telemetrie exporteren van Application Insights voor meer informatie.
Zie de pagina met prijzen van Azure Monitor voor informatie over prijzen voor deze functie. Vóór het begin van de facturering worden meldingen verzonden. Als u na de kennisgevingsperiode telemetrie-export blijft gebruiken, wordt u gefactureerd tegen het toepasselijke tarief.
Selecteer in uw Application Insights-resource diagnostische instellingen>diagnostische instelling toevoegen.
U kunt alle tabellen of een subset van tabellen selecteren die u wilt archiveren in een opslagaccount. U kunt ook streamen naar een Event Hub.
Als u telemetrie wilt exporteren met behulp van diagnostische instellingen, voert u de volgende Azure CLI-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen<diagnostic-setting-name>, <application-insights-resource-name><resource-group-name>en <storage-account-name> door uw specifieke waarden:
az monitor diagnostic-settings create --name <diagnostic-setting-name> --resource <application-insights-resource-name> --resource-group <resource-group-name> --resource-type Microsoft.Insights/components --storage-account <storage-account-name>
Met deze voorbeeldopdracht worden diagnostische instellingen ingeschakeld en worden alle logboeken van uw Application Insights-resource naar het opgegeven opslagaccount verzonden. Als u ook metrische gegevens wilt verzenden, voegt u deze toe --metrics '[{"category": "AllMetrics", "enabled": true}]' aan de opdracht.
Zie de az monitor diagnostic-settings create voor meer informatie over de opdracht.
Als u telemetrie wilt exporteren met behulp van diagnostische instellingen, voert u de volgende Azure PowerShell-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen <application-insights-resource-id><diagnostic-setting-name>en <storage-account-id> door uw specifieke waarden:
Set-AzDiagnosticSetting -ResourceId <application-insights-resource-id> -Name <diagnostic-setting-name> -StorageAccountId <storage-account-id> -Enabled $True
Met deze voorbeeldopdracht worden diagnostische instellingen ingeschakeld en worden alle metrische gegevens en logboeken van uw Application Insights-resource naar het opgegeven opslagaccount verzonden.
Zie de Set-AzDiagnosticSetting voor meer informatie over de opdracht.
Als u telemetrie wilt exporteren naar een Azure-opslagaccount met behulp van een diagnostische instelling, gebruikt u de volgende aanvraag en vervangt u de tijdelijke aanduidingen<subscription-id>, <resource-group-name>, <application-insights-resource-name>, , <diagnostic-setting-name><access-token>en <storage-account-name> door uw specifieke waarden:
PUT https://management.azure.com//subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>/providers/Microsoft.Insights/diagnosticSettings/<diagnostic-setting-name>?api-version=2021-05-01-preview
Authorization: Bearer <access-token>
Content-Type: application/json
{
"properties": {
"storageAccountId": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>",
"logs": [
{
"category": "AppRequests",
"enabled": true
}
],
"metrics": [
{
"category": "AllMetrics",
"enabled": true
}
]
}
}
Met deze voorbeeldoproep worden diagnostische instellingen ingeschakeld en worden alle metrische gegevens en logboeken van uw Application Insights-resource naar het opgegeven opslagaccount verzonden.
Zie de REST API-documentatie voor meer informatie over het maken van een diagnostische instelling met behulp van de REST API.
Als u telemetrie wilt exporteren met behulp van diagnostische instellingen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen<application-insights-resource-name>, <azure-region-name>, <application-type>, <diagnostic-setting-name>, , <subscription-id>en <resource-group><storage-account-name> door uw specifieke waarden:
param appInsightsName string = '<application-insights-resource-name>'
param location string = '<azure-region-name>'
param applicationType string = '<application-type>'
param diagnosticSettingName string = '<diagnostic-setting-name>'
param storageAccountId string = '/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>'
resource appInsights 'Microsoft.Insights/components@2020-02-02' = {
name: appInsightsName
location: location
kind: applicationType
properties: {
Application_Type: applicationType
}
}
resource diagnosticSetting 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
name: diagnosticSettingName
scope: appInsights
properties: {
storageAccountId: storageAccountId
logs: [
{
category: 'AppRequests'
enabled: true
}
]
metrics: [
{
category: 'AllMetrics'
enabled: true
}
]
}
}
Als u telemetrie wilt exporteren met behulp van diagnostische instellingen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen<application-insights-resource-name>, <azure-region-name>, <application-type>, <diagnostic-setting-name>, , <subscription-id>en <resource-group><storage-account-name> door uw specifieke waarden:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"appInsightsName": {
"type": "string",
"defaultValue": "<application-insights-resource-name>"
},
"location": {
"type": "string",
"defaultValue": "<azure-region-name>"
},
"applicationType": {
"type": "string",
"defaultValue": "<application-type>"
},
"diagnosticSettingName": {
"type": "string",
"defaultValue": "<diagnostic-setting-name>"
},
"storageAccountId": {
"type": "string",
"defaultValue": "/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>"
}
},
"resources": [
{
"type": "Microsoft.Insights/components",
"apiVersion": "2020-02-02",
"name": "[parameters('appInsightsName')]",
"location": "[parameters('location')]",
"kind": "[parameters('applicationType')]",
"properties": {
"Application_Type": "[parameters('applicationType')]"
}
},
{
"type": "Microsoft.Insights/diagnosticSettings",
"apiVersion": "2021-05-01-preview",
"name": "[parameters('diagnosticSettingName')]",
"scope": "[resourceId('Microsoft.Insights/components', parameters('appInsightsName'))]",
"properties": {
"storageAccountId": "[parameters('storageAccountId')]",
"logs": [
{
"category": "AppRequests",
"enabled": true
}
],
"metrics": [
{
"category": "AllMetrics",
"enabled": true
}
]
}
}
]
}
De gegevensretentie instellen
Als u de gegevensretentie voor de gekoppelde Log Analytics-werkruimte wilt instellen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen <log-analytics-workspace-name>, <azure-region-name><retention-period-in-days> door uw specifieke waarden:
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2020-08-01' = {
name: '<log-analytics-workspace-name>'
location: '<azure-region-name>'
properties: {
retentionInDays: <retention-period-in-days>
}
}
Als u de gegevensretentie voor de gekoppelde Log Analytics-werkruimte wilt instellen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen <log-analytics-workspace-name>, <azure-region-name><retention-period-in-days> door uw specifieke waarden:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"type": "Microsoft.OperationalInsights/workspaces",
"apiVersion": "2020-08-01",
"name": "<log-analytics-workspace-name>",
"location": "<azure-region-name>",
"properties": {
"retentionInDays": <retention-period-in-days>
}
}
]
}
De daglimiet instellen
De dagelijkse limiet moet onafhankelijk worden ingesteld voor zowel Application Insights als de onderliggende Log Analytics-werkruimte. De effectieve dagelijkse limiet is het minimum van de twee instellingen.
Notitie
Momenteel biedt Azure geen manier om de dagelijkse limiet voor Application Insights in te stellen via de Azure CLI.
Als u de dagelijkse limiet voor Log Analytics wilt wijzigen, voert u de volgende Azure CLI-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen <resource-group-name>en <log-analytics-workspace-name><daily-cap-in-gb> door uw specifieke waarden.
az monitor log-analytics workspace update --resource-group <resource-group-name> --workspace-name <log-analytics-workspace-name> --set workspaceCapping.dailyQuotaGb=<daily-cap-in-gb>
Zie de az monitor log-analytics workspace update voor meer informatie over de opdracht.
Als u de dagelijkse limiet voor Application Insights en Log Analytics wilt wijzigen, voert u de volgende Azure PowerShell-opdrachten uit in uw terminal en vervangt u de tijdelijke aanduidingen door uw specifieke waarden.
Application Insights
Tijdelijke aanduidingen: <resource-group-name>, <application-insights-resource-name><daily-cap-in-gb>
Set-AzApplicationInsightsDailyCap -ResourceGroupName <resource-group-name> -Name <application-insights-resource-name> -DailyCapGB <daily-cap-in-gb>
Zie de Set-AzApplicationInsightsDailyCap voor meer informatie over de opdracht.
Log Analytics
Tijdelijke aanduidingen: <resource-group-name>, <log-analytics-workspace-name><daily-cap-in-gb>
Set-AzOperationalInsightsWorkspace -ResourceGroupName <resource-group-name> -Name <log-analytics-workspace-name> -DailyQuotaGb <daily-cap-in-gb>
Zie de Set-AzOperationalInsightsWorkspace voor meer informatie over de opdracht.
Notitie
Momenteel biedt Azure geen manier om de dagelijkse limiet voor Application Insights in te stellen met de Azure CLI.
Als u de dagelijkse limiet voor Log Analytics wilt wijzigen, gebruikt u de volgende aanvraag en vervangt u de tijdelijke aanduidingen <subscription-id>, <resource-group-name>, <log-analytics-workspace-name>, <access-token>, <azure-region-name>en <daily-cap-in-gb> door uw specifieke waarden:
Plaatsaanduidingen
PATCH https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>?api-version=2023-09-01
Authorization: Bearer <access-token>
Content-Type: application/json
{
"location": '<azure-region-name>',
"properties": {
"workspaceCapping": {
"dailyQuotaGb": <daily-cap-in-gb>,
},
}
}
Zie de REST API-documentatie voor meer informatie over de instelling van de dagelijkse limiet van Log Analytics
Notitie
Momenteel biedt Azure geen manier om de dagelijkse limiet voor Application Insights in te stellen met een Bicep-sjabloon.
Als u de dagelijkse limiet voor Log Analytics wilt instellen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen <log-analytics-workspace-name><azure-region-name>en <daily-cap-in-gb> door uw specifieke waarden:
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2020-08-01' = {
name: '<log-analytics-workspace-name>'
location: '<azure-region-name>'
properties: {
dailyQuotaGb: <daily-cap-in-gb>
}
}
Notitie
Momenteel biedt Azure geen manier om de dagelijkse limiet voor Application Insights in te stellen met behulp van een ARM-sjabloon.
Als u de dagelijkse limiet voor Log Analytics wilt instellen, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen <log-analytics-workspace-name><azure-region-name>en <daily-cap-in-gb> door uw specifieke waarden:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"type": "Microsoft.OperationalInsights/workspaces",
"apiVersion": "2023-09-01",
"name": "<log-analytics-workspace-name>",
"location": "<azure-region-name>",
"properties": {
"workspaceCapping": {
"dailyQuotaGb": <daily-cap-in-gb>
}
}
}
]
}
Het prijsplan instellen
Het prijsplan voor Application Insights-resources kan worden ingesteld in de bijbehorende Log Analytics-werkruimte. Zie Kostenberekeningen en opties van Azure Monitor-logboeken voor meer informatie over beschikbare prijsplannen.
Notitie
Als u onverwachte kosten of hoge kosten in Application Insights ziet, kan deze handleiding u helpen. Het behandelt veelvoorkomende oorzaken, zoals een hoog telemetrievolume, pieken in gegevensopname en onjuist geconfigureerde steekproeven. Het is vooral handig als u problemen aan het oplossen bent met betrekking tot kostenpieken; telemetrievolumes; het niet werken van steekproeven; gegevenslimieten; hoge gegevensinname; of onverwachte facturering. Zie Problemen met hoge gegevensopname in Application Insights oplossen om aan de slag te gaan.
Als u het prijsplan wilt instellen, voert u een van de volgende Azure CLI-opdrachten uit in uw terminal en vervangt u de tijdelijke aanduidingen <log-analytics-workspace-name><azure-region-name>en (indien van toepassing) <capacity-reservation-in-gb> door uw specifieke waarden:
Betalen per gebruik
az monitor log-analytics workspace update --resource-group <resource-group-name> --workspace-name <log-analytics-workspace-name> --set PerGB2018
Toezeggingslaag
az monitor log-analytics workspace update --resource-group <resource-group-name> --workspace-name <log-analytics-workspace-name> --set CapacityReservation --level <capacity-reservation-in-gb>
Zie de az monitor log-analytics workspace update voor meer informatie over de opdracht.
Als u het prijsplan wilt instellen, voert u een van de volgende Azure PowerShell-opdrachten uit in uw terminal en vervangt u de tijdelijke aanduidingen <log-analytics-workspace-name><azure-region-name>en (indien van toepassing) <capacity-reservation-in-gb> door uw specifieke waarden:
Betalen per gebruik
Set-AzOperationalInsightsWorkspace -ResourceGroupName <resource-group-name> -Name <log-analytics-workspace-name> -Sku perb2018
Toezeggingslaag
Set-AzOperationalInsightsWorkspace -ResourceGroupName <resource-group-name> -Name <log-analytics-workspace-name> -Sku capacityreservation -SkuCapacity <capacity-reservation-in-gb>
Zie de Set-AzOperationalInsightsWorkspace voor meer informatie over de opdracht.
Als u het prijsplan wilt instellen met behulp van de REST API, gebruikt u een van de volgende aanvragen en vervangt u de tijdelijke aanduidingen <subscription-id>, <resource-group-name>, <log-analytics-workspace-name>en <access-token>(indien van toepassing) <capacity-reservation-in-gb> door uw specifieke waarden:
Betalen per gebruik
PUT https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>/pricingPlans/current?api-version=2017-10-01
Content-Type: application/json
Authorization: Bearer <access-token>
{
"properties": {
"sku": {
"name": "pergb2018"
}
}
}
Toezeggingslaag
PUT https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.OperationalInsights/workspaces/<log-analytics-workspace-name>/pricingPlans/current?api-version=2017-10-01
Content-Type: application/json
Authorization: Bearer <access-token>
{
"properties": {
"sku": {
"name": "capacityreservation",
"capacityReservationLevel": <capacity-reservation-in-gb>
}
}
}
Zie de REST API-documentatie voor meer informatie over het instellen van het prijsplan met behulp van de REST API.
Als u het prijsplan wilt instellen met Bicep, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen en voor de toezeggingslaag <log-analytics-workspace-name><azure-region-name>ook <capacity-reservation-in-gb> door uw specifieke waarden:
Betalen per gebruik
param workspaceName string = '<log-analytics-workspace-name>'
param workspaceRegion string = '<azure-region-name>'
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2020-08-01' = {
name: workspaceName
location: workspaceRegion
properties: {
sku: {
name: 'pergb2018'
}
}
}
Toezeggingslaag
param workspaceName string = '<log-analytics-workspace-name>'
param workspaceRegion string = '<azure-region-name>'
param capacityReservationLevel int = '<capacity-reservation-in-gb>'
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2020-08-01' = {
name: workspaceName
location: workspaceRegion
properties: {
sku: {
name: 'capacityreservation'
capacityReservationLevel: capacityReservationLevel
}
}
}
Zie de Microsoft.OperationalInsights/workspaces voor meer informatie over het bijwerken van de resource met Bicep.
Als u het prijsplan wilt instellen met behulp van een ARM-sjabloon, plakt u de volgende code in uw sjabloon en vervangt u de tijdelijke aanduidingen <log-analytics-workspace-name><azure-region-name>en voor de toezeggingslaag ook <capacity-reservation-in-gb> door uw specifieke waarden:
Betalen per gebruik
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"workspaceName": {
"type": "string",
"defaultValue": "<log-analytics-workspace-name>"
},
"workspaceRegion": {
"type": "string",
"defaultValue": "<azure-region-name>"
}
},
"resources": [
{
"name": "[parameters('workspaceName')]",
"type": "Microsoft.OperationalInsights/workspaces",
"apiVersion": "2020-08-01",
"location": "[parameters('workspaceRegion')]",
"properties": {
"sku": {
"name": "pergb2018"
}
}
}
]
}
Toezeggingslaag
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"workspaceName": {
"type": "string",
"defaultValue": "<log-analytics-workspace-name>"
},
"workspaceRegion": {
"type": "string",
"defaultValue": "<azure-region-name>"
},
"capacityReservationLevel": {
"type": "int",
"defaultValue": <capacity-reservation-in-gb>
}
},
"resources": [
{
"name": "[parameters('workspaceName')]",
"type": "Microsoft.OperationalInsights/workspaces",
"apiVersion": "2020-08-01",
"location": "[parameters('workspaceRegion')]",
"properties": {
"sku": {
"name": "capacityreservation",
"capacityReservationLevel": "[parameters('capacityReservationLevel')]"
}
}
}
]
}
Zie de Microsoft.OperationalInsights/workspaces voor meer informatie over het bijwerken van de resource met behulp van een ARM-sjabloon.
IP-maskering uitschakelen
In Application Insights worden standaard geen IP-adressen opgeslagen. Zie De verwerking van geolocatie en IP-adressen voor meer informatie over het uitschakelen van IP-maskering.
Aanvullende middelen maken
Een beschikbaarheidstest maken
Als u een standaard beschikbaarheidstest met standaardinstellingen wilt maken, voert u de volgende Azure CLI-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen<resource-group-name>, <azure-region-name>, <web-test-name>, , <url><subscription-id>en <application-insights-resource-name> door uw specifieke waarden:
az monitor app-insights web-test create --resource-group <resource-group-name> \
--location <azure-region-name> \
--web-test-kind standard \
--name <web-test-name> \
--defined-web-test-name <web-test-name> \
--request-url <url> \
--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/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>=Resource
Zie de az monitor app-insights web-test create voor meer informatie over de opdracht.
Notitie
De webtestregio (-location) wijkt af van de geografische locatie (-locationslet op het meervoudformulier) waarvan meerdere kunnen worden geselecteerd. De -location verwijst naar de Azure-regio waar de webtest wordt gemaakt en gehost, terwijl -locations deze verwijst naar geografische locatie of locaties waaruit de webtest wordt uitgevoerd. Zie Application Insights-beschikbaarheidstests voor een volledige lijst met alle geografische locaties.
Als u een standaard beschikbaarheidstest met standaardinstellingen wilt maken, voert u de volgende Azure PowerShell-opdracht uit in uw terminal en vervangt u de tijdelijke aanduidingen<resource-group-name>, <azure-region-name>, <web-test-name>, , <url><subscription-id>en <application-insights-resource-name> door uw specifieke waarden:
$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"
New-AzApplicationInsightsWebTest -ResourceGroupName <resource-group-name> `
-Location <azure-region-name> `
-Name <web-test-name> `
-TestName <web-test-name> `
-Kind standard `
-RequestUrl <url> `
-RetryEnabled `
-RuleSslCheck `
-RuleSslCertRemainingLifetimeCheck 7 `
-Frequency 300 `
-GeoLocation $geoLocation `
-RequestHttpVerb GET `
-Timeout 120 `
-RuleExpectedHttpStatusCode 200 `
-Enabled `
-Tag @{"hidden-link:/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>" = "Resource"}
Zie de New-AzApplicationInsightsWebTest voor meer informatie over de opdracht.
Notitie
De webtestregio (-Location) verschilt van de geografische locatie (-GeoLocation) waarvan meerdere kunnen worden geselecteerd.
-Location verwijst naar de Azure-regio waar de webtest wordt gemaakt en gehost, terwijl -GeoLocation deze verwijst naar de geografische locatie of locaties waaruit de webtest wordt uitgevoerd. Zie Application Insights-beschikbaarheidstests voor een volledige lijst met alle geografische locaties.
Als u een standaard beschikbaarheidstest wilt maken met standaardinstellingen met behulp van de REST API, gebruikt u de volgende aanvraag en vervangt u de tijdelijke aanduidingen<subscription-id>, , <resource-group-name><application-insights-resource-name>, <web-test-name>, , <access-token>en <azure-region-name><url> door uw specifieke waarden:
PUT https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>/webtests/<web-test-name>?api-version=2021-08-01
Content-Type: application/json
Authorization: Bearer <access-token>
{
"location": "<azure-region-name>",
"properties": {
"Name": "<web-test-name>",
"SyntheticMonitorId": "<web-test-name>",
"Enabled": true,
"Frequency": 300,
"Timeout": 120,
"Kind": "standard",
"RetryEnabled": true,
"Request": {
"RequestUrl": "<url>",
"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"
}
]
},
"Tags": {
"hidden-link:/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>": "Resource"
}
}
Notitie
De webtestregio (-location) verschilt van de geografische locatie (-Locationslet op de meervoudsvorm) waarvan meerdere kunnen worden geselecteerd.
-location verwijst naar de Azure-regio waar de webtest wordt gemaakt en gehost, terwijl -Locations deze verwijst naar de geografische locatie of locaties waaruit de webtest wordt uitgevoerd. Zie Application Insights-beschikbaarheidstests voor een volledige lijst met alle geografische locaties.
Raadpleeg onze REST API-documentatie voor meer informatie over het maken en configureren van webtests met behulp van de REST API.
Als u een standaard beschikbaarheidstest wilt maken met standaardinstellingen met Bicep, voegt u de volgende code toe aan uw sjabloon en vervangt u de tijdelijke aanduidingen<web-test-name>, <azure-region-name>, <subscription-id>, , <resource-group-name>en <application-insights-resource-name><url>door uw specifieke waarden:
resource webTest 'microsoft.insights/webtests@2022-06-15' = {
name: '<web-test-name>'
location: '<azure-region-name>'
tags: {
'hidden-link:/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>': 'Resource'
}
properties: {
SyntheticMonitorId: '<web-test-name>'
Name: '<web-test-name>'
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: '<url>'
HttpVerb: 'GET'
}
ValidationRules: {
ExpectedHttpStatusCode: 200
SSLCheck: true
SSLCertRemainingLifetimeCheck: 7
}
}
}
Notitie
De webtestregio (location) verschilt van de geografische locatie (Locations) waarvan meerdere kunnen worden geselecteerd.
location verwijst naar de Azure-regio waar de webtest wordt gemaakt en gehost, terwijl Locations deze verwijst naar de geografische locatie of locaties waaruit de webtest wordt uitgevoerd. Zie Application Insights-beschikbaarheidstests voor een volledige lijst met alle geografische locaties.
Zie Microsoft.Insights-webtests voor meer informatie over het maken van beschikbaarheidstests met Bicep.
Als u een standaard beschikbaarheidstest wilt maken met standaardinstellingen met behulp van een ARM-sjabloon, voegt u de volgende code toe aan uw sjabloon en vervangt u de tijdelijke aanduidingen<web-test-name>, , <azure-region-name>, <subscription-id>, <resource-group-name><application-insights-resource-name>en <url> door uw specifieke waarden:
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"resources": [
{
"type": "microsoft.insights/webtests",
"apiVersion": "2022-06-15",
"name": "<web-test-name>",
"location": "<azure-region-name>",
"tags": {
"hidden-link:/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/microsoft.insights/components/<application-insights-resource-name>": "Resource"
},
"properties": {
"SyntheticMonitorId": "<web-test-name>",
"Name": "<web-test-name>",
"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": "<url>",
"HttpVerb": "GET"
},
"ValidationRules": {
"ExpectedHttpStatusCode": 200,
"SSLCheck": true,
"SSLCertRemainingLifetimeCheck": 7
}
}
}
]
}
Notitie
De webtestregio (location) verschilt van de geografische locatie (Locations) waarvan meerdere kunnen worden geselecteerd.
location verwijst naar de Azure-regio waar de webtest wordt gemaakt en gehost, terwijl Locations deze verwijst naar de geografische locatie of locaties waaruit de webtest wordt uitgevoerd. Zie Application Insights-beschikbaarheidstests voor een volledige lijst met alle geografische locaties.
Zie Microsoft.Insights-webtests voor meer informatie over het maken van beschikbaarheidstests met behulp van een ARM-sjabloon.
Een waarschuwing voor metrische gegevens toevoegen
Hint
Elke Application Insights-resource wordt geleverd met metrische gegevens die standaard beschikbaar zijn. Als afzonderlijke onderdelen rapporteren aan dezelfde Application Insights-resource, is het mogelijk niet zinvol om waarschuwingen over deze metrische gegevens te geven.
Zie de REST API-documentatie voor een lijst met verschillende voorbeelden van REST API-aanroepvoorbeelden voor het maken van een metrische waarschuwing.
Zie het sjabloonartikel met metrische waarschuwingen om het maken van metrische waarschuwingen te automatiseren.
Meer Application Insights-resources maken
Hoeveel Application Insights-resources moet ik implementeren?
Wanneer u de volgende versie van een webtoepassing ontwikkelt, wilt u de Application Insights-telemetrie niet combineren met de nieuwe versie en de reeds uitgebrachte versie.
Om verwarring te voorkomen, verstuurt u de telemetrie vanuit verschillende ontwikkelingsfasen naar afzonderlijke Application Insights-resources met aparte verbindingsreeksen.
Als uw systeem een exemplaar van Azure Cloud Services is, is er een andere methode voor het instellen van afzonderlijke verbindingsreeks s.
Wanneer u één Application Insights-resource gebruikt
Gebruik één Application Insights-resource voor:
- Het stroomlijnen van DevOps/ITOps-beheer voor toepassingen die samen zijn geïmplementeerd, doorgaans ontwikkeld en beheerd door hetzelfde team.
- Het centraliseren van key performance indicators, zoals reactietijden en foutpercentages, in een dashboard standaard. Segmenteer indien nodig op rolnaam in de Metrics Explorer.
- Wanneer u geen ander op rollen gebaseerd toegangsbeheer van Azure tussen toepassingsonderdelen nodig hebt.
- Wanneer identieke waarschuwingscriteria voor metrische gegevens, continue exports en facturering/quotabeheer voor onderdelen voldoende zijn.
- Wanneer het acceptabel is dat een API-sleutel gegevens gelijkmatig van alle onderdelen benadert, en 10 API-sleutels voldoen aan de behoeften van alle onderdelen.
- Wanneer dezelfde instellingen voor slimme detectie en integratie van werkitems geschikt zijn voor alle rollen.
Notitie
Als u meerdere Application Insights-resources wilt samenvoegen, kunt u uw bestaande toepassingsonderdelen naar een nieuwe, geconsolideerde Application Insights-resource laten verwijzen. De telemetrie die is opgeslagen in uw oude resource, wordt niet overgedragen naar de nieuwe resource. Verwijder alleen de oude resource wanneer u voldoende telemetrie hebt in de nieuwe resource voor bedrijfscontinuïteit.
Andere overwegingen
Als u portalervaringen wilt activeren, voegt u aangepaste code toe om zinvolle waarden toe te wijzen aan het kenmerk Cloud_RoleName . Zonder deze waarden werken portalfuncties niet.
Voor Azure Service Fabric-toepassingen en klassieke cloudservices configureert de SDK automatisch services door te lezen uit de Azure-rolomgeving. Voor andere app-typen moet u deze doorgaans expliciet instellen.
Live Metrics kan geen gegevens splitsen op rolnaam.
Versie- en releasebeheer volgen
Wanneer u een nieuwe versie van uw toepassing publiceert, wilt u de telemetrie van verschillende builds kunnen scheiden. U kunt de eigenschap Toepassingsversie instellen zodat u zoekresultaten en metric explorer-resultaten kunt filteren.
Er zijn diverse methoden voor het instellen van de eigenschap Toepassingsversie.
Optie 1: De versie rechtstreeks instellen
Voeg de regel telemetryClient.Context.Component.Version = typeof(MyProject.MyClass).Assembly.GetName().Version; toe aan de initialisatiecode van uw toepassing.
Als u ervoor wilt zorgen dat alle TelemetryClient exemplaren consistent zijn ingesteld, verpakt u die regel in een telemetrie-initialisatiefunctie.
Optie 2: De versie instellen in BuildInfo.config (alleen ASP.NET)
De Application Insights-webmodule haalt de versie van het BuildLabel knooppunt op. Neem dit bestand op in uw project en vergeet niet om de eigenschap Altijd kopiëren in Solution Explorer in te stellen.
<?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>
Genereer BuildInfo.config automatisch in de Microsoft Build Engine. Voeg de volgende regels toe aan uw .csproj bestand:
<PropertyGroup>
<GenerateBuildInfoConfigFile>true</GenerateBuildInfoConfigFile>
<IncludeServerNameInBuildInfo>true</IncludeServerNameInBuildInfo>
</PropertyGroup>
Met deze stap wordt een bestand met de naam yourProjectName.BuildInfo.config gegenereerd. Het publicatieproces hernoemt het naar BuildInfo.config.
Het buildlabel bevat een tijdelijke aanduiding (*AutoGen_...*) wanneer u met Visual Studio bouwt. Wanneer deze is gebouwd met de Microsoft Build Engine, wordt de tijdelijke aanduiding gevuld met het juiste versienummer.
Als u wilt toestaan dat de Microsoft Build Engine versienummers genereert, stelt u de versie in zoals 1.0.* in AssemblyReference.cs.
Release-aantekeningen
Als u Azure DevOps gebruikt, kunt u een aantekeningsmarkering aan uw grafieken toevoegen wanneer u een nieuwe versie vrijgeeft.
Het proces voor het maken van resources automatiseren
Het proces voor het maken van resources kan worden geautomatiseerd door gebruik te maken van Bicep- of JSON-sjablonen met Azure Resource Manager. U kunt verschillende resources samen verpakken om ze in één implementatie te maken. U kunt bijvoorbeeld een Application Insights-resource maken met beschikbaarheidstests, metrische waarschuwingen en een diagnostische instelling voor het verzenden van telemetrie naar een Azure Storage-account.
Een sjabloon genereren in Azure Portal
U kunt een sjabloon genereren op basis van bestaande resources.
Alleen Application Insights
- Ga naar de Application Insights-resource in Azure Portal.
- Open de sjabloon Exporteren die wordt vermeld onder Automation in de navigatiebalk aan de linkerkant.
- (Optioneel): Als u uw eigen parameters wilt gebruiken, schakelt u Inclusief parameters uit.
-
Download het sjabloonbestand of implementeer het rechtstreeks in Azure Portal.
Meerdere resources
- Ga naar de resourcegroep van uw Application Insights-resource.
- Markeer in het deelvenster Overzicht alle resources die u wilt opnemen in de sjabloon en selecteer vervolgens Sjabloon exporteren in de bovenste navigatiebalk.
- (Optioneel): Als u uw eigen parameters wilt gebruiken, schakelt u Inclusief parameters uit.
-
Download het sjabloonbestand of implementeer het rechtstreeks in Azure Portal.
Een volledig nieuwe sjabloon maken
Als u wilt weten hoe u een volledig nieuwe ARM-sjabloon maakt, gaat u naar onze ARM-sjabloondocumentatie met zelfstudies voor het maken van een sjabloon, het toevoegen van resources, het toevoegen van parameters en meer.
Beschikbare eigenschappen voor Application Insights, beschikbaarheidstests, metrische waarschuwingen, diagnostische instellingen en andere resources vindt u in onze Referentiedocumentatie voor Azure-resources onder het knooppunt Reference>Monitor>Insights .
Hint
U kunt ook quickstart-sjablonen gebruiken, die beschikbaar zijn onder aan elke referentiepagina voor Azure-resources die in deze sectie zijn gekoppeld. Als u wilt weten hoe u sjablonen gebruikt, gaat u naar zelfstudie: Azure Quickstart-sjablonen gebruiken.
Volgende stappen
