Aracılığıyla paylaş


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} öğesini 2016-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 olarak application/jsonayarlayı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} öğesini 2016-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 olarak application/jsonayarlayı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ı.

Azure İzleyici ile SSIS işlemlerini izleme