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 megfelelő 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 napos megőrzés azt jelenti, hogy a naplók örökre meg lesznek őrizve. 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}
Fejlécek
- Cserélje le a
{api-version}
elemet a2016-09-01
kérdésre. - 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 be a
Content-Type
fejlécet a következőreapplication/json
: . - Állítsa be az engedélyezési fejlécet a Microsoft Entra-azonosítóból kapott JSON webes jogkivonatra. További információ: Kérelmek hitelesítése.
Törzs
{
"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": ""
}
Tulajdonság | Type | Description |
---|---|---|
storageAccountId | Sztring | Annak a tárfióknak az erőforrás-azonosítója, ahová diagnosztikai naplókat szeretne küldeni. |
serviceBusRuleId | Sztring | Annak a service-bus névtérnek a service-bus szabályazonosítója, amelyben eseményközpontokat szeretne létrehozni a streamelési diagnosztikai naplókhoz. A szabályazonosító formátuma {service bus resource ID}/authorizationrules/{key name} . |
workspaceId | Sztring | Annak a munkaterületnek a munkaterület-azonosítója, ahol a naplók mentésre kerülnek. |
metrics | A meghívott folyamatnak átadni kívánt folyamat paraméterértékei | Egy JSON-objektum, amely paraméterneveket képez le argumentumértékekbe. |
Naplók | Ö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 | Sztring | Naplókategóriák és adatmegőrzési szabályzatok tömbje. |
timeGrain | Sztring | Az ISO 8601 időtartamformátumban rögzített metrikák részletessége. A tulajdonságértéknek egy percnek kell lennie PT1M . |
Engedélyezve | Logikai | Megadja, hogy a metrika vagy a naplókategória gyűjtése engedélyezve van-e ehhez az erőforráshoz. |
retentionPolicy | Ö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ó. |
Nap | 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ó. |
Response
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}
Fejlécek
- Cserélje le a
{api-version}
elemet a2016-09-01
kérdésre. - 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 be a
Content-Type
fejlécet a következőreapplication/json
: . - Állítsa be az engedélyezési fejlécet egy JSON webes jogkivonatra, amelyet a Microsoft Entra-azonosítóból kapott. További információ: Kérelmek hitelesítése.
Response
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: