Migrace z rozhraní API kolektoru dat HTTP do rozhraní API pro příjem protokolů za účelem odesílání dat do protokolů služby Azure Monitor
Rozhraní API pro příjem protokolů služby Azure Monitor poskytuje větší výpočetní výkon a větší flexibilitu při ingestování protokolů a správě tabulek než starší verze rozhraní API kolektoru dat HTTP. Tento článek popisuje rozdíly mezi rozhraním API kolektoru dat a rozhraním API pro příjem protokolů a poskytuje pokyny a osvědčené postupy pro migraci na nové rozhraní API pro příjem protokolů.
Poznámka:
Jako MVP Microsoftu přispěl Morten Waltorp Knudsen a poskytl nám materiálovou zpětnou vazbu k tomuto článku. Příklad automatizace nastavení a průběžného používání rozhraní API pro příjem protokolů najdete v modulu AzLogDcrIngestPS PowerShellu s veřejně dostupnou službou Morten.
Výhody rozhraní API pro příjem protokolů
Rozhraní API pro příjem protokolů poskytuje následující výhody oproti rozhraní API kolektoru dat:
- Podporuje transformace, které umožňují upravit data před jejich ingestováním do cílové tabulky, včetně filtrování a manipulace s daty.
- Umožňuje odesílat data do více cílů.
- Umožňuje spravovat schéma cílové tabulky včetně názvů sloupců a zda přidat nové sloupce do cílové tabulky při změně schématu zdrojových dat.
Požadavky
Postup migrace popsaný v tomto článku předpokládá, že máte:
- Pracovní prostor služby Log Analytics, kde máte alespoň práva přispěvatele.
- Oprávnění k vytváření pravidel shromažďování dat v pracovním prostoru služby Log Analytics
- Aplikace Microsoft Entra pro ověřování volání rozhraní API nebo jakéhokoli jiného schématu ověřování Resource Manageru.
Požadována oprávnění
| Akce | Požadována oprávnění |
|---|---|
| Vytvořte koncový bod shromažďování dat. | Microsoft.Insights/dataCollectionEndpoints/write oprávnění, která poskytuje předdefinovaná role Přispěvatel monitorování, například. |
| Vytvořte nebo upravte pravidlo shromažďování dat. | Microsoft.Insights/DataCollectionRules/Write oprávnění, která poskytuje předdefinovaná role Přispěvatel monitorování, například. |
| Převeďte tabulku, která používá rozhraní API kolektoru dat, na pravidla shromažďování dat a rozhraní API pro příjem protokolů. | Microsoft.OperationalInsights/workspaces/tables/migrate/action oprávnění, která poskytuje integrovaná role přispěvatele Log Analytics, například. |
| Vytvořte nové tabulky nebo upravte schémata tabulek. | microsoft.operationalinsights/workspaces/tables/write oprávnění, která poskytuje integrovaná role přispěvatele Log Analytics, například. |
| Volejte rozhraní API pro příjem protokolů. | Viz Přiřazení oprávnění k řadiči domény. |
Vytvoření nových prostředků požadovaných pro rozhraní API pro příjem protokolů
Rozhraní API pro příjem protokolů vyžaduje, abyste vytvořili dva nové typy prostředků, které rozhraní API kolektoru dat HTTP nevyžaduje:
- Koncové body shromažďování dat, ze kterých se data, která shromažďujete, ingestují do kanálu ke zpracování.
- Pravidla shromažďování dat, která definují transformace dat a cílovou tabulku, do které se data ingestují.
Migrace existujících vlastních tabulek nebo vytvoření nových tabulek
Pokud máte existující vlastní tabulku, do které aktuálně odesíláte data pomocí rozhraní API kolektoru dat, můžete:
Migrujte tabulku a pokračujte v příjmu dat do stejné tabulky pomocí rozhraní API pro příjem protokolů.
Udržujte existující tabulku a data a nastavte novou tabulku, do které ingestujete data pomocí rozhraní API pro příjem protokolů. Starou tabulku pak můžete odstranit, až budete připraveni.
Toto je upřednostňovaná možnost, zejména pokud potřebujete provést změny stávající tabulky. Změny existujících datových typů a více změn schématu existujících vlastních tabulek rozhraní API kolektoru dat můžou vést k chybám.
Tip
Pokud chcete zjistit, které tabulky používají rozhraní API kolektoru dat, zobrazte vlastnosti tabulky. Vlastnost Typ tabulek, které používají rozhraní API kolektoru dat, je nastavena na Vlastní tabulka (Classic). Všimněte si, že tabulky, které ingestují data pomocí starší verze agenta Log Analytics (MMA), mají také vlastnost Type nastavenou na Vlastní tabulku (Classic). Před převodem tabulek MMA nezapomeňte provést migraci z agenta Log Analytics na agenta Azure Monitoru. Jinak po převodu tabulky přestanete ingestovat data do vlastních polí v těchto tabulkách.
Tato tabulka shrnuje aspekty, které je potřeba vzít v úvahu pro každou možnost:
| Migrace tabulek | Souběžná implementace | |
|---|---|---|
| Pojmenování tabulek a sloupců | Znovu použijte existující název tabulky. Možnosti pojmenování sloupců: – Použijte nové názvy sloupců a definujte transformaci pro směrování příchozích dat do nově pojmenovaného sloupce. - Pokračujte v používání starých jmen. |
Nastavte nový název tabulky volně. Před přepnutím na novou tabulku je potřeba upravit integrace, řídicí panely a upozornění. |
| Postup migrace | Jednorázová migrace tabulek Migrovanou tabulku nejde vrátit zpět. | Migraci je možné provádět postupně na každou tabulku. |
| Po migraci | Data můžete dál ingestovat pomocí rozhraní API kolektoru dat HTTP s existujícími sloupci s výjimkou vlastních sloupců. Ingestování dat do nových sloupců pouze pomocí rozhraní API pro příjem protokolů |
Data ve staré tabulce jsou k dispozici až do konce doby uchovávání. Při prvním nastavení nové tabulky nebo provedení změn schématu může trvat 10 až 15 minut, než se změny dat začnou zobrazovat v cílové tabulce. |
Pokud chcete převést tabulku, která používá rozhraní API kolektoru dat na pravidla shromažďování dat a rozhraní API pro příjem protokolů, zaveďte toto volání rozhraní API pro tabulku:
POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}/migrate?api-version=2021-12-01-preview
Toto volání je idempotentní, takže nemá žádný vliv, pokud již byla tabulka převedena.
Volání rozhraní API umožňuje všem funkcím vlastních protokolů založeným na DCR v tabulce. Rozhraní API kolektoru dat bude nadále ingestovat data do existujících sloupců, ale nebude vytvářet žádné nové sloupce. Všechna dříve definovaná vlastní pole se nebudou dál vyplňovat. Dalším způsobem, jak migrovat existující tabulku do pravidel shromažďování dat, ale nemusí nutně rozhraní API pro příjem protokolů použít transformaci pracovního prostoru na tabulku.
Důležité
- Názvy sloupců musí začínat písmenem a mohou obsahovat až 45 alfanumerických znaků a podtržítka (
_). _ResourceId,id, ,_SubscriptionId_ResourceId, ,TenantId,Type,UniqueIdaTitlejsou vyhrazené názvy sloupců.- Vlastní sloupce, které přidáte do tabulky Azure, musí mít příponu
_CF. - Pokud aktualizujete schéma tabulky v pracovním prostoru služby Log Analytics, musíte také aktualizovat definici vstupního datového proudu v pravidle shromažďování dat tak, aby ingestování dat do nových nebo upravených sloupců.
Volání rozhraní API pro příjem protokolů
Rozhraní API pro příjem protokolů umožňuje odesílat až 1 MB komprimovaných nebo nekomprimovaných dat na volání. Pokud potřebujete odeslat více než 1 MB dat, můžete souběžně posílat více volání. Jedná se o změnu z rozhraní API kolektoru dat, které umožňuje posílat až 32 MB dat na volání.
Informace o tom, jak volat rozhraní API pro příjem protokolů, najdete v tématu Volání rozhraní REST API pro příjem protokolů.
Úprava schémat tabulek a pravidel shromažďování dat na základě změn zdrojového datového objektu
Zatímco rozhraní API kolektoru dat při změně schématu objektu zdrojového dat automaticky upraví schéma cílové tabulky, rozhraní API pro příjem protokolů ne. Tím zajistíte, že nebudete shromažďovat nová data do sloupců, které jste nechtěli vytvořit.
Když se schéma zdrojových dat změní, můžete:
- Upravte schémata cílových tabulek a pravidla shromažďování dat tak, aby odpovídaly změnám schématu zdrojových dat.
- Definujte v pravidle shromažďování dat transformaci , která odešle nová data do existujících sloupců v cílové tabulce.
- Ponechte cílovou tabulku a pravidlo shromažďování dat beze změny. V takovém případě nebudete ingestovat nová data.
Poznámka:
Název sloupce nemůžete znovu použít s datovým typem, který se liší od původního datového typu definovaného pro sloupec.
Další kroky
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro