Diagnosztikai beállítások létrehozása az Azure Monitorban

Diagnosztikai beállítások létrehozása és szerkesztése az Azure Monitorban az Azure Platform metrikáinak és naplóinak különböző helyekre, például az Azure Monitor-naplókba, az Azure Storage-ba vagy az Azure Event Hubsba való küldéséhez. A diagnosztikai beállításokkal különböző módszereket használhat, például az Azure Portalt, az Azure CLI-t, a PowerShellt és az Azure Resource Managert.

Fontos

A diagnosztikai beállításokban beállított adatmegőrzési szabályzat elavult, és már nem használható. Az Azure Storage életciklus-szabályzatával kezelheti a naplók megőrzésének időtartamát. További információ: Diagnosztikai beállítások tárolási megőrzésének migrálása az Azure Storage életciklus-felügyeletére

Azure Portalra

A diagnosztikai beállításokat az Azure Portalon az Azure Monitor menüből vagy az erőforrás menüjéből konfigurálhatja.

1. Az erőforrástól függ, hogy hol konfigurálja a diagnosztikai beállításokat az Azure Portalon:

   • Egyetlen erőforrás esetében válassza a Diagnosztikai beállítások lehetőségetaz erőforrás menüjének Figyelés területén.

     

   • Egy vagy több erőforrás esetében válassza az Azure Monitor menü Gépház alatti diagnosztikai beállításokat, majd válassza ki az erőforrást.

     

   • A tevékenységnaplóhoz válassza a Tevékenységnapló lehetőséget az Azure Monitor menüben, majd válassza az Export Activity Logs (Tevékenységnaplók exportálása) lehetőséget. Győződjön meg arról, hogy letiltja a tevékenységnapló örökölt konfigurációját. Útmutatásért tekintse meg a meglévő beállítások letiltása című témakört.

     

2. Ha nincs beállítás a kiválasztott erőforráson, a rendszer kérni fogja, hogy hozzon létre egy beállítást. Válassza a Diagnosztikai beállítások megadása lehetőséget.

   

   Ha az erőforráson már vannak beállítások, megjelenik a már konfigurált beállítások listája. Új beállítás hozzáadásához válassza a Diagnosztikai beállítás hozzáadása lehetőséget. Vagy válassza a Szerkesztés beállítást egy meglévő szerkesztéséhez. Minden beállítás legfeljebb egy céltípussal rendelkezhet.

   

3. Adjon nevet a beállításnak, ha még nem rendelkezik ilyen beállítással.

   

4. Naplók és metrikák az útvonalhoz: Naplók esetén válasszon egy kategóriacsoportot, vagy jelölje be az egyes adatkategóriákra vonatkozó jelölőnégyzeteket, amelyeket később a megadott célhelyekre szeretne küldeni. A kategóriák listája minden Azure-szolgáltatás esetében eltérő. Válassza az AllMetrics lehetőséget, ha metrikákat is szeretne tárolni az Azure Monitor-naplókban.

5. Céladatok: Jelölje be az egyes célhelyek jelölőnégyzetét. A beállítások úgy jelennek meg, hogy további információkat is hozzáadhat.

   

   1. Küldés a Log Analytics-munkaterületre: Válassza ki az előfizetését és azt a Log Analytics-munkaterületet, ahová az adatokat el szeretné küldeni. Ha nincs munkaterülete, a folytatás előtt létre kell hoznia egyet.

   2. Archiválás tárfiókba: Válassza ki az előfizetését és azt a tárfiókot, ahol tárolni szeretné az adatokat.

      

      Tipp.

      Az Azure Storage életciklus-szabályzatával kezelheti a naplók megőrzésének időtartamát. A diagnosztikai beállításokban beállított adatmegőrzési szabályzat elavult.

   3. Streamelés eseményközpontba: Adja meg a következő feltételeket:

      • Előfizetés: Az az előfizetés, amelybe az eseményközpont tartozik.
      • Eseményközpont névtere: Ha nem rendelkezik ilyen névtérrel, létre kell hoznia egyet.
      • Eseményközpont neve (nem kötelező):: Az összes adat elküldéséhez használt név. Ha nem ad meg nevet, minden naplókategóriához létrejön egy eseményközpont. Ha több kategóriába küld, érdemes lehet megadnia egy nevet a létrehozott eseményközpontok számának korlátozásához. További információkért tekintse meg az Azure Event Hubs kvótáit és korlátait.
      • Event Hub-szabályzat neve (nem kötelező): A szabályzat határozza meg a streamelési mechanizmus engedélyeit. További információkért tekintse meg az Event Hubs funkcióit.

   4. Küldés partnermegoldásnak: Először telepítenie kell az Azure Native ISV-szolgáltatásokat az előfizetésébe. A konfigurációs lehetőségek partnerenként eltérőek. További információkért tekintse meg az Azure Native ISV Services áttekintését.

6. Ha a szolgáltatás támogatja az erőforrás-specifikus és az Azure diagnosztikai módot is, akkor a céltábla kiválasztásakor megjelenik egy lehetőség, amikor a Log Analytics-munkaterületet választja célhelyként. Általában az Erőforrás-specifikus lehetőséget kell választania, mivel a táblastruktúra nagyobb rugalmasságot és hatékonyabb lekérdezéseket tesz lehetővé.

   

7. Válassza a Mentés lehetőséget.

Néhány pillanat múlva az új beállítás megjelenik az erőforrás beállításainak listájában. A naplók az új eseményadatok létrehozásakor a megadott célhelyekre lesznek streamelve. Az esemény kibocsátása és a Log Analytics-munkaterületen való megjelenése között akár 15 percet is igénybe vehet.

PowerShell

A New-AzDiagnosticSetting parancsmaggal diagnosztikai beállítást hozhat létre az Azure PowerShell használatával. A paraméterek leírását a parancsmag dokumentációjában találja.

Fontos

Ezt a módszert nem használhatja tevékenységnaplókhoz. Ehelyett használja a Diagnosztikai beállítás létrehozása az Azure Monitorban egy Azure Resource Manager-sablon használatával egy Resource Manager-sablon létrehozásához és PowerShell-lel való üzembe helyezéséhez.

Az alábbi példa PowerShell-parancsmag diagnosztikai beállítást hoz létre az összes naplóhoz, vagy naplókhoz és metrikákhoz egy kulcstartóhoz a Log Analytics-munkaterület használatával.

$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

Parancssori felület

Az az monitor diagnosztikai beállítások létrehozási parancsával hozzon létre diagnosztikai beállítást az Azure CLI-vel. A parancs paramétereinek leírását a parancs dokumentációjában találja.

Fontos

Ezt a módszert nem használhatja tevékenységnaplókhoz. Ehelyett használja a Diagnosztikai beállítás létrehozása az Azure Monitorban Resource Manager-sablonnal egy Resource Manager-sablon létrehozásához és az Azure CLI-vel való üzembe helyezéséhez.

Az alábbi példaparancs mind a három célhely használatával létrehoz egy diagnosztikai beállítást. A szintaxis az ügyféltől függően kissé eltérő.

Ha erőforrás-specifikus módot szeretne megadni, ha a szolgáltatás támogatja, adja hozzá a export-to-resource-specific paramétert .' értékkeltrue.

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

Az alábbi JSON-sablon egy diagnosztikai beállítás létrehozásához nyújt példát, amely az összes naplót egy log analytics-munkaterületre küldi. Ne feledje, hogy a apiVersion hatókörben lévő erőforrástól függően változhat.

Sablonfájl

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

Paraméterfájl

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

Ha diagnosztikai beállításokat szeretne létrehozni vagy frissíteni az Azure Monitor REST API használatával, tekintse meg a diagnosztikai beállításokat.

Azure Policy

A diagnosztikai beállítások nagy léptékű létrehozására szolgáló Azure Policy használatával kapcsolatos részletekért lásd : Diagnosztikai beállítások létrehozása nagy méretekben az Azure Policy használatával.

Hibaelhárítás

Íme néhány hibaelhárítási tipp.

A metrikakategória nem támogatott

Diagnosztikai beállítás telepítésekor a következőhöz hasonló hibaüzenet jelenik meg: "Az xxxx metrikakategória nem támogatott". Ez a hiba akkor is előfordulhat, ha az előző üzembe helyezés sikeres volt.

A probléma akkor fordul elő, ha Resource Manager-sablont, REST API-t, parancssori felületet vagy Azure PowerShellt használ. Az Azure Portalon létrehozott diagnosztikai beállításokra nincs hatással, mert csak a támogatott kategórianevek jelennek meg.

A probléma a mögöttes API legutóbbi változása miatt jelentkezik. Az AllMetricstól eltérő metrikakategóriák nem támogatottak, és csak néhány konkrét Azure-szolgáltatásra vonatkoznak. Korábban a rendszer figyelmen kívül hagyta a többi kategórianevet egy diagnosztikai beállítás üzembe helyezésekor. Az Azure Monitor háttérrendszere átirányította ezeket a kategóriákat az AllMetricsbe. 2021 februárjától a háttérrendszer frissült, hogy kifejezetten ellenőrizze, hogy a megadott metrikakategória pontos-e. Ez a módosítás néhány üzembe helyezés meghiúsulását okozhatja.

Ha ezt a hibát kapja, frissítse az üzemelő példányokat, hogy a metrikakategóriák neveit az AllMetricsre cserélje le a probléma megoldásához. Ha az üzembe helyezés korábban több kategóriát adott hozzá, csak egyet tartson meg az AllMetrics-hivatkozással . Ha továbbra is fennáll a probléma, lépjen kapcsolatba Azure-támogatás az Azure Portalon.

A beállítás nem ASCII-karakterek miatt eltűnik a resourceID-ben

A diagnosztikai beállítások nem támogatják a nem ASCII-karaktereket tartalmazó erőforrás-azonosítókat. Vegyük például a "Preproducción" kifejezést. Mivel az Azure-ban nem lehet átnevezni az erőforrásokat, az egyetlen lehetőség egy új erőforrás létrehozása nem ASCII karakterek nélkül. Ha a karakterek erőforráscsoportban vannak, áthelyezheti az alatta lévő erőforrásokat egy újba. Ellenkező esetben újra létre kell hoznia az erőforrást.

Duplikált vagy elvetett adatok lehetősége

Minden erőfeszítést megteszünk annak érdekében, hogy minden naplóadat megfelelően legyen elküldve a célhelyekre, de nem garantálható a naplók 100%-os adatátvitele a végpontok között. Újrapróbálkozások és egyéb mechanizmusok állnak a probléma megoldására, és megpróbálják biztosítani, hogy a naplóadatok a végpontra érkezzenek.

Következő lépések

• Tekintse át, hogyan használható a diagnosztikai beállítások az Azure Monitorban
• Diagnosztikai beállítások tárolási megőrzésének migrálása az Azure Storage életciklus-felügyeletére
• További információ az Azure platformnaplóiról