Táblák és oszlopok hozzáadása és törlése az Azure Monitor-naplókban

Az adatgyűjtési szabályok lehetővé teszik a naplóadatok szűrését és átalakítását, mielőtt az adatokat egy Azure-táblába vagy egy egyéni táblába küldené. Ez a cikk bemutatja, hogyan hozhat létre egyéni táblákat, és hogyan adhat hozzá egyéni oszlopokat a Log Analytics-munkaterület tábláihoz.

Fontos

Amikor frissít egy táblázatsémát, mindenképpen frissítsen minden olyan adatgyűjtési szabályt , amely adatokat küld a táblának. Az adatgyűjtési szabályban definiált táblaséma határozza meg, hogy az Azure Monitor hogyan streameli az adatokat a céltáblába. Az Azure Monitor nem frissíti automatikusan az adatgyűjtési szabályokat a táblaséma módosításakor.

Előfeltételek

Egyéni tábla létrehozásához a következőkre van szükség:

• Log Analytics-munkaterület, ahol legalább közreműködői jogosultságokkal rendelkezik.

• Adatgyűjtési végpont (DCE).

• Egy JSON-fájl, amely legalább egy mintarekordot tartalmaz az egyéni táblához. Ez a következőképpen fog kinézni:

  [
    {
      "TimeGenerated": "supported_datetime_format",
      "<column_name_1>": "<column_name_1_value>",
      "<column_name_2>": "<column_name_2_value>"
    },
    {
      "TimeGenerated": "supported_datetime_format",
      "<column_name_1>": "<column_name_1_value>",
      "<column_name_2>": "<column_name_2_value>"
    },
    {
      "TimeGenerated": "supported_datetime_format",
      "<column_name_1>": "<column_name_1_value>",
      "<column_name_2>": "<column_name_2_value>"
    }
  ]
  

  A Log Analytics-munkaterület összes táblájának tartalmaznia kell egy oszlopot.TimeGenerated Ha a mintaadatoknak van egy elnevezett oszlopa TimeGenerated, akkor a rendszer ezt az értéket használja a rekord betöltési idejének azonosítására. Ha nem, a rendszer hozzáad egy oszlopot TimeGenerated az átalakításhoz a DCR-ben a táblához. A formátummal kapcsolatos információkért lásd a TimeGenerated támogatott dátum/idő formátumokat.

Egyéni tábla létrehozása

Az Azure-táblák előre definiált sémákkal rendelkeznek. Ha a naplóadatokat egy másik sémában szeretné tárolni, adatgyűjtési szabályokkal határozhatja meg, hogyan gyűjtheti, alakíthatja át és küldheti el az adatokat egy egyéni táblába a Log Analytics-munkaterületen.

Fontos

Az egyéni táblák _CL utótagokkal rendelkeznek, például tablename_CL. Az Azure Portal automatikusan hozzáadja a _CL utótagot a tábla nevéhez. Ha egy másik módszerrel hoz létre egyéni táblázatot, hozzá kell adnia a _CL utótagot. Az adatfolyamok tablename_CLadatfolyamok az adatgyűjtési szabályok tulajdonságainak meg kell egyeznie a Log Analytics-munkaterület tablename_CL nevével.

Feljegyzés

Az elavult Log Analytics-ügynökkel(más néven MMA-val vagy OMS-sel) betöltött naplókhoz tartozó egyéni táblák létrehozásáról a Log Analytics-ügynökkel végzett szöveges naplók gyűjtése című témakörben olvashat.

Portál

Egyéni tábla létrehozása az Azure Portalon:

1. A Log Analytics-munkaterületek menüben válassza a Táblák lehetőséget.

   

2. Válassza a Létrehozás , majd az Új egyéni napló (DCR-alapú) lehetőséget.

   

3. Adja meg a tábla nevét és leírását. Nem kell hozzáadnia a _CL utótagot az egyéni tábla nevéhez – ez automatikusan hozzáadódik a portálon megadott névhez.

4. Válasszon ki egy meglévő adatgyűjtési szabályt az adatgyűjtési szabály legördülő listájából, vagy válassza az Új adatgyűjtési szabály létrehozása lehetőséget, és adja meg az előfizetést, az erőforráscsoportot és az új adatgyűjtési szabály nevét.

   

5. Válasszon ki egy adatgyűjtési végpontot, és válassza a Tovább gombot.

   

6. Válassza a Tallózás a fájlok között lehetőséget, és keresse meg az új tábla mintaadatait tartalmazó JSON-fájlt.

   

   Ha a mintaadatok nem tartalmaznak oszlopot TimeGenerated , akkor egy üzenet jelenik meg arról, hogy átalakítás jön létre ezzel az oszlopmal.

7. Ha a táblázatba való betöltés előtt át szeretné alakítani a naplóadatokat:

   1. Válassza az Átalakítási szerkesztő lehetőséget.

      Az átalakítási szerkesztővel átalakítást hozhat létre a bejövő adatfolyamhoz. Ez egy KQL-lekérdezés, amely minden bejövő rekordon fut. Az Azure Monitor-naplók a lekérdezés eredményeit a céltáblában tárolják.

      

   2. Az eredmények megtekintéséhez válassza a Futtatás lehetőséget.

      

8. Az Alkalmazás gombra kattintva mentheti az átalakítást, és megtekintheti a létrehozni kívánt tábla sémáját. A folytatáshoz válassza a Tovább gombot.

   

9. Ellenőrizze a végleges részleteket, és válassza a Létrehozás lehetőséget az egyéni napló mentéséhez.

   

API

Egyéni tábla létrehozásához hívja meg a Táblák – Létrehozás vagy frissítés API-t.

Parancssori felület

Egyéni tábla létrehozásához futtassa az az monitor log-analytics-munkaterület tábla létrehozási parancsát.

PowerShell

A Táblák – PATCH API frissítése egyéni táblázat létrehozásához az alábbi PowerShell-kóddal. Ez a kód létrehoz egy MyTable_CL nevű táblát két oszlopból. Módosítsa ezt a sémát egy másik tábla gyűjtéséhez.

1. Válassza a Cloud Shell gombot az Azure Portalon, és győződjön meg arról, hogy a környezet PowerShellre van állítva.

   

2. Másolja ki a következő PowerShell-kódot, és cserélje le az Elérési út paramétert a munkaterület megfelelő értékeire a Invoke-AzRestMethod parancsban. Illessze be a Cloud Shell parancssorába a futtatáshoz.

   $tableParams = @'
   {
       "properties": {
           "schema": {
               "name": "MyTable_CL",
               "columns": [
                   {
                       "name": "TimeGenerated",
                       "type": "DateTime"
                   }, 
                   {
                       "name": "RawData",
                       "type": "String"
                   }
               ]
           }
       }
   }
   '@
   
   Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/MyTable_CL?api-version=2021-12-01-preview" -Method PUT -payload $tableParams
   

Tábla törlése

Az Azure Monitor-naplókban számos táblatípus létezik. Bármely olyan táblát törölhet, amely nem Azure-tábla, de mi történik az adatokkal a tábla törlésekor, az minden táblatípus esetében eltérő.

További információ: Mi történik az adatokkal, amikor töröl egy táblát egy Log Analytics-munkaterületen.

Portál

Tábla törlése az Azure Portalról:

1. A Log Analytics-munkaterület menüjében válassza a Táblák lehetőséget.

2. Keresse meg a törölni kívánt táblákat név alapján, vagy válassza a Keresés találatok lehetőséget a Típus mezőben.

   

3. Jelölje ki a törölni kívánt táblát, jelölje ki a táblázattól jobbra található három pontot (...), válassza a Törlés lehetőséget, és erősítse meg a törlést az igen beírásával.

   

API

Tábla törléséhez hívja meg a Táblák – Törlés API-t.

Parancssori felület

Tábla törléséhez futtassa az az monitor log-analytics munkaterület táblatörlési parancsát.

PowerShell

Tábla törlése a PowerShell használatával:

1. Válassza a Cloud Shell gombot az Azure Portalon, és győződjön meg arról, hogy a környezet PowerShellre van állítva.

   

2. Másolja ki a következő PowerShell-kódot, és cserélje le az Elérési út paramétert a munkaterület megfelelő értékeire a Invoke-AzRestMethod parancsban. Illessze be a Cloud Shell parancssorába a futtatáshoz.

   Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/NewCustom_CL?api-version=2021-12-01-preview" -Method DELETE
   

Egyéni oszlop hozzáadása vagy törlése

Módosíthatja az egyéni táblák sémáját, és hozzáadhat egyéni oszlopokat egy standard táblához, vagy törölheti az oszlopokat.

Feljegyzés

Az oszlopneveknek betűvel kell kezdődniük, és legfeljebb 45 alfanumerikus karakterből és aláhúzásból (_) állhatnak. _ResourceId, , _ResourceIdid, _SubscriptionId, TenantId, Type, UniqueId, és Title fenntartott oszlopnevek.

Portál

Ha egyéni oszlopot szeretne hozzáadni egy táblához a Log Analytics-munkaterületen, vagy törölni szeretne egy oszlopot:

1. A Log Analytics-munkaterületek menüben válassza a Táblák lehetőséget.

2. Jelölje ki a szerkeszteni kívánt táblázattól jobbra található három pontot ( ... ), majd válassza a Séma szerkesztése lehetőséget. Ekkor megnyílik a Sémaszerkesztő képernyője.

3. Görgessen le a Sémaszerkesztő képernyő Egyéni oszlopok szakaszához.

   

4. Új oszlop hozzáadása:

   1. Válassza az Oszlop hozzáadása lehetőséget.
   2. Adja meg az oszlop nevét és leírását (nem kötelező), és válassza ki a várt értéktípust a Típus legördülő listából.
   3. Az új oszlop mentéséhez válassza a Mentés lehetőséget.

5. Oszlop törléséhez válassza a törölni kívánt oszloptól balra található Törlés ikont.

API

Egyéni oszlop hozzáadásához vagy törléséhez hívja meg a Táblák – API létrehozása vagy frissítése parancsot.

Parancssori felület

Egyéni oszlop hozzáadásához vagy törléséhez futtassa az az monitor log-analytics munkaterület táblafrissítési parancsát.

PowerShell

Ha új oszlopot szeretne hozzáadni egy Azure-beli vagy egyéni táblához, futtassa a következőt:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "<TableName>",
            "columns": [
                {
                    "name": ""<ColumnName>",
                    "description": "First custom column",
                    "type": "string",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/<TableName>?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

A PUT hívás visszaadja a frissített táblatulajdonságokat, amelyeknek tartalmazniuk kell az újonnan hozzáadott oszlopot.

Példa

Futtassa ezt a parancsot egy egyéni, úgynevezett Custom1_CFoszlop hozzáadásához az Azure-táblához Heartbeat :

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
                {
                    "name": "Custom1_CF",
                    "description": "The second custom column",
                    "type": "datetime",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

Most, ha törölni szeretné az újonnan hozzáadott oszlopot, és helyette egy másikat szeretne hozzáadni, futtassa a következőt:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
                {
                    "name": "Custom2_CF",
                    "description": "The second custom column",
                    "type": "datetime",
                    "isDefaultDisplay": true,
                    "isHidden": false
                }
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

A tábla összes egyéni oszlopának törléséhez futtassa a következőt:

$tableParams = @'
{
    "properties": {
        "schema": {
            "name": "Heartbeat",
            "columns": [
            ]
        }
    }
}
'@

Invoke-AzRestMethod -Path "/subscriptions/{subscription}/resourcegroups/{resourcegroup}/providers/microsoft.operationalinsights/workspaces/{workspace}/tables/Heartbeat?api-version=2021-12-01-preview" -Method PUT -payload $tableParams

Következő lépések

További információk:

• Naplók gyűjtése a Log Ingestion API-val
• Naplók gyűjtése az Azure Monitor-ügynökkel
• Adatgyűjtési szabályok