Adatgyűjtési szabályok (DCR-ek) létrehozása az Azure Monitorban

Az Azure Monitorban több módszer is létezik adatgyűjtési szabály (DCR) létrehozására. Bizonyos esetekben az Azure Monitor az Azure Portalon konfigurált beállításoknak megfelelően hozza létre és kezeli a DCR-t. Előfordulhat, hogy néhány ilyen esetben még azt sem tudja, hogy DCR-sel dolgozik. Más forgatókönyvek esetén azonban előfordulhat, hogy létre kell hoznia saját DCR-eket, vagy szerkesztenie kell a meglévőket a definíciójuk JSON-ban való közvetlen használatával. Ez a cikk ismerteti a DCR létrehozásának különböző módszereit, valamint a szerkesztéssel és hibaelhárítással kapcsolatos javaslatokat.

Megjegyzés:

Ez a cikk azt ismerteti, hogyan hozhatja létre és szerkesztheti magát a DCR-t. Adatgyűjtési szabálytársítások létrehozásához és szerkesztéséhez lásd : Adatgyűjtési szabálytársítások létrehozása és kezelése.

Engedélyek

DcRs- és DCR-társítások létrehozásához a következő engedélyek szükségesek:

Beépített szerepkör	Hatókörök	Indok
Figyelési közreműködő	Előfizetés és/vagy Erőforráscsoport és/vagy Meglévő DCR	DCR-ek létrehozása vagy szerkesztése, szabályok hozzárendelése a géphez, társítások üzembe helyezése.
Virtuális gépek közreműködője Azure-beli csatlakoztatott gép erőforrás-rendszergazdája	Virtuális gépek, virtuális gép méretezési csoportok Azure Arc-kompatibilis kiszolgálók	Ügynökbővítmények üzembe helyezése a virtuális gépen.
Minden olyan szerepkör, amely tartalmazza a Microsoft.Resources/deployments/ műveletet *	Előfizetés és/vagy Erőforráscsoport és/vagy Meglévő DCR	Azure Resource Manager-sablonok üzembe helyezése.

Fontos

Hozza létre a DCR-t ugyanabban a régióban, mint a cél naplóelemzési munkaterület vagy az Azure Monitor-munkaterület. A DCR-t társíthatja a bérlő bármely előfizetéséből vagy erőforráscsoportjából származó gépekhez vagy tárolókhoz. Ahhoz, hogy adatokat küldjön a bérlők között, először engedélyeznie kell az Azure Lighthouse-t.

DCR létrehozása vagy szerkesztése az Azure Portal használatával

Az Azure Portal egyszerűsített felületet biztosít a DCR meghatározott forgatókönyvekhez való létrehozásához. Ezzel a módszerrel nem kell tisztában lennie a DCR szerkezetével, bár előfordulhat, hogy korlátozott a végrehajtható konfigurációban, és később módosítania kell a DCR-definíciót egy speciális funkció, például az átalakítás implementálásához. A felhasználói élmény az egyes forgatókönyvek esetében eltérő lesz, ezért tekintse meg az adott forgatókönyv dokumentációját az alábbi táblázatban leírtak szerint.

Forgatókönyv	Leírás
VM-elemzések engedélyezése	Ha engedélyezi a VM Insights szolgáltatást egy virtuális gépen, a rendszer telepíti az Azure Monitor-ügynököt, és létrehoz egy DCR-t, és társítja a virtuális géphez. Ez a DCR előre definiált teljesítményszámlálókat gyűjt, és nem szabad módosítani. Lásd: Virtuálisgép-elemzések engedélyezése.
Ügyféladatok gyűjtése virtuális gépről	Hozzon létre egy DCR-t az Azure Portalon egy irányított felületen a virtuális gép ügyfél operációs rendszeréből származó különböző adatforrások kiválasztásához. Ilyenek például a Windows-események, a Syslog-események és a szöveges naplók. Az Azure Monitor-ügynök szükség esetén automatikusan települ, és létrejön egy társítás a DCR és az egyes kiválasztott virtuális gépek között. Lásd: Adatok gyűjtése az Azure Monitor-ügynökkel.
Metrikák exportálása	Hozzon létre egy DCR-t az Azure Portalon egy interaktív felületen a különböző gyűjtendő erőforrástípusok metrikáinak kiválasztásához. Társítás jön létre a DCR és az egyes kiválasztott erőforrások között. Lásd: Adatgyűjtési szabály (DCR) létrehozása a metrikák exportálásához.
Tábla létrehozása	Amikor új táblát hoz létre egy Log Analytics-munkaterületen az Azure Portal használatával, olyan mintaadatokat tölt fel, amelyeket az Azure Monitor egy DCR létrehozásához használ, beleértve egy átalakítást is, amely a Logs Ingestion API-val használható. Ezt a DCR-t nem módosíthatja az Azure Portalon, de a cikkben ismertetett módszerek bármelyikével módosíthatja. Lásd: Egyéni tábla létrehozása.
Kubernetes monitorozása	A Kubernetes-fürtök monitorozásához engedélyeznie kell a Container Insightst a naplókhoz és a Prometheust a metrikákhoz. Az egyes elemekhez létrejön egy DCR, amely a fürtben található Azure Monitor ügynök konténeres verziójához van társítva. Előfordulhat, hogy átalakítás hozzáadásához módosítania kell a Container Insights DCR-t. Lásd: Monitorozás engedélyezése Kubernetes-fürtök számára és Adatátalakítások a Container Insightsban.
Munkaterület-átalakítás – DCR	A munkaterület-átalakítási DCR-ek olyan átalakításokat biztosítanak adatgyűjtési forgatókönyvekhez, amelyek még nem használnak DCR-eket. Ezt a DCR-t az Azure Portallal hozhatja létre egy adott tábla átalakításához. Lásd: Munkaterület-átalakítási DCR létrehozása.

DCR létrehozása vagy szerkesztése A JSON használatával

A meglévő DCR szerkesztése mellett létrehozhat egy újat a minta DCRS-ek egyikével, amely több gyakori forgatókönyvhöz is biztosítja a JSON-t. Az Azure Monitor adatgyűjtési szabályának struktúrájában található információk segítségével módosíthatja az adott környezethez és követelményekhez tartozó JSON-fájlt.

Figyelmeztetés

Ha egy meglévő adatgyűjtési szabályt (DCR-t) szerkeszt az Azure Portal használatával, az felülírja a DCR JSON-jának közvetlen szerkesztésével végrehajtott módosításokat, ha ezek a funkciók nem támogatottak a portálon. Ha például olyan adatforráshoz ad hozzá átalakítást egy DCR-hez, amely nem teszi lehetővé az átalakítás létrehozását a portálon, akkor az átalakítás el lesz távolítva, ha később szerkessze a DCR-t a portálon. Ebben az esetben a JSON közvetlen szerkesztésével a DCR-t továbbra is módosítania kell.

Miután meghatározta a DCR definícióját, üzembe helyezheti az Azure Monitorban az Azure Portalon, parancssor, PowerShell, API vagy ARM-sablonok használatával.

Jótanács

A DCR JSON-definíciójának megtekintéséhez lásd: DCR-definíció megtekintése.

CLI
PowerShell
API
ARM & Bicepsz-sablonok

DCR létrehozása vagy szerkesztése parancssori felülettel

Az az monitor adatgyűjtési szabály létrehozása parancsával hozzon létre egy DCR-t a saját JSON-fájljából. Ugyanezzel a paranccsal frissíthet egy meglévő DCR-t.

az monitor data-collection rule create --location 'eastus' --resource-group 'my-resource-group' --name 'my-dcr' --rule-file 'C:\MyNewDCR.json' --description 'This is my new DCR'

DCR létrehozása vagy szerkesztése a PowerShell-lel

A New-AzDataCollectionRule parancsmaggal hozzon létre egy DCR-t a JSON-fájlból. Ugyanezzel a paranccsal frissíthet egy meglévő DCR-t.

New-AzDataCollectionRule -Name 'my-dcr' -ResourceGroupName 'my-resource-group' -JsonFilePath 'C:\MyNewDCR.json'

DCR létrehozása vagy szerkesztése API-val

A DCR create API használatával hozza létre a DCR-t a JSON-fájlból. Bármilyen módszerrel meghívhat REST API-t az alábbi példákban látható módon. Ugyanezekkel a parancsokkal frissíthet egy meglévő DCR-t.

$ResourceId = "/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
$FilePath = ".\my-dcr.json"
$DCRContent = Get-Content $FilePath -Raw 
Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method PUT -Payload $DCRContent

ResourceId="/subscriptions/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
FilePath="my-dcr.json"
az rest --method put --url $ResourceId"?api-version=2022-06-01" --body @$FilePath

Az alábbi sablonokkal hozzon létre egy DCR-t, és cserélje le a <dcr-properties>-t a DCR tulajdonságaival. Ezzel a sablonnal létrehozhat egy új DCR-t, vagy frissíthet egy meglévőt.

ARM (JSON)

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "type": "string",
            "metadata": {
                "description": "Specifies the name of the Data Collection Rule to create."
            }
        },
        "location": {
            "type": "string",
            "metadata": {
                "description": "Specifies the location in which to create the Data Collection Rule."
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "apiVersion": "2024-03-11",
            "properties": {
                "<dcr-properties>"
            }
        }
    ]
}

Bicepsz

@description('Specifies the name of the Data Collection Rule to create.')
param dataCollectionRuleName string

@description('Specifies the location in which to create the Data Collection Rule.')
param location string

resource dataCollectionRule 'Microsoft.Insights/dataCollectionRules@2024-03-11' = {
    name: dataCollectionRuleName
    location: location
    properties: {
        <dcr-properties>
    }
}

Megjegyzés:

Bár dönthet úgy, hogy a PowerShell- vagy CLI-parancsokkal hoz létre és szerkeszt egy DCR-t, az API- és ARM-metódusok részletesebb hibaüzeneteket nyújtanak fordítási hibák esetén.

A következő példában a DCR egy olyan táblanevet határoz meg, amely nem létezik a cél Log Analytics-munkaterületen. A PowerShell-parancs egy általános hibaüzenetet ad vissza, de az API-hívás egy részletes hibaüzenetet ad vissza, amely megadja a pontos hibát.

A DCR szerkesztésére és tesztelésére irányuló stratégiák

Amikor létrehoz vagy szerkeszt egy DCR-t annak JSON-definíciójával, gyakran több frissítést kell végrehajtania a kívánt funkció eléréséhez. Hatékony módszerre van szüksége a DCR frissítéséhez, hibaelhárításához, ha nem kapja meg a várt eredményeket, majd további frissítéseket végezhet. Ez különösen igaz, ha átalakítást ad hozzá a DCR-hez, mivel ellenőriznie kell, hogy a lekérdezés a várt módon működik-e. Mivel közvetlenül az Azure Portalon nem szerkesztheti a JSON-t, az alábbi stratégiákat használhatja.

Helyi fájl használata A DCR forrásaként

Ha helyi JSON-fájlt használ a létrehozott és szerkesztett DCR-ek forrásaként, biztos lehet benne, hogy mindig hozzáfér a DCR-definíció legújabb verziójához. Ez akkor ideális, ha olyan verziókövetési eszközöket szeretne használni, mint a GitHub vagy az Azure DevOps a módosítások kezeléséhez. Egy szerkesztő, például a VS Code használatával is módosíthatja a DCR-t, majd parancssori eszközökkel frissítheti a DCR-t az Azure Monitorban a fent leírtak szerint.

Az alábbiakban egy powerShell-példaszkriptet követünk, a segítségével leküldheti a módosításokat egy DCR-be egy forrásfájlból. Ez ellenőrzi, hogy a forrásfájl érvényes JSON-e, mielőtt elküldené azt az Azure Monitornak.

param (
    [Parameter(Mandatory = $true)][string]$ResourceId,  # Resource ID of the DCR
    [Parameter(Mandatory = $true)][string]$FilePath  # Path to the DCR JSON file to upload
)

# Read the DCR content from the file
Write-Host "Reading new DCR content from: $FilePath" -ForegroundColor Green
$DCRContent = Get-Content $FilePath -Raw

# Ensure the DCR content is valid JSON
try {
    $ParsedDCRContent = $DCRContent | ConvertFrom-Json
} catch {
    Write-Host "Invalid JSON content in file: $FilePath" -ForegroundColor Red
    exit 1
}

# Create or update the DCR in the specified resource group
Write-Host "Deploying DCR $ResourceId ..." -ForegroundColor Green
Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2023-03-11") -Method PUT -Payload $DCRContent

DCR-tartalom mentése ideiglenes fájlba

Ha nem rendelkezik a DCR-definícióval egy helyi fájlban, lekérheti a definíciót az Azure Monitorból, és mentheti egy ideiglenes fájlba. Ezután szerkesztheti a fájlt egy szerkesztővel, például a VS Code-tal, mielőtt a frissítéseket az Azure Monitorba küldené.

Az alábbiakban egy powerShell-példaszkriptet láthat, a segítségével szerkesztheti egy meglévő DCR-t az Azure Monitorban. A szkript lekéri a DCR-definíciót, és menti egy ideiglenes fájlba a VS Code elindítása előtt. Miután jelezte a szkriptnek, hogy mentette a módosításokat, a rendszer frissíti a DCR-t az új tartalommal, és törli az ideiglenes fájlt.

param ([Parameter(Mandatory=$true)] $ResourceId)

# Get DCR content and save it to a local file
$FilePath = "temp.dcr"
$DCR = Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2023-03-11") -Method GET
$DCR.Content | ConvertFrom-Json | ConvertTo-Json -Depth 20 | Out-File $FilePath

# Open DCR in code editor
code $FilePath | Wait-Process

{ 
	#write DCR content back from the file
	$DCRContent = Get-Content $FilePath -Raw
	Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2023-03-11") -Method PUT -Payload $DCRContent		
}

#Delete temporary file
Remove-Item $FilePath

ARM-sablon használata a DCR helyben történő szerkesztéséhez

Ha teljesen el szeretné végezni a módosításokat az Azure Portalon, az Exportálás sablon funkcióval lekérheti egy DCR ARM-sablonját. Ezután módosíthatja a definíciót a JSON-ban, és újra üzembe helyezheti az Azure Portalon.

Válassza ki a módosítani kívánt DCR-t az Azure Portalon, és válassza az Exportálás sablon lehetőséget. Ezután kattintson az Üzembe helyezés gombra ugyanazon sablon ismételt üzembe helyezéséhez.
Kattintson a Sablon szerkesztése gombra a JSON szerkeszthető verziójának megnyitásához a DCR-hez. Ne módosítsa a paraméterértékeket.
Végezze el a szükséges módosításokat a DCR-ben, majd kattintson a Mentés gombra.
Ha új DCR-t szeretne létrehozni, módosítsa a névparamétert. Ellenkező esetben hagyja változatlanul a paramétereket. Kattintson a Véleményezés + létrehozás gombra a módosított sablon üzembe helyezéséhez, és a Létrehozás gombra az új DCR létrehozásához.
Ha a DCR hiba nélkül érvényes, az üzembe helyezés sikeres lesz, és a DCR frissül az új konfigurációval. Kattintson a Erőforrás megnyitása gombra a módosított DCR megnyitásához.
Ha a DCR fordítási hibái vannak, akkor egy üzenet jelenik meg arról, hogy az üzembe helyezés meghiúsult. A hiba részleteinek megtekintéséhez kattintson a Hiba részletei és a Művelet részletei elemre. Kattintson az Újratelepítés gombra, majd ismét az Sablont szerkesztéshez a DCR szükséges módosításainak elvégzéséhez, majd mentse el, és telepítse újra.

Adatgyűjtés ellenőrzése és hibaelhárítása

A DCR telepítése után eltarthat néhány percig, amíg a módosítások érvénybe lépnek, és adatokat gyűjtenek a frissített DCR-vel. Ha nem látja az összegyűjtött adatokat, használja a DCR monitorozási funkcióit, amelyek metrikákat és naplókat tartalmaznak a hibaelhárításhoz.

A DCR-metrikákat a rendszer automatikusan összegyűjti az összes DCR-hez, és elemezheti őket a Metrics Explorerrel, például a többi Azure-erőforrás platformmetrikáival. Engedélyezze a DCR hibanaplókat a részletes hibainformációk megszerzéséhez, ha az adatfeldolgozás nem sikerül.

Ellenőrizze a Logs Ingestion Bytes per Min és Logs Rows Received per Min metrikákat, hogy megbizonyosodjon arról, az adatok elérik az Azure Monitort. Ha nem, ellenőrizze az adatforrást, hogy a várt módon küldi-e el az adatokat.
Ellenőrizze Logs Rows Dropped per Min , hogy vannak-e eldobott sorok. Ez nem feltétlenül jelez hibát, mivel egy transzformáció elvetheti a sorokat. Ha az elvetett sorok megegyeznek Logs Rows Dropped per Min , akkor a munkaterületen nem történik adatbetöltés. Vizsgálja meg, Logs Transformation Errors per Min hogy vannak-e átalakítási hibák.
Ellenőrizze Logs Transformation Errors per Min , hogy vannak-e hibák a bejövő adatokra alkalmazott átalakítások során. Ennek oka lehet az adatstruktúra változásai vagy maga az átalakítás.
Ellenőrizze a DCRLogErrors táblában az esetlegesen naplózott betöltési hibákat. Ez további részleteket nyújthat a probléma kiváltó okának azonosításához.

Következő lépések

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-01-20