Kurz: Přidání transformace pro data pracovního prostoru Azure Cosmos DB pomocí webu Azure Portal

Článek
08/15/2024

Tento kurz vás provede konfigurací ukázkové transformace v pravidle shromažďování dat pracovního prostoru (DCR) pomocí webu Azure Portal.

Poznámka:

Abychom pomohli zlepšit náklady na povolení Log Analytics, podporujeme přidávání pravidel shromažďování dat a transformací do prostředků Log Analytics za účelem filtrování sloupců, snížení počtu vrácených výsledků a vytvoření nových sloupců před odesláním dat do cíle.

Transformace pracovních prostorů se ukládají do jednoho řadiče domény pro pracovní prostor, který se nazývá DCR pracovního prostoru. Každá transformace je přidružená ke konkrétní tabulce. Transformace se použije na všechna data odesílaná do této tabulky z jakéhokoli pracovního postupu, který nepoužívá dcR.

Poznámka:

Tento kurz používá Azure Portal ke konfiguraci transformace pracovního prostoru. Stejný kurz použití šablon Azure Resource Manageru a rozhraní REST API najdete v kurzu : Přidání transformace v pravidle shromažďování dat pracovního prostoru do služby Azure Monitor pomocí šablon Resource Manageru.

V tomto kurzu se naučíte:

Nakonfigurujte transformaci pracovního prostoru pro tabulku v pracovním prostoru služby Log Analytics.
Napište dotaz protokolu pro transformaci pracovního prostoru.

Požadavky

Pro absolvování tohoto kurzu potřebujete:

Pracovní prostor služby Log Analytics, kde máte alespoň práva přispěvatele.
Oprávnění k vytváření objektů DCR v pracovním prostoru
Tabulka, která už obsahuje nějaká data.
Tabulku nelze propojit s pravidlem DCR transformace pracovního prostoru.

Přehled kurzu

V tomto kurzu snížíte požadavky na úložiště pro CDBDataPlaneRequests tabulku filtrováním určitých záznamů. Zároveň odeberete obsah sloupce a parsujete data sloupce a uložíte tak část dat do vlastního sloupce. Tabulka CDBDataPlaneRequests se vytvoří při povolení log analytics v pracovním prostoru.

V tomto kurzu se používá Azure Portal, který poskytuje průvodce, který vás provede procesem vytvoření transformace v čase příjmu dat. Po dokončení kroků uvidíte, že průvodce:

Aktualizuje schéma tabulky s jinými sloupci z dotazu.
WorkspaceTransformation Vytvoří řadič domény a propojí ho s pracovním prostorem, pokud výchozí řadič domény ještě není propojený s pracovním prostorem.
Vytvoří transformaci v čase příjmu dat a přidá ji do dcR.

Povolení protokolů auditu dotazů

Abyste mohli vytvořit CDBDataPlaneRequests tabulku, se kterou pracujete, musíte pro svůj pracovní prostor povolit Log Analytics. Tento krok není nutný pro všechny transformace času příjmu dat. Stačí vygenerovat ukázková data, se kterými pracujeme.

Přidání transformace do tabulky

Teď, když je tabulka vytvořená, můžete pro ni vytvořit transformaci.

V nabídce pracovních prostorů služby Log Analytics na webu Azure Portal vyberte Tabulky. CDBDataPlaneRequests Vyhledejte tabulku a vyberte Vytvořit transformaci.
Protože je tato transformace první v pracovním prostoru, musíte vytvořit dcR transformace pracovního prostoru. Pokud vytvoříte transformace pro jiné tabulky ve stejném pracovním prostoru, uloží se do stejného řadiče domény. Vyberte Vytvořit nové pravidlo shromažďování dat. Předplatné a skupina prostředků jsou už pro pracovní prostor vyplněné. Zadejte název dcR a vyberte Hotovo.
Výběrem možnosti Další zobrazíte ukázková data z tabulky. Při definování transformace se výsledek použije u ukázkových dat. Z tohoto důvodu můžete výsledky vyhodnotit předtím, než je použijete na skutečná data. Výběrem editoru transformací definujte transformaci.
V editoru transformací uvidíte transformaci, která se použije u dat před jejich příjmem dat do tabulky. Virtuální tabulka s názvem source představuje příchozí data, která mají stejnou sadu sloupců jako samotná cílová tabulka. Transformace zpočátku obsahuje jednoduchý dotaz, který vrací source tabulku beze změn.
Upravte dotaz na následující příklad:
```
source
| where StatusCode != 200 // searching for requests that are not successful
| project-away Type, TenantId
```
Tato změna provede následující změny:
- Řádky související s dotazováním CDBDataPlaneRequests samotné tabulky byly vyřazeny, aby se ušetřilo místo, protože tyto položky protokolu nejsou užitečné.
- Data ze TenantId sloupců a Type sloupců byla odebrána, aby se ušetřilo místo.
- Transformace také podporují přidávání sloupců pomocí operátoru extend v dotazu.
Poznámka:

Na webu Azure Portal se výstupem transformace v případě potřeby zahájí změny schématu tabulky. Sloupce se přidají tak, aby odpovídaly výstupu transformace, pokud ještě neexistují. Ujistěte se, že výstup neobsahuje žádné sloupce, které nechcete do tabulky přidat. Pokud výstup neobsahuje sloupce, které už jsou v tabulce, tyto sloupce se neodeberou, ale data se nepřidají.

Všechny vlastní sloupce přidané do předdefinované tabulky musí končit ._CF Sloupce přidané do vlastní tabulky nemusí mít tuto příponu. Vlastní tabulka má název, který končí ._CL
Zkopírujte dotaz do editoru transformace a výběrem možnosti Spustit zobrazte výsledky z ukázkových dat. Můžete ověřit, že nový Workspace_CF sloupec je v dotazu.
Výběrem možnosti Použít uložte transformaci a pak výběrem možnosti Další zkontrolujte konfiguraci. Výběrem možnosti Vytvořit aktualizujte řadič domény novou transformací.

Testování transformace

Počkejte přibližně 30 minut, než se transformace projeví, a pak ji otestujte spuštěním dotazu na tabulku. Tato transformace ovlivňuje pouze data odesílaná do tabulky po použití transformace.

Pro účely tohoto kurzu spusťte několik ukázkových dotazů, které posílají data do CDBDataPlaneRequests tabulky. Zahrňte některé dotazy CDBDataPlaneRequests , abyste mohli ověřit, že transformace filtruje tyto záznamy.

Řešení problému

Tato část popisuje různé chybové stavy, které se můžou zobrazit a jak je opravit.

IntelliSense v Log Analytics nerozpoznává nové sloupce v tabulce

Aktualizace mezipaměti, která řídí technologii IntelliSense, může trvat až 24 hodin.

Transformace dynamického sloupce nefunguje

Známý problém aktuálně ovlivňuje dynamické sloupce. Dočasným alternativním řešením je explicitně analyzovat dynamická data sloupců pomocí před parse_json() provedením jakýchkoli operací s nimi.

Další kroky

Transformace shromažďování dat

Sdílet prostřednictvím