Diagnosztikai naplók beállítása az Azure Monitor REST API-val

Ez a cikk azt ismerteti, hogyan állíthat be diagnosztikai naplókat az Azure Data Factoryhez az Azure Monitor REST API használatával.

Diagnosztikai beállítások

Diagnosztikai beállítások használatával konfigurálhatja a diagnosztikai naplókat a nem számító erőforrásokhoz. Az erőforrás-vezérlés beállításai a következő funkciókkal rendelkeznek:

  • Megadják a diagnosztikai naplók küldésének helyét. Ilyen például egy Azure Storage-fiók, egy Azure-eseményközpont vagy egy Monitor-napló.
  • Megadják, hogy mely naplókategóriákat küldi el a rendszer.
  • Megadják, hogy az egyes naplókategóriák mennyi ideig legyenek tárolva egy tárfiókban.
  • A nulla nap megőrzése azt jelenti, hogy a naplók örökre megmaradnak. Ellenkező esetben az érték 1 és 2 147 483 647 közötti napok száma lehet.
  • Ha a megőrzési szabályzatok be vannak állítva, de a naplók tárfiókban való tárolása le van tiltva, a megőrzési szabályzatoknak nincs hatása. Ez a feltétel például akkor fordulhat elő, ha csak az eseményközpontok vagy a figyelési naplók beállításai vannak kiválasztva.
  • A rendszer naponta alkalmazza a megőrzési szabályzatokat. A napok közötti határ éjfélkor, az egyezményes világidő (UTC) szerint történik. A nap végén a rendszer törli a megőrzési szabályzaton túli napok naplóit. Ha például egy nap megőrzési szabályzattal rendelkezik, a mai nap elején a tegnap előtti naplók törlődnek.

Diagnosztikai naplók engedélyezése a Monitor REST API-val

A diagnosztikai naplók engedélyezéséhez használja a Monitor REST API-t.

Diagnosztikai beállítás létrehozása vagy frissítése a Monitor REST API-ban

Kérelem

PUT
https://management.azure.com/{resource-id}/providers/microsoft.insights/diagnosticSettings/service?api-version={api-version}

Headers

  • Csere erre {api-version} : 2016-09-01.
  • Cserélje le {resource-id} annak az erőforrásnak az azonosítójára, amelyhez módosítani szeretné a diagnosztikai beállításokat. További információk: Erőforráscsoportok használata az Azure-erőforrások kezeléséhez.
  • Állítsa a Content-Type fejlécet application/jsonértékre.
  • Állítsa be az engedélyezési fejlécet a Microsoft Entra ID által adott JSON webes jogkivonatra. További információ: Kérelmek hitelesítése.

Body

{
    "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": ""
}
Ingatlan Típus Leírás
storageAccountId Lánc Annak a tárfióknak az erőforrás-azonosítója, ahová diagnosztikai naplókat szeretne küldeni.
serviceBusRuleId Lánc Annak a service-bus névtérnek az azonosítója, amelyben eseményközpontokat szeretne létrehozni diagnosztikai naplók streameléséhez. A szabályazonosító formátuma {service bus resource ID}/authorizationrules/{key name}.
workspaceId Lánc Annak a munkaterületnek a munkaterület-azonosítója, ahol a naplók mentésre kerülnek.
metrics A meghívott adatfolyamatnak átadandó folyamatparaméter-értékek Egy JSON-objektum, amely paraméterneveket képez le argumentumértékekbe.
logs Összetett típus Egy erőforrástípus diagnosztikai naplókategória neve. Egy erőforrás diagnosztikai naplókategóriáinak listájának lekéréséhez hajtsa végre a GET diagnosztikai beállításokat.
kategória Lánc Naplókategóriák és adatmegőrzési szabályzatok tömbje.
timeGrain Lánc Az ISO 8601 időtartamformátumban rögzített metrikák részletessége. A tulajdonságértéknek egy percnek kell lennie PT1M.
enabled logikai Megadja, hogy a metrika vagy a naplókategória gyűjtése engedélyezve van-e ehhez az erőforráshoz.
megtartásiPolitika Összetett típus Egy metrika vagy naplókategória adatmegőrzési szabályzatát ismerteti. Ez a tulajdonság csak tárfiókokhoz használható.
days Int A metrikák vagy naplók megőrzéséhez használt napok száma. Ha a tulajdonság értéke 0, a naplók örökre megmaradnak. Ez a tulajdonság csak tárfiókokhoz használható.

Válasz

200 OK.

{
    "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
}

Információk a diagnosztikai beállításokról a Monitor REST API-ban

Kérelem

GET
https://management.azure.com/{resource-id}/providers/microsoft.insights/diagnosticSettings/service?api-version={api-version}

Headers

  • Csere erre {api-version} : 2016-09-01.
  • Cserélje le {resource-id} annak az erőforrásnak az azonosítójára, amelyhez módosítani szeretné a diagnosztikai beállításokat. További információk: Erőforráscsoportok használata az Azure-erőforrások kezeléséhez.
  • Állítsa a Content-Type fejlécet application/jsonértékre.
  • Állítsa be az engedélyezési fejlécet egy JSON webtokenre, amelyet a Microsoft Entra Identitásból kapott. További információ: Kérelmek hitelesítése.

Válasz

200 OK.

{
    "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
}

További információ: Diagnosztikai beállítások.

Kapcsolódó tartalom

SSIS-műveletek monitorozása az Azure Monitorral

  • Last updated on