Application Insights, Log Analytics ile tümleşir ve telemetri verilerini ortak bir Log Analytics çalışma alanına gönderir. Bu kurulum Log Analytics özelliklerine tam erişim sağlar, günlükleri tek bir konumda birleştirir ve uygulamalar arası/çalışma alanı sorguları gereksinimini ortadan kaldıran birleşik Azure rol tabanlı erişim denetimi sağlar.
Gelişmiş özellikler şunlardır:
Bu makalede Application Insights kaynaklarını oluşturma ve yapılandırma işlemleri gösterilmektedir. Application Insights kaynağının kendisine ek olarak , günlük üst sınırı ve fiyatlandırma planını ayarlama gibi çeşitli yapılandırmalar da ekleyebilirsiniz. Ayrıca Azure Resource Manager'ı kullanarak kullanılabilirlik testleri oluşturabilir, ölçüm uyarıları ayarlayabilir ve işlemi otomatikleştirebilirsiniz.
Not
Çalışma alanı tabanlı Application Insights kaynakları için veri alımı ve saklama, verilerin bulunduğu Log Analytics çalışma alanı aracılığıyla faturalandırılır. Faturalama hakkında daha fazla bilgi edinmek için bkz. Azure İzleyici Günlükleri fiyatlandırma ayrıntıları.
Önkoşullar
- Etkin bir Azure aboneliği.
- Kaynak oluşturmak için gerekli izinler.
Ek gereksinimler
Application Insights Azure CLI komutlarına erişmek için önce şunu çalıştırmanız gerekir:
az extension add -n application-insights
Komutunu çalıştırmazsanız az extension add şunu belirten bir hata iletisi görürsünüz: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.
Bicep şablonlarını Azure CLI, Azure PowerShell ve Azure portalı üzerinden dağıtabilirsiniz. Ek gereksinimler için ilgili sekmelere bakın.
ARM şablonlarını Azure CLI, Azure PowerShell ve Azure portalı üzerinden dağıtabilirsiniz. Ek gereksinimler için ilgili sekmelere bakın.
Application Insights kaynağı oluştur
Not
Kaynak oluşturma sırasında mevcut bir Log Analytics çalışma alanına bağlanmıyorsanız, Application Insights kaynağınızla birlikte otomatik olarak yeni bir Log Analytics kaynağı oluşturulur.
Çalışma alanı tabanlı bir Application Insights kaynağı oluşturduğunuzda veya güncelleştirdiğinizde ve bunu farklı bir abonelikteki Log Analytics çalışma alanına bağladığınızda, işlemi gerçekleştiren kimliğin hedef Microsoft.OperationalInsights/workspaces/sharedKeys/actionçalışma alanında izni olmalıdır. Bu gereksinim, her iki abonelik de aynı Microsoft Entra kiracıda olsa bile geçerlidir. Kimlik bu izne sahip değilse işlem bir 403 (Forbidden) hatayla başarısız olabilir. Hedef çalışma alanında bu eylemi içeren en az ayrıcalıklı rolü verin veya Application Insights kaynağıyla aynı abonelikteki bir çalışma alanını kullanın.
-
Azure portalınaoturum açın.
-
Kaynak oluştur’u seçin.
-
İzleme ve Tanılama kategorisini açın, ardından Application Insights'ı seçin.
- Tüm ilgili bilgileri girin, ardından Application Insights kaynağınızı gözden geçirin ve oluşturun .
Kaynağınızı oluşturduktan sonra ilgili çalışma alanı bilgilerini Application Insights'a Genel Bakış bölmesinde bulabilirsiniz.
Yeni birleşik çalışma alanı sorgu ortamından yararlanabileceğiniz ilişkili Log Analytics çalışma alanına gitmek için mavi bağlantı metnini seçin.
Not
Application Insights klasik kaynak sorgularınız, çalışma kitaplarınız ve günlük tabanlı uyarılarınız için tam geriye dönük uyumluluk sağlamaya devam ediyoruz. Yeni çalışma alanı tabanlı tablo yapısını veya şemasını sorgulamak veya görüntülemek için önce Log Analytics çalışma alanınıza gitmeniz gerekir. Klasik Application Insights sorgu deneyimine erişmek için Application Insights bölmelerinde Günlükler (Analiz) seçeneğini belirleyin.
Aşağıdaki Azure CLI örnekte az monitor app-insights component create komutu kullanılır.
# 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"
Not
Azure CLI komutlar geçerli CLI bağlamından Azure Resource Manager uç noktasını kullandığından, komut söz diziminde management.azure.com belirtilmesi gerekmez.
Aşağıdaki Azure PowerShell örnek New-AzApplicationInsights cmdlet'ini kullanır.
# 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
Not
Azure PowerShell cmdlet'leri geçerli Az bağlamındaki Azure Resource Manager uç noktasını kullandığından, cmdlet söz diziminde management.azure.com belirtilmesi gerekmez.
Aşağıdaki REST örneği , Components - Create Or Update REST API işlemini kullanır.
PUT https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/components/{ResourceName}?api-version=2020-02-02
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>"
}
}
Aşağıdaki Bicep örneği, Microsoft.Insights/components kaynak türünü kullanır.
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@2020-02-02' = {
name: resourceName
location: azureRegion
kind: 'web'
properties: {
Application_Type: 'web'
WorkspaceResourceId: workspaceResourceId
}
}
Aşağıdaki ARM (JSON) örneği, Microsoft.Insights/components kaynak türünü kullanır.
{
"$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": "2020-02-02",
"name": "[parameters('resourceName')]",
"location": "[parameters('azureRegion')]",
"kind": "web",
"properties": {
"Application_Type": "web",
"WorkspaceResourceId": "[variables('workspaceResourceId')]"
}
}
]
}
Application Insights kaynağı oluşturduktan sonra izlemeyi yapılandırabilirsiniz.
Bağlantı dizesini alın
bağlantı dizesi, telemetri verilerinizi ilişkilendirmek istediğiniz kaynağı tanımlar. Ayrıca, kaynağınızın telemetriniz için hedef olarak kullandığı uç noktaları değiştirmek için de kullanabilirsiniz. bağlantı dizesi kopyalayıp uygulamanızın koduna veya bir ortam değişkenine eklemeniz gerekir.
Application Insights kaynağınızın bağlantı dizesini almak için:
- Application Insights kaynağınızı Azure portalında açın.
-
Temel Bileşenler bölümündeki Genel Bakış bölmesinde Bağlantı dizesi'ni arayın.
- Bağlantı dizesinin üzerine geldiğinizde panonuza kopyalamanızı sağlayan bir simge görüntülenir.
Aşağıdaki Azure CLI örneği az monitor app-insights component show komutunu kullanır.
# Set variables
resourceGroupName="<ResourceGroupName>"
resourceName="<ResourceName>"
# Retrieve the Application Insights component
az monitor app-insights component show \
--resource-group "$resourceGroupName" \
--app "$resourceName"
JSON yanıtında connectionString alanını arayın.
Aşağıdaki Azure PowerShell örnekte Get-AzApplicationInsights cmdlet'i kullanılır.
# Set variables
$resourceGroupName = "<ResourceGroupName>"
$resourceName = "<ResourceName>"
# Define parameters for Get-AzApplicationInsights
$getAzApplicationInsightsParams = @{
ResourceGroupName = $resourceGroupName
Name = $resourceName
}
# Retrieve the Application Insights component
Get-AzApplicationInsights @getAzApplicationInsightsParams
Çıkışta ConnectionString özelliğini arayın.
Aşağıdaki REST örneği Components - Get REST API işlemini kullanır.
GET https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/components/{ResourceName}?api-version=2020-02-02
Authorization: Bearer {AccessToken}
JSON yanıtında properties.connectionString alanını arayın.
Bicep şablonları için geçerli değildir.
ARM şablonları için geçerli değildir.
OpenTelemetry ile uygulama izleme
OpenTelemetry ile uygulama izleme için uygun Azure İzleyici OpenTelemetry Distro'sunu yükleyin ve bağlantı dizesini yeni oluşturduğunuz kaynağa yönlendirin.
OpenTelemetry ile uygulama izlemeyi ayarlama hakkında bilgi için aşağıdaki dile özgü belgelere bakın:
Otomatik enstrümantasyon
Azure İşlevleri ve Azure App Service gibi izleme hizmetleri için önce Application Insights kaynağınızı oluşturabilir, ardından izlemeyi etkinleştirdiğinizde buna işaret edebilirsiniz. Alternatif olarak, etkinleştirme işlemi sırasında yeni bir Application Insights kaynağı oluşturabilirsiniz.
İlişkili çalışma alanını değiştirme
Application Insights kaynağı oluşturduktan sonra ilişkili Log Analytics çalışma alanını değiştirebilirsiniz.
Önemli
REST çağrıları, ARM şablonları ve Bicep şablonları oluşturma veya güncelleştirme (PUT) semantiğini kullanır. Bu yöntemleri kullanarak bir Application Insights bileşenini güncelleştirdiğinizde, saklamak istediğiniz tüm gerekli özellikleri ekleyin. Dahil olmayan özellikler sıfırlanabilir veya kaldırılabilir.
Application Insights kaynağınızda Özellikler>Çalışma Alanını> DeğiştirLog Analytics Çalışma Alanları'yı seçin.
Aşağıdaki Azure CLI örneği, az monitor app-insights component update komutunu kullanır.
# 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"
Aşağıdaki Azure PowerShell örnekte Update-AzApplicationInsights cmdlet'i kullanılır.
# 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
Aşağıdaki REST örneği , Components - Create Or Update REST API işlemini kullanır.
PUT https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/components/{ResourceName}?api-version=2020-02-02
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>"
}
}
Aşağıdaki Bicep örneği, Microsoft.Insights components kaynak türünü kullanır.
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@2020-02-02' = {
name: resourceName
location: azureRegion
kind: 'web'
properties: {
Application_Type: 'web'
WorkspaceResourceId: workspaceResourceId
}
}
Aşağıdaki ARM (JSON) örneği, Microsoft.Insights components kaynak türünü kullanır.
{
"$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": "2020-02-02",
"name": "[parameters('resourceName')]",
"location": "[parameters('azureRegion')]",
"kind": "web",
"properties": {
"Application_Type": "web",
"WorkspaceResourceId": "[variables('workspaceResourceId')]"
}
}
]
}
Telemetriyi dışarı aktarma
Çalışma alanı tabanlı kaynaklar için eski sürekli dışarı aktarma işlevi desteklenmez. Bunun yerine Tanılama ayarlarını kullanın.
Application Insights kaynağınızda Tanılama ayarları>Tanılama ayarını ekle seçin.
Depolama hesabında arşivlediğiniz tüm tabloları veya tabloların bir alt kümesini seçebilirsiniz. Ayrıca bir olay hub'ına akış da yapabilirsiniz.
Aşağıdaki Azure CLI örnekte az monitor diagnostic-settings create komutu kullanılır. Application Insights kaynağındaki günlükleri ve ölçümleri depolama hesabına gönderen bir tanılama ayarı oluşturur.
# 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}]'
Aşağıdaki Azure PowerShell örnek New-AzDiagnosticSetting cmdlet'ini kullanır. Application Insights kaynağındaki günlükleri ve ölçümleri depolama hesabına gönderen bir tanılama ayarı oluşturur.
# 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
Aşağıdaki REST örneği Tanılama Ayarları - REST API Oluşturma veya Güncelleştirme işlemini kullanır. Application Insights kaynağındaki günlükleri ve ölçümleri depolama hesabına gönderen bir tanılama ayarı oluşturur.
PUT https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/components/{ResourceName}/providers/Microsoft.Insights/diagnosticSettings/{DiagnosticSettingName}?api-version=2021-05-01-preview
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
}
]
}
}
Aşağıdaki Bicep örneği, Microsoft.Insights diagnosticSettings kaynak türünü kullanır. Application Insights kaynağındaki günlükleri ve ölçümleri depolama hesabına gönderen bir tanılama ayarı oluşturur.
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@2020-02-02' existing = {
name: resourceName
}
var storageAccountId = '/subscriptions/${subscriptionId}/resourceGroups/${resourceGroupName}/providers/Microsoft.Storage/storageAccounts/${storageAccountName}'
resource diagnosticSetting 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
name: diagnosticSettingName
scope: applicationInsightsComponent
properties: {
storageAccountId: storageAccountId
logs: [
{
category: 'AppRequests'
enabled: true
}
]
metrics: [
{
category: 'AllMetrics'
enabled: true
}
]
}
}
Aşağıdaki ARM şablonu örneği, Microsoft.Insights diagnosticSettings kaynak türünü kullanır. Application Insights kaynağındaki günlükleri ve ölçümleri depolama hesabına gönderen bir tanılama ayarı oluşturur.
{
"$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": "2021-05-01-preview",
"name": "[format('{0}/Microsoft.Insights/{1}', parameters('resourceName'), parameters('diagnosticSettingName'))]",
"properties": {
"storageAccountId": "[variables('storageAccountId')]",
"logs": [
{
"category": "AppRequests",
"enabled": true
}
],
"metrics": [
{
"category": "AllMetrics",
"enabled": true
}
]
}
}
]
}
Veri saklamayı ayarlama
Aşağıdaki Bicep örneği, Microsoft.OperationalInsights workspaces kaynak türünü kullanır. İlişkili Log Analytics çalışma alanı için veri saklama süresini ayarlar.
param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'
param retentionInDays int = <RetentionInDays>
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2025-07-01' = {
name: workspaceName
location: azureRegion
properties: {
retentionInDays: retentionInDays
}
}
Aşağıdaki ARM (JSON) örneği, Microsoft.OperationalInsights workspaces kaynak türünü kullanır. İlişkili Log Analytics çalışma alanı için veri saklama süresini ayarlar.
{
"$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": "2025-07-01",
"name": "[parameters('workspaceName')]",
"location": "[parameters('azureRegion')]",
"properties": {
"retentionInDays": "[parameters('retentionInDays')]"
}
}
]
}
Günlük sınırı ayarlama
Hem Application Insights hem de temel alınan Log Analytics çalışma alanı için günlük üst sınır bağımsız olarak ayarlanmalıdır. Geçerli günlük üst sınır, iki ayarın en azıdır.
Not
Şu anda Azure, Azure CLI aracılığıyla Application Insights için günlük üst sınırı ayarlamak için bir yol sağlamamaktadır.
Log Analytics:
Aşağıdaki Azure CLI örneğinde az monitor log-analytics workspace update komutu kullanılır.
# 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
Aşağıdaki Azure PowerShell örneklerde Set-AzApplicationInsightsDailyCap ve Set-AzOperationalInsightsWorkspace cmdlet'leri kullanılır.
Application Insights:
Aşağıdaki Azure PowerShell örneklerde Set-AzApplicationInsightsDailyCap cmdlet'i kullanılır.
# 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:
Aşağıdaki Azure PowerShell örneklerde Set-AzOperationalInsightsWorkspace cmdlet'i kullanılır.
# 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
Not
şu anda Azure, REST API aracılığıyla Application Insights için günlük üst sınırı ayarlamanın bir yolunu sağlamamaktadır.
Log Analytics:
Aşağıdaki REST örneği Çalışma Alanları - REST API'yi güncelleştirme işlemini kullanır.
PATCH https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{WorkspaceName}?api-version=2025-07-01
Authorization: Bearer {AccessToken}
Content-Type: application/json
{
"properties": {
"workspaceCapping": {
"dailyQuotaGb": <DailyCapInGb>
}
}
}
Not
Şu anda Azure, Bir Bicep şablonuyla Application Insights için günlük üst sınırı ayarlamanın bir yolunu sağlamamaktadır.
Log Analytics:
Aşağıdaki Bicep örneği, Microsoft.OperationalInsights workspaces kaynak türünü kullanır.
param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'
param dailyCapInGb int
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2025-07-01' = {
name: workspaceName
location: azureRegion
properties: {
workspaceCapping: {
dailyQuotaGb: dailyCapInGb
}
}
}
Not
Şu anda Azure, ARM şablonu kullanarak Application Insights için günlük üst sınırı ayarlamak için bir yol sağlamamaktadır.
Log Analytics:
Aşağıdaki ARM (JSON) örneği, Microsoft.OperationalInsights workspaces kaynak türünü kullanır.
{
"$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": "2025-07-01",
"name": "[parameters('workspaceName')]",
"location": "[parameters('azureRegion')]",
"properties": {
"workspaceCapping": {
"dailyQuotaGb": "[parameters('dailyCapInGb')]"
}
}
}
]
}
Fiyatlandırma planını ayarlama
Application Insights kaynakları için fiyatlandırma planı ilişkili Log Analytics çalışma alanında ayarlanabilir. Kullanılabilir fiyatlandırma planları hakkında daha fazla bilgi için bkz. Azure İzleyici Günlükleri maliyet hesaplamaları ve seçenekleri.
Not
Application Insights'ta beklenmeyen ücretler veya yüksek maliyetler görüyorsanız bu kılavuz yardımcı olabilir. Yüksek telemetri hacmi, veri alımı ani artışları ve yanlış yapılandırılmış örnekleme gibi yaygın nedenleri kapsar. Özellikle maliyet artışları, telemetri hacmi, örneklemenin çalışmaması, veri üst sınırı, yüksek veri alımı veya beklenmeyen faturalama ile ilgili sorunları gideriyorsanız kullanışlıdır. Başlamak için bkz. Application Insights'ta yüksek veri alımı sorunlarını giderme.
Aşağıdaki Azure CLI örneklerinde az monitor log-analytics workspace update komutu kullanılır.
Kullandıkça öde:
# 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
Taahhüt katmanı:
# 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"
Aşağıdaki Azure PowerShell örneklerde Set-AzOperationalInsightsWorkspace cmdlet'i kullanılır.
Kullandıkça öde:
# 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
Taahhüt katmanı:
# 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
Aşağıdaki REST örneklerde Fiyatlandırma Planı - REST API'yi güncelleştirme işlemi kullanılır.
Kullandıkça öde:
PUT https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{WorkspaceName}/pricingPlans/current?api-version=2017-10-01
Authorization: Bearer {AccessToken}
Content-Type: application/json
{
"properties": {
"sku": {
"name": "pergb2018"
}
}
}
Taahhüt katmanı:
PUT https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{WorkspaceName}/pricingPlans/current?api-version=2017-10-01
Authorization: Bearer {AccessToken}
Content-Type: application/json
{
"properties": {
"sku": {
"name": "capacityreservation",
"capacityReservationLevel": <CapacityReservationInGb>
}
}
}
Aşağıdaki Bicep örnekleri, Microsoft.OperationalInsights workspaces kaynak türünü kullanır.
Kullandıkça öde:
param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2025-07-01' = {
name: workspaceName
location: azureRegion
properties: {
sku: {
name: 'pergb2018'
}
}
}
Taahhüt katmanı:
param workspaceName string = '<WorkspaceName>'
param azureRegion string = '<AzureRegion>'
param capacityReservationInGb int
resource logAnalyticsWorkspace 'Microsoft.OperationalInsights/workspaces@2025-07-01' = {
name: workspaceName
location: azureRegion
properties: {
sku: {
name: 'capacityreservation'
capacityReservationLevel: capacityReservationInGb
}
}
}
Aşağıdaki ARM (JSON) örnekleri Microsoft.OperationalInsights workspaces kaynak türünü kullanır.
Kullandıkça öde:
{
"$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": "2025-07-01",
"name": "[parameters('workspaceName')]",
"location": "[parameters('azureRegion')]",
"properties": {
"sku": {
"name": "pergb2018"
}
}
}
]
}
Taahhüt katmanı:
{
"$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": "2025-07-01",
"name": "[parameters('workspaceName')]",
"location": "[parameters('azureRegion')]",
"properties": {
"sku": {
"name": "capacityreservation",
"capacityReservationLevel": "[parameters('capacityReservationInGb')]"
}
}
}
]
}
IP maskele özelliğini devre dışı bırakma
Application Insights varsayılan olarak IP adreslerini depolamaz. IP maskelemeyi devre dışı bırakma hakkında bilgi edinmek için bkz. Coğrafi konum ve IP adresi işleme.
Ek kaynaklar oluşturma
Kullanılabilirlik testi oluşturma
Aşağıdaki Azure CLI örnekte az monitor app-insights web-test create komutu kullanılır. Varsayılan ayarlarla standart bir kullanılabilirlik testi oluşturur.
# 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"
Not
Web testi bölgesi (--location), birden çok öğesinin seçilebileceği coğrafi konumdan farklıdır (--locationsçoğul biçimine dikkat edin).
--location web testinin oluşturulduğu ve barındırıldığı Azure bölgesini, --locations web testinin yürütüldüğü coğrafi konumu veya konumları ifade eder. Tüm coğrafi konumların tam listesi için bkz. Application Insights kullanılabilirlik testleri.
Aşağıdaki Azure PowerShell örnek New-AzApplicationInsightsWebTest cmdlet'ini kullanır. Varsayılan ayarlarla standart bir kullanılabilirlik testi oluşturur.
# 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
Not
Web testi bölgesi (-Location), birden çok öğesinin seçilebileceği coğrafi konumdan (-GeoLocation) farklıdır.
-Location web testinin oluşturulduğu ve barındırıldığı Azure bölgesini, -GeoLocation web testinin yürütüldüğü coğrafi konumu veya konumları ifade eder. Tüm coğrafi konumların tam listesi için bkz. Application Insights kullanılabilirlik testleri.
Aşağıdaki REST örneği , Web Testleri - REST API Oluşturma veya Güncelleştirme işlemini kullanır. Varsayılan ayarlarla standart bir kullanılabilirlik testi oluşturur.
PUT https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/webtests/{WebTestName}?api-version=2022-06-15
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" }
]
}
}
Not
Web testi bölgesi (location), birden çok öğesinin seçilebileceği coğrafi konumdan farklıdır (Locationsçoğul biçimine dikkat edin).
location web testinin oluşturulduğu ve barındırıldığı Azure bölgesini, Locations web testinin yürütüldüğü coğrafi konumu veya konumları ifade eder. Tüm coğrafi konumların tam listesi için bkz. Application Insights kullanılabilirlik testleri.
Aşağıdaki Bicep örneği, Microsoft.Insights webtests kaynak türünü kullanır. Varsayılan ayarlarla standart bir kullanılabilirlik testi oluşturur.
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@2022-06-15' = {
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
}
}
}
Not
Web testi bölgesi (location), birden çok öğesinin seçilebileceği coğrafi konumdan (Locations) farklıdır.
location web testinin oluşturulduğu ve barındırıldığı Azure bölgesini, Locations web testinin yürütüldüğü coğrafi konumu veya konumları ifade eder. Tüm coğrafi konumların tam listesi için bkz. Application Insights kullanılabilirlik testleri.
Bicep kullanarak kullanılabilirlik testleri oluşturma hakkında daha fazla bilgi için bkz. Microsoft.Insights web testleri.
Aşağıdaki ARM (JSON) örneği, Microsoft.Insights webtests kaynak türünü kullanır. Varsayılan ayarlarla standart bir kullanılabilirlik testi oluşturur.
{
"$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": "2022-06-15",
"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
}
}
}
]
}
Not
Web testi bölgesi (location), birden çok öğesinin seçilebileceği coğrafi konumdan (Locations) farklıdır.
location web testinin oluşturulduğu ve barındırıldığı Azure bölgesini, Locations web testinin yürütüldüğü coğrafi konumu veya konumları ifade eder. Tüm coğrafi konumların tam listesi için bkz. Application Insights kullanılabilirlik testleri.
Ölçüm uyarısı ekleme
Tavsiye
Her Application Insights kaynağı, kullanıma hazır ölçümlerle birlikte gelir. Ayrı bileşenler aynı Application Insights kaynağına rapor verirse, bu ölçümlerle ilgili uyarı almak mantıklı olmayabilir.
Ölçüm uyarılarının oluşturulmasını otomatikleştirmek için Ölçüm uyarıları şablonu makalesine bakın.
Daha fazla Application Insights kaynağı oluşturma
Kaç Application Insights kaynağı dağıtmalıyım?
Bir web uygulamasının sonraki sürümünü geliştirirken, yeni sürümden ve mevcut sürümden gelen Application Insights telemetrisini karıştırmak istemezsiniz.
Karışıklığı önlemek için farklı geliştirme aşamalarından gelen telemetri verilerini, ayrı bağlantı dizeleri kullanarak ayrı Application Insights kaynaklarına gönderin.
Sisteminiz bir Azure Cloud Services örneğiyse, ayrı bağlantı dizesi ayarlamanın başka bir yöntemi vardır.
Tek bir Application Insights kaynağı ne zaman kullanılır?
Aşağıdakiler için tek bir Application Insights kaynağı kullanın:
- Birlikte dağıtılan, genellikle aynı ekip tarafından geliştirilen ve yönetilen uygulamalar için DevOps/ITOps yönetimini akışa alma.
- Varsayılan olarak bir panoda yanıt süreleri ve hata oranları gibi temel performans göstergelerini merkezileştirme. Gerekirse metrikler gezgininde rol adına göre segmentlere ayırın.
- Uygulama bileşenleri arasında farklı Azure rol tabanlı erişim denetimi yönetimine gerek kalmadığında.
- Aynı ölçümler için uyarı kriterleri, sürekli aktarımlar ve bileşenler arasında faturalama/kota yönetiminin yeterli olduğu durumlarda.
- Bir API anahtarının tüm bileşenlerden verilere eşit şekilde erişmesi kabul edilebilir olduğunda ve 10 API anahtarı tüm bileşenlerdeki gereksinimleri karşıladığında.
- Tüm roller için aynı akıllı algılama ve iş öğesi tümleştirme ayarları uygun olduğunda.
Not
Birden çok Application Insights kaynağını birleştirmek istiyorsanız, mevcut uygulama bileşenlerinizi yeni, birleştirilmiş bir Application Insights kaynağına işaret edebilirsiniz. Eski kaynağınızda depolanan telemetri yeni kaynağa aktarılmıyor. Eski kaynağı yalnızca yeni kaynakta iş sürekliliği için yeterli telemetriniz olduğunda silin.
Dikkat edilecek diğer noktalar
Portal deneyimlerini etkinleştirmek için Cloud_RoleName özniteliğine anlamlı değerler atamak için özel kod ekleyin. Bu değerler olmadan portal özellikleri çalışmaz.
Azure Service Fabric uygulamaları ve klasik bulut hizmetleri için SDK, Azure Rol Ortamı'ndan okuyarak hizmetleri otomatik olarak yapılandırıyor. Diğer uygulama türleri için genellikle açıkça ayarlamanız gerekir.
Canlı Ölçümler verileri rol adına göre bölemez.
Versiyon ve sürüm izleme
Uygulamanızın yeni bir sürümünü yayımladığınızda, telemetriyi farklı derlemelerden ayırabilmek istersiniz.
Arama ve ölçüm gezgini sonuçlarını filtrelemek için Uygulama Sürümü özelliğini ayarlayabilirsiniz.
Uygulama Sürümü özelliğini ayarlamanın birkaç farklı yöntemi vardır.
Seçenek 1: Sürümü doğrudan ayarlama
OpenTelemetry tabanlı izleme için kaynak özniteliklerini kullanarak uygulama meta verilerini tutarlı bir şekilde ayarlayın.
Seçenek 2:BuildInfo.config üzerine sürümü ayarlama (yalnızca ASP.NET)
Application Insights web modülü, BuildLabel düğümünden sürümü alır. Bu dosyayı projenize ekleyin ve Çözüm Gezgini'da Her Zaman Kopyala özelliğini ayarlamayı unutmayın.
<?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>
BuildInfo.config öğesini Microsoft Derleme Altyapısı'nda otomatik olarak oluşturun. Dosyanıza .csproj aşağıdaki satırları ekleyin:
<PropertyGroup>
<GenerateBuildInfoConfigFile>true</GenerateBuildInfoConfigFile>
<IncludeServerNameInBuildInfo>true</IncludeServerNameInBuildInfo>
</PropertyGroup>
Bu adım, yourProjectNamebir dosya oluşturur. Yayımla işlemi bunu olarak BuildInfo.configyeniden adlandırır.
Visual Studio ile derleme yaptığınızda, derleme etiketi bir yer tutucu (*AutoGen_...*) içerir. Microsoft Derleme Altyapısı ile derlendiğinde yer tutucu doğru sürüm numarasıyla doldurulur.
Microsoft Build Engine'in sürüm numaraları oluşturmasına izin vermek için, 1.0.* öğesindeki AssemblyReference.cs gibi bir sürüm ayarlayın.
Sürüm ek açıklamaları
Azure DevOps kullanıyorsanız, yeni bir sürüm yayımladığınızda grafiklerinize ek açıklama işaretçisi ekleyebilirsiniz.
Kaynak oluşturma işlemini otomatikleştirme
Kaynak oluşturma işlemi , Azure Resource Manager ile Bicep veya JSON şablonları kullanılarak otomatikleştirilebilir. Bir dağıtımda oluşturmak için birkaç kaynağı birlikte paketleyebilirsiniz. Örneğin, azure depolama hesabına telemetri göndermek için kullanılabilirlik testlerine, ölçüm uyarılarına ve tanılama ayarına sahip bir Application Insights kaynağı oluşturabilirsiniz.
Azure portalında şablon oluşturma
Mevcut kaynaklardan şablon oluşturabilirsiniz.
Yalnızca Application Insights
- Azure portalında Application Insights kaynağına gidin.
- Sol gezinti çubuğunda Otomasyon altında listelenen Dışarı Aktarma şablonunu açın.
- (İsteğe bağlı): Kendi parametrelerinizi kullanmak için Parametreleri ekle'nin işaretini kaldırın.
- Şablon dosyasını indirin veya doğrudan Azure portalında dağıtın.
Birden çok kaynak
- Application Insights kaynağınızın kaynak grubuna gidin.
-
Genel Bakış bölmesinde, şablona eklenmesini istediğiniz tüm kaynakları işaretleyin ve üst gezinti çubuğunda Şablonu dışarı aktar'ı seçin.
- (İsteğe bağlı): Kendi parametrelerinizi kullanmak için Parametreleri ekle'nin işaretini kaldırın.
- Şablon dosyasını indirin veya doğrudan Azure portalında dağıtın.
Sıfırdan şablon oluşturma
Sıfırdan ARM şablonu oluşturmayı öğrenmek için şablon oluşturma, kaynak ekleme, parametre ekleme ve daha fazlasını içeren ARM şablonu belgelerimizi ziyaret edin.
Application Insights, kullanılabilirlik testleri, ölçüm uyarıları, tanılama ayarları ve diğer kaynaklar için kullanılabilir özellikler, Başvuru>> düğümü altındaki Azure kaynak başvurusu belgelerimizde bulunabilir.
Sonraki adımlar
