Azure İzleyici'de tanılama ayarları oluşturma

Azure İzleyici günlükleri, Azure Depolama veya Azure Event Hubs gibi farklı hedeflere Azure platformu ölçümleri ve günlükleri göndermek için Azure İzleyici'de tanılama ayarları oluşturun ve düzenleyin. Azure portalı, Azure CLI, PowerShell ve Azure Resource Manager gibi tanılama ayarlarıyla çalışmak için farklı yöntemler kullanabilirsiniz.

Önemli

Tanılama Ayarı ayarlarında ayarlanan Bekletme İlkesi artık kullanım dışıdır ve artık kullanılamaz. Günlüklerinizin ne kadar süreyle tutulduğunu yönetmek için Azure Depolama Yaşam Döngüsü İlkesi'ni kullanın. Daha fazla bilgi için bkz. Tanılama ayarları depolama saklamayı Azure Depolama yaşam döngüsü yönetimine geçirme

Azure portalı

Tanılama ayarlarını Azure portalında Azure İzleyici menüsünden veya kaynağın menüsünden yapılandırabilirsiniz.

1. Azure portalında tanılama ayarlarını yapılandırdığınız yer kaynağa bağlıdır:

   • Tek bir kaynak için kaynağın menüsündeki İzleme'nin altında Tanılama ayarları'nı seçin.

     

   • Bir veya daha fazla kaynak için Azure İzleyici menüsündeki Ayarlar altında Tanılama ayarları'nı seçin ve ardından kaynağı seçin.

     

   • Etkinlik günlüğü için Azure İzleyici menüsünde Etkinlik günlüğü'nü ve ardından Etkinlik Günlüklerini Dışarı Aktar'ı seçin. Etkinlik günlüğü için eski yapılandırmaları devre dışı bıraktığınıza emin olun. Yönergeler için bkz . Mevcut ayarları devre dışı bırakma.

     

2. Seçtiğiniz kaynakta ayar yoksa, bir ayar oluşturmanız istenir. Tanılama ayarı ekle’yi seçin.

   

   Kaynakta mevcut ayarlar varsa, önceden yapılandırılmış ayarların listesini görürsünüz. Yeni bir ayar eklemek için Tanılama ayarı ekle'yi seçin. Mevcut bir ayarı düzenlemek için Ayarı düzenle'yi de seçebilirsiniz. Her ayarın hedef türlerinden en fazla biri olabilir.

   

3. Henüz yoksa ayarınıza bir ad verin.

   

4. Yönlendirilecek günlükler ve ölçümler: Günlükler için bir kategori grubu seçin veya daha sonra belirtilen hedeflere göndermek istediğiniz her veri kategorisi için tek tek onay kutularını seçin. Kategori listesi her Azure hizmeti için farklılık gösterir. Ölçümleri Azure İzleyici Günlüklerinde de depolamak istiyorsanız AllMetrics'i seçin.

5. Hedef ayrıntıları: Her hedef için onay kutusunu seçin. Daha fazla bilgi ekleyebilmeniz için seçenekler görüntülenir.

   

   1. Log Analytics çalışma alanına gönder: Aboneliğinizi ve verileri göndermek istediğiniz Log Analytics çalışma alanını seçin. Çalışma alanınız yoksa, devam etmeden önce bir çalışma alanı oluşturmanız gerekir.

   2. Depolama hesabında arşivle: Aboneliğinizi ve verileri depolamak istediğiniz Depolama hesabını seçin.

      

      İpucu

      Günlüklerinizin ne kadar süreyle tutulduğunu yönetmek için Azure Depolama Yaşam Döngüsü İlkesi'ni kullanın. Tanılama Ayarı ayarlarında ayarlanan Bekletme İlkesi artık kullanım dışıdır.

   3. Bir olay hub'ına akış: Aşağıdaki ölçütleri belirtin:

      • Abonelik: Olay hub'ının parçası olduğu abonelik.
      • Olay hub'ı ad alanı: Yoksa bir ad alanı oluşturmanız gerekir.
      • Olay hub'ı adı (isteğe bağlı): Tüm verileri gönderecek ad. Bir ad belirtmezseniz, her günlük kategorisi için bir olay hub'ı oluşturulur. Birden çok kategoriye gönderiyorsanız, oluşturulan olay hub'larının sayısını sınırlamak için bir ad belirtebilirsiniz. Daha fazla bilgi için bkz . Azure Event Hubs kotaları ve sınırları.
      • Olay hub'ı ilke adı (ayrıca isteğe bağlı): İlke, akış mekanizmasının sahip olduğu izinleri tanımlar. Daha fazla bilgi için bkz . Event Hubs özellikleri.

   4. İş ortağı çözümüne gönder: Öncelikle Azure Yerel ISV Hizmetleri'ni aboneliğinize yüklemeniz gerekir. Yapılandırma seçenekleri iş ortağına göre farklılık gösterir. Daha fazla bilgi için bkz . Azure Yerel ISV Hizmetlerine genel bakış.

6. Hizmet hem kaynağa özgü hem de Azure tanılama modunu destekliyorsa, Hedef olarak Log Analytics çalışma alanını seçtiğinizde hedef tabloyu seçme seçeneği görüntülenir. Tablo yapısı daha fazla esneklik ve daha verimli sorgular sağladığından genellikle Kaynağa özgü seçeneğini belirlemeniz gerekir.

   

7. Kaydet'i seçin.

Birkaç dakika sonra yeni ayar bu kaynak için ayarlar listenizde görünür. Yeni olay verileri oluşturulurken günlükler belirtilen hedeflere akışla aktarılır. Bir olayın yayılıp log analytics çalışma alanında görünmesi arasında 15 dakika kadar sürebilir.

PowerShell

Azure PowerShell ile bir tanılama ayarı oluşturmak için New-AzDiagnosticSetting cmdlet'ini kullanın. Parametrelerinin açıklamaları için bu cmdlet'in belgelerine bakın.

Önemli

Etkinlik günlüğü için bu yöntemi kullanamazsınız. Bunun yerine, Resource Manager şablonu oluşturmak ve Bunu PowerShell ile dağıtmak için Azure Resource Manager şablonu kullanarak Azure İzleyici'de tanılama ayarı oluştur'u kullanın.

Aşağıdaki örnek PowerShell cmdlet'i Log Analytics Çalışma Alanı'nı kullanarak tüm günlükler için veya denetim günlükleri için bir tanılama ayarı ve bir anahtar kasası için ölçümler oluşturur.

$KV= Get-AzKeyVault -ResourceGroupName <resource group name> -VaultName <key vault name>
$Law= Get-AzOperationalInsightsWorkspace -ResourceGroupName <resource group name> -Name <workspace name>  #LAW name is case sensitive

$metric = @()
$log = @()
$metric += New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics
# For all available logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup allLogs  
# or, for audit logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup audit    
New-AzDiagnosticSetting -Name 'KeyVault-Diagnostics' -ResourceId $KV.ResourceId -WorkspaceId $Law.ResourceId -Log $log -Metric $metric -Verbose

CLI

Azure CLI ile bir tanılama ayarı oluşturmak için az monitor diagnostic-settings create komutunu kullanın. Parametrelerinin açıklamaları için bu komutun belgelerine bakın.

Önemli

Etkinlik günlüğü için bu yöntemi kullanamazsınız. Bunun yerine, Resource Manager şablonu oluşturup Azure CLI ile dağıtmak için Resource Manager şablonu kullanarak Azure İzleyici'de tanılama ayarı oluştur'u kullanın.

Aşağıdaki örnek komut, üç hedefi de kullanarak bir tanılama ayarı oluşturur. Söz dizimi, istemcinize bağlı olarak biraz farklıdır.

Hizmet destekliyorsa kaynağa özgü modu belirtmek için parametresini export-to-resource-specific değeriyle trueekleyin.

az monitor diagnostic-settings create  \
--name KeyVault-Diagnostics \
--resource /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.KeyVault/vaults/mykeyvault \
--logs    '[{"category": "AuditEvent","enabled": true}]' \
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--storage-account /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Storage/storageAccounts/<storage account name> \
--workspace /subscriptions/<subscription ID>/resourcegroups/<resource group name>/providers/microsoft.operationalinsights/workspaces/<log analytics workspace name> \
--event-hub-rule /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.EventHub/namespaces/<event hub namespace>/authorizationrules/RootManageSharedAccessKey \
--event-hub <event hub name> \
--export-to-resource-specific true

Resource Manager

Aşağıdaki JSON şablonu, tüm denetim günlüklerini log analytics çalışma alanına göndermek için bir tanılama ayarı oluşturmaya yönelik bir örnek sağlar. öğesinin apiVersion kapsamdaki kaynağa bağlı olarak değişebileceğini unutmayın.

Şablon dosyası

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "scope": {
        "type": "string"
    },
    "workspaceId": {
        "type": "string"
    },
    "settingName": {
        "type": "string"
    }
},
  "resources": [
    {
      "type": "Microsoft.Insights/diagnosticSettings",
      "apiVersion": "2021-05-01-preview",
      "scope": "[parameters('scope')]",
      "name": "[parameters('settingName')]",
      "properties": {
       "workspaceId": "[parameters('workspaceId')]",
      "logs": [
             {
            "category": null,
            "categoryGroup": "audit",
            "enabled": true
          }
        ]
      }
    }
  ]
  }

Parametre dosyası

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "settingName": {
        "value": "audit3"
    },
    "workspaceId": {
      "value": "/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>"
    },
    "scope": {
      "value": "Microsoft.<resource type>/<resourceName>"
    }
  }
}

REST API

Azure İzleyici REST API'sini kullanarak tanılama ayarları oluşturmak veya güncelleştirmek için bkz. Tanılama ayarları.

Azure İlkesi

Büyük ölçekte tanılama ayarları oluşturmak için Azure İlkesi kullanma hakkında ayrıntılı bilgi için bkz. Azure İlkesi kullanarak uygun ölçekte tanılama ayarları oluşturma.

Sorun giderme

Bazı sorun giderme ipuçları aşağıdadır.

Ölçüm kategorisi desteklenmiyor

Tanılama ayarını dağıttığınızda, "Ölçüm kategorisi 'xxxx' desteklenmiyor" gibi bir hata iletisi alırsınız. Önceki dağıtımınız başarılı olsa bile bu hatayı alabilirsiniz.

Sorun bir Resource Manager şablonu, REST API, CLI veya Azure PowerShell kullandığınızda oluşur. Yalnızca desteklenen kategori adları sunulduğundan Azure portalı aracılığıyla oluşturulan tanılama ayarları etkilenmez.

Sorun, temel alınan API'deki yeni bir değişiklik nedeniyle oluşur. AllMetrics dışındaki ölçüm kategorileri desteklenmez ve belirli birkaç Azure hizmeti dışında hiçbir zaman desteklenmez. Geçmişte, bir tanılama ayarı dağıtılırken diğer kategori adları yoksayılırdı. Azure İzleyici arka ucu bu kategorileri AllMetrics'e yeniden yönlendirdi. Şubat 2021 itibarıyla arka uç, sağlanan ölçüm kategorisinin doğru olduğunu onaylayacak şekilde güncelleştirildi. Bu değişiklik bazı dağıtımların başarısız olmasına neden olabilir.

Bu hatayı alırsanız, sorunu çözmek için dağıtımlarınızı tüm ölçüm kategorisi adlarını AllMetrics ile değiştirecek şekilde güncelleştirin. Dağıtım daha önce birden çok kategori ekliyorsa, AllMetrics başvurusuyla yalnızca bir kategori tutun. Sorun yaşamaya devam ederseniz Azure portalı üzerinden Azure desteği ile iletişime geçin.

ResourceID'de ASCII olmayan karakterler nedeniyle ayar kayboluyor

Tanılama ayarları, ASCII olmayan karakterler içeren kaynak kimliklerini desteklemez. Örneğin, "Preproducción" terimini düşünün. Azure'da kaynakları yeniden adlandıramadığınız için tek seçeneğiniz ASCII olmayan karakterler olmadan yeni bir kaynak oluşturmaktır. Karakterler bir kaynak grubundaysa, altındaki kaynakları yeni bir gruba taşıyabilirsiniz. Aksi takdirde, kaynağı yeniden oluşturmanız gerekir.

Yinelenen veya bırakılan veri olasılığı

Tüm günlük verilerinin hedeflerinize doğru şekilde gönderilmesi için her türlü çaba sarf edilir, ancak uç noktalar arasında günlüklerin %100 veri aktarımını garanti etmek mümkün değildir. Bu sorunlara geçici bir çözüm bulmak ve günlük verilerinin uç noktaya ulaştığından emin olmak için yeniden denemeler ve diğer mekanizmalar mevcuttur.

Sonraki adımlar

• Azure İzleyici'de tanılama ayarlarıyla çalışmayı gözden geçirin
• Tanılama ayarları depolama saklamayı Azure Depolama yaşam döngüsü yönetimine geçirme
• Azure platform günlükleri hakkında daha fazla bilgi edinin