Monitorování dat služby Azure Cosmos DB pomocí nastavení diagnostiky služby Azure Monitor Log Analytics
Článek
PLATÍ PRO: NoSQL MongoDB Cassandra Skřítek Stůl
Nastavení diagnostiky v Azure slouží ke shromažďování protokolů prostředků. Prostředky generují protokoly prostředků Azure a poskytují bohaté a časté údaje o provozu tohoto prostředku. Tyto protokoly se zaznamenávají na každý požadavek a označují se také jako protokoly roviny dat. Mezi příklady operací roviny dat patří odstranění, vložení a čteníFeed. Obsah těchto protokolů se liší podle typu prostředku.
Doporučujeme vytvořit nastavení diagnostiky v režimu specifickém pro prostředky (pro všechna rozhraní API s výjimkou rozhraní API pro tabulku) podle pokynů na kartě REST API . Tato možnost poskytuje další optimalizace nákladů s vylepšeným zobrazením pro zpracování dat.
Existující pracovní prostor služby Azure Monitor Log Analytics
Upozorňující
Pokud potřebujete odstranit prostředek, přejmenovat nebo přesunout prostředek nebo ho migrovat mezi skupinami prostředků nebo předplatnými, nejprve odstraňte jeho nastavení diagnostiky. Jinak, pokud tento prostředek znovu vytvoříte, může být nastavení diagnostiky odstraněného prostředku součástí nového prostředku v závislosti na konfiguraci prostředků pro každý prostředek. Pokud jsou nastavení diagnostiky součástí nového prostředku, obnoví se shromažďování protokolů prostředků, jak je definováno v nastavení diagnostiky, a odešle příslušná metrika a data protokolu do dříve nakonfigurovaného cíle.
Také je vhodné odstranit nastavení diagnostiky pro prostředek, který budete odstraňovat, a neplánovat použití znovu, aby vaše prostředí nebylo čisté.
Vytvoření nastavení diagnostiky
Tady si projdeme proces vytváření nastavení diagnostiky pro váš účet.
Poznámka:
Metrika pro export protokolů jako kategorie se v současné době nepodporuje.
Přejděte k existujícímu účtu služby Azure Cosmos DB.
V části Monitorování v nabídce prostředků vyberte Nastavení diagnostiky. Pak vyberte možnost Přidat nastavení diagnostiky.
Důležité
Může se zobrazit výzva k povolení fulltextového dotazu [...] pro podrobnější protokolování, pokud není ve vašem účtu povolená funkce fulltextového dotazu . Toto upozornění můžete bezpečně ignorovat, pokud nechcete tuto funkci povolit. Další informace najdete v tématu povolení fulltextového dotazu.
V podokně Nastavení diagnostiky pojmenujte nastavení příkladu nastavení a pak vyberte kategorii QueryRuntimeStatistics. Zaškrtněte políčko Odeslat do pracovního prostoru služby Log Analytics a vyberte existující pracovní prostor. Nakonec jako cílovou možnost vyberte Prostředek specifický .
az monitor diagnostic-settings create Pomocí příkazu vytvořte nastavení diagnostiky pomocí Azure CLI. Popis jeho parametrů najdete v dokumentaci k tomuto příkazu.
Ujistěte se, že jste se přihlásili k Azure CLI. Další informace najdete v tématu Přihlášení pomocí Azure CLI.
Slouží az monitor diagnostic-settings create k vytvoření nastavení.
az deployment group create \
--resource-group "<resource-group-name>" \
--template-file azuredeploy.json \
--parameters \
azureCosmosDbAccountName="<azure-cosmos-db-account-name>" \
logAnalyticsWorkspaceName="<log-analytics-workspace-name>"
Tip
az bicep decompile Pomocí příkazu převeďte šablonu Azure Resource Manageru na šablonu Bicep.
Povolení fulltextového dotazu pro protokolování textu dotazu
Azure Cosmos DB poskytuje rozšířené protokolování pro podrobné řešení potíží. Povolením fulltextového dotazu můžete zobrazit deobfuscovaný dotaz pro všechny požadavky v rámci účtu služby Azure Cosmos DB. Také udělíte oprávnění ke službě Azure Cosmos DB pro přístup k datům a jejich zpřístupnění v protokolech.
Upozorňující
Povolení této funkce může vést k dalším nákladům na protokolování. Podrobnosti o cenách najdete na stránce s cenami služby Azure Monitor. Po řešení potíží doporučujeme tuto funkci zakázat.
Na stránce existujícího účtu služby Azure Cosmos DB vyberte možnost Funkce v části Nastavení nabídky prostředků. Pak vyberte funkci fulltextového dotazu Diagnostika.
V dialogovém okně vyberte Enable. Toto nastavení se použije během několika minut. Všechny nově přijaté protokoly teď mají pro každý požadavek úplný text nebo text PIICommand.
Pomocí Azure CLI povolte fulltextový dotaz pro váš účet služby Azure Cosmos DB.
Povolte fulltextový dotaz znovu s az rest příkazem HTTP PATCH a datovou částí JSON.