Azure İzleyici REST API'sini kullanarak tanılama günlüklerini ayarlama
Bu makalede, Azure İzleyici REST API'sini kullanarak Azure Data Factory için tanılama günlüklerinin nasıl ayarlanacağı açıklanır.
Tanılama ayarları
Uyumsuz kaynaklar için tanılama günlüklerini yapılandırmak için tanılama ayarlarını kullanın. Kaynak denetimi ayarları aşağıdaki özelliklere sahiptir:
- Tanılama günlüklerinin nereye gönderileceğini belirtir. Örnek olarak Azure depolama hesabı, Azure olay hub'ı veya İzleyici günlükleri verilebilir.
- Hangi günlük kategorilerinin gönderileceğini belirtir.
- Her günlük kategorisinin bir depolama hesabında ne kadar süreyle tutulacağını belirtir.
- Sıfır gün saklama, günlüklerin sınırsız süreyle tutulacağı anlamına gelir. Aksi takdirde, değer 1 ile 2.147.483.647 arasında herhangi bir gün sayısı olabilir.
- Bekletme ilkeleri ayarlandıysa ancak günlükleri bir depolama hesabında depolama devre dışı bırakıldıysa, bekletme ilkelerinin hiçbir etkisi olmaz. Örneğin, bu koşul yalnızca olay hub'ları veya İzleme günlükleri seçenekleri belirlendiğinde oluşabilir.
- Bekletme ilkeleri her gün uygulanır. Gün arasındaki sınır, eşgüdümlü Evrensel Saat (UTC) gece yarısında gerçekleşir. Günün sonunda, bekletme ilkesinin ötesindeki günlerin günlükleri silinir. Örneğin, bir günlük saklama ilkeniz varsa, bugünün başında, dünden önceki günlükler silinir.
TANıLAMA günlüklerini REST API'sini izleme aracılığıyla etkinleştirme
Tanılama günlüklerini etkinleştirmek için REST API'sini izleyin.
REST API'yi İzleme'de tanılama ayarı oluşturma veya güncelleştirme
İste
PUT
https://management.azure.com/{resource-id}/providers/microsoft.insights/diagnosticSettings/service?api-version={api-version}
Üst Bilgiler
{api-version}
öğesini2016-09-01
ile değiştirin.- değerini tanılama ayarlarını düzenlemek istediğiniz kaynağın kimliğiyle değiştirin
{resource-id}
. Daha fazla bilgi için bkz. Azure kaynaklarınızı yönetmek için kaynak gruplarını kullanma. Content-Type
Üst bilgiyi olarakapplication/json
ayarlayın.- Yetkilendirme üst bilgisini Microsoft Entra Id'den aldığınız JSON web belirtecine ayarlayın. Daha fazla bilgi için bkz . İsteklerin kimliğini doğrulama.
Gövde
{
"properties": {
"storageAccountId": "/subscriptions/<subID>/resourceGroups/<resourceGroupName>/providers/Microsoft.Storage/storageAccounts/<storageAccountName>",
"serviceBusRuleId": "/subscriptions/<subID>/resourceGroups/<resourceGroupName>/providers/Microsoft.EventHub/namespaces/<eventHubName>/authorizationrules/RootManageSharedAccessKey",
"workspaceId": "/subscriptions/<subID>/resourceGroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<LogAnalyticsName>",
"metrics": [
],
"logs": [
{
"category": "PipelineRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "TriggerRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "ActivityRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
}
]
},
"location": ""
}
Özellik | Türü | Açıklama |
---|---|---|
storageAccountId | String | Tanılama günlüklerini göndermek istediğiniz depolama hesabının kaynak kimliği. |
serviceBusRuleId | String | Akış tanılama günlükleri için olay hub'larının oluşturulmasını istediğiniz service-bus ad alanının service-bus kural kimliği. Kural kimliği biçimindedir {service bus resource ID}/authorizationrules/{key name} . |
workspaceId | String | Günlüklerin kaydedileceği çalışma alanının çalışma alanı kimliği. |
metrics | Çağrılan işlem hattına geçirilecek işlem hattı çalıştırmasının parametre değerleri | Parametre adlarını bağımsız değişken değerleriyle eşleyen bir JSON nesnesi. |
Günlük | Karmaşık Tür | Kaynak türü için tanılama günlüğü kategorisinin adı. Bir kaynağın tanılama günlüğü kategorilerinin listesini almak için GET tanılama ayarları işlemi gerçekleştirin. |
Kategori | String | Günlük kategorileri dizisi ve bunların bekletme ilkeleri. |
timeGrain | String | ISO 8601 süre biçiminde yakalanan ölçümlerin ayrıntı düzeyi. Özellik değeri, bir dakikayı belirten olmalıdır PT1M . |
Etkin | Boolean | Bu kaynak için ölçüm veya günlük kategorisi koleksiyonunun etkinleştirilip etkinleştirilmediğini belirtir. |
Retentionpolicy | Karmaşık Tür | Bir ölçüm veya günlük kategorisi için bekletme ilkesini açıklar. Bu özellik yalnızca depolama hesapları için kullanılır. |
Gün | Int | Ölçümlerin veya günlüklerin tutulacak gün sayısı. Özellik değeri 0 ise günlükler sonsuza kadar tutulur. Bu özellik yalnızca depolama hesapları için kullanılır. |
Yanıt
200 tamam.
{
"id": "/subscriptions/<subID>/resourcegroups/adf/providers/microsoft.datafactory/factories/shloadobetest2/providers/microsoft.insights/diagnosticSettings/service",
"type": null,
"name": "service",
"location": null,
"kind": null,
"tags": null,
"properties": {
"storageAccountId": "/subscriptions/<subID>/resourceGroups/<resourceGroupName>//providers/Microsoft.Storage/storageAccounts/<storageAccountName>",
"serviceBusRuleId": "/subscriptions/<subID>/resourceGroups/<resourceGroupName>//providers/Microsoft.EventHub/namespaces/<eventHubName>/authorizationrules/RootManageSharedAccessKey",
"workspaceId": "/subscriptions/<subID>/resourceGroups/<resourceGroupName>//providers/Microsoft.OperationalInsights/workspaces/<LogAnalyticsName>",
"eventHubAuthorizationRuleId": null,
"eventHubName": null,
"metrics": [],
"logs": [
{
"category": "PipelineRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "TriggerRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "ActivityRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
}
]
},
"identity": null
}
REST API'yi İzleme'de tanılama ayarları hakkında bilgi edinin
İste
GET
https://management.azure.com/{resource-id}/providers/microsoft.insights/diagnosticSettings/service?api-version={api-version}
Üst Bilgiler
{api-version}
öğesini2016-09-01
ile değiştirin.- değerini tanılama ayarlarını düzenlemek istediğiniz kaynağın kimliğiyle değiştirin
{resource-id}
. Daha fazla bilgi için bkz. Azure kaynaklarınızı yönetmek için kaynak gruplarını kullanma. Content-Type
Üst bilgiyi olarakapplication/json
ayarlayın.- Yetkilendirme üst bilgisini Microsoft Entra Id'den aldığınız bir JSON web belirtecine ayarlayın. Daha fazla bilgi için bkz . İsteklerin kimliğini doğrulama.
Yanıt
200 tamam.
{
"id": "/subscriptions/<subID>/resourcegroups/adf/providers/microsoft.datafactory/factories/shloadobetest2/providers/microsoft.insights/diagnosticSettings/service",
"type": null,
"name": "service",
"location": null,
"kind": null,
"tags": null,
"properties": {
"storageAccountId": "/subscriptions/<subID>/resourceGroups/shloprivate/providers/Microsoft.Storage/storageAccounts/azmonlogs",
"serviceBusRuleId": "/subscriptions/<subID>/resourceGroups/shloprivate/providers/Microsoft.EventHub/namespaces/shloeventhub/authorizationrules/RootManageSharedAccessKey",
"workspaceId": "/subscriptions/<subID>/resourceGroups/ADF/providers/Microsoft.OperationalInsights/workspaces/mihaipie",
"eventHubAuthorizationRuleId": null,
"eventHubName": null,
"metrics": [],
"logs": [
{
"category": "PipelineRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "TriggerRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
},
{
"category": "ActivityRuns",
"enabled": true,
"retentionPolicy": {
"enabled": false,
"days": 0
}
}
]
},
"identity": null
}
Daha fazla bilgi için bkz . Tanılama ayarları.