Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Application Insights nabízí vlastní metriky sady SDK, které pomáhají monitorovat a řešit potíže s chybějícím nebo neočekávaným chováním telemetrie. Pokud telemetrie nedosahuje koncového bodu příjmu dat, statistiky sady SDK vám pomůžou zjistit, co se stalo a co dělat dál.
Metriky statistik sady SDK zahrnují počty úspěšnosti, poklesů a opakování položek. Metriky statistik sady SDK zahrnují také kódy odhození a kódy opakování, které vysvětlují příčinu a navádí na další kroky.
Vizualizace je k dispozici v sešitu statistik sady SDK.
Splnění požadavků
Instrumentace aplikace pomocí OpenTelemetry pomocí jedné z následujících sad SDK nebo agentů:
- .NET / .NET Core:
Azure.Monitor.OpenTelemetry.Exporterverze1.6.0nebo novější. - .NET Application Insights SDK 3.x nebo novější.
- Python: Verze
1.8.6distribuce OpenTelemetry nebo novější a verzeazure-monitor-opentelemetry-exporter1.0.0b47nebo novější. - Node.js: OpenTelemetry Distro verze
1.15.1nebo novější a@azure/monitor-opentelemetry-exporterverze1.0.0-beta.38nebo novější. - Node.js: Verze
3.13.0sady Application Insights SDK nebo novější.
Poznámka:
Pokud jste tuto funkci použili před GA, viz Upgrade ze statistik sady Preview SDK
Přehled statistik sady SDK
Statistiky sady SDK jsou čítače pro jednotlivé procesy, které sady SDK a agenti Application Insights generují jako vlastní metriky. Tyto metriky shrnují počet položek telemetrie, které vývozce úspěšně odesílá, kolik položek exportér klesne, a kolik položek plánuje vývozce pro opakování.
Sada SDK publikuje tři metriky:
Item_Success_CountItem_Dropped_CountItem_Retry_Count
Poznámka:
Počty opakování představují pokusy a nesnižují se. Pozdější úspěch stejných položek se projeví pouze v řadě úspěchů.
Kontrola dimenzí
Mezi tyto metriky patří dimenze ve customDimensions standardních dimenzích Application Insights pro řezy:
| Dimenze | Description |
|---|---|
telemetry_type |
Typ telemetrie, který je spojen s počtem Hodnoty odpovídají tabulkám Application Insights, jako REQUESTjsou například , DEPENDENCY, EXCEPTIONTRACE, , CUSTOM_EVENTa AVAILABILITY. |
drop.code, drop.reason |
Kód a krátký důvod vyřazených položek Kód je buď stav http (Hypertext Transfer Protocol) z koncového bodu příjmu dat, nebo klientský kód, například CLIENT_EXCEPTION. |
retry.code, retry.reason |
Kód a krátký důvod plánovaných opakování Kód je buď stav http (Hypertext Transfer Protocol) z koncového bodu příjmu dat, nebo klientský kód, například CLIENT_TIMEOUT. |
telemetry_success |
Hodnota REQUEST položky telemetrie a hodnota položky DEPENDENCY telemetrie v době exportu (success nebo true).false |
language, version |
Sada SDK nebo jazyk a verze agenta. |
compute.type |
Výpočetní prostředí, jako je Azure Kubernetes Service (AKS),aks Azure App Service (appsvc), Azure Functions (functions), Azure Spring Apps (springcloud), virtuální počítač (VM) nebovmunknown . |
sdkVersion |
Řetězec verze sady SDK je také k dispozici ve značkách. |
cloud_RoleName, cloud_RoleInstance |
Dimenze prostředků, které můžete použít k řezu podle služby a instance. |
Každý řádek metrik představuje agregovaný počet pro interval exportu. Celkový počet pokusů v časovém řezu se Item_Success_Count + Item_Dropped_Count rovná pro tento řez.
Konfigurace statistik sady SDK
Statistiky sady SDK jsou ve výchozím nastavení povolené. Pomocí proměnných prostředí můžete zakázat statistiky sady SDK nebo nakonfigurovat interval exportu. Po změně proměnné prostředí aplikaci restartujte.
Zakázání statistik sady SDK
Nastavte proměnnou APPLICATIONINSIGHTS_SDKSTATS_DISABLED=true prostředí v prostředí procesu aplikace a potom aplikaci restartujte.
Nastavení intervalu exportu
- Použijte výchozí interval exportu 15 minut.
- Nastavte jiný interval v sekundách pomocí
APPLICATIONINSIGHTS_SDKSTATS_EXPORT_INTERVAL.
Nemusíte nasazovat žádné prostředky sešitu. Šablona statistik sady SDK se zobrazí v galerii Sešity v rámci prostředku Application Insights. Sešit zobrazuje žádná data , dokud sada SDK nevygeneruje tyto vlastní metriky.
Otevření sešitu statistik sady SDK
Otevřete prostředek Application Insights, poté otevřete Sešity a vyberte Statistiky SDK. Tato funkce využívá jediný sešit se zjednodušenou sadou vizuálů.
Použití filtrů
K určení rozsahu zobrazení použijte filtry v horní části sešitu:
- Časový rozsah: Filtrujte podle časového intervalu a velikosti intervalu.
-
Verze sady SDK: Filtrujte podle
sdkVersionpole. -
Typ telemetrie: Filtrujte podle
telemetry_typedimenze. -
Důvod zrušení a Kód zrušení: Filtrovat podle
drop.reasonadrop.code.
Kontrola grafických prvků sešitu
Sešit se zaměřuje na stručnou sadu grafů, které udržují výsledky v kontextu:
-
Míra poklesu. Zobrazuje
dropped / (dropped + success)se ve vybraném časovém intervalu. -
Analýza požadavků a závislostí v průběhu času Rozdělí telemetrii požadavků a závislostí podle hodnoty položky
successv aplikaci, a následně je zobrazí jako odeslané a vyřazené v samostatných pruhových grafech:- Úspěšné a odeslané vs. vyřazení. Tento graf zobrazuje položky požadavků a závislostí, které aplikace zaznamenává jako úspěšné. Graf porovnává položky, které exportér odešle do Application Insights, s položkami, které exportér zahodí.
- Selhalo a odeslalo se vs. vyřazeno. Porovná položky, které aplikace zaznamenala jako neúspěšné, a ty, které vývozce odeslal, s položkami ve stejné kategorii, které vývozce vynechal. Špičky v selhání, vyřazení často značí přechodné problémy se službou, omezování nebo problémy s konfigurací.
- K izolaci příčin použijte filtry Drop Reason, Drop Code a SDK Version . Pokud například dojde k chybě, pokles se zvýší, zkontrolujte
429problémy s omezováním nebo401ověřováním403.
- Přechod k podrobnostem časových intervalů Výběrem kontejneru se otevře zobrazení rozpisu s hlavními důvody a kódy pro dané období.
- Export výsledků v průběhu času Vykresluje počty úspěchů, opakování a vyřazení společně.
Řešení potíží s neočekávaným chováním telemetrie
Pomocí kódů můžete určit, co se stalo a co dělat dál. Vysvětlivky v sešitu označují, kam se podívat nejdříve.
Diagnostika chybových kódů
Vývozce nastaví drop.code pro položky, které nemůže doručit. Použijte následující doprovodné materiály.
Poznámka:
Koncový bod přijímací vrací 206 Partial Content když přijme některé položky telemetrie a odmítne ostatní ve stejné dávce. Vývozce počítá přijaté položky telemetrie v Item_Success_Count. Vývozce počítá odmítnuté položky telemetrie v Item_Dropped_Count a nastavuje drop.code pro důvod zamítnutí.
Kontrola kódů pro vyřazení klienta
| drop.code | Co to znamená v praxi | Co byste měli udělat dál |
|---|---|---|
CLIENT_EXCEPTION |
Položky byly vyřazeny, protože vývozce narazil na výjimku nebo nepřijal žádnou odpověď. | Zkontrolujte protokoly aplikací a exportérů. Ověřte dns (Domain Name System), TLS (Transport Layer Security), proxy server, bránu firewall a odchozí pravidla internetu. Ověřte dostupnost koncového bodu z hostitele. |
CLIENT_READONLY |
Místní perzistence nemůže zapisovat, protože systém souborů je pouze pro čtení. | Trvalost bodu na zapisovatelnou cestu. Opravte oprávnění ke kontejneru nebo virtuálnímu počítači. Pokud není v prostředí povoleno, zvažte zakázání trvalosti disku. |
CLIENT_PERSISTENCE_CAPACITY |
Místní úložiště bylo plné a nové položky nelze ukládat do mezipaměti. | Zvyšte kvótu disku nebo velikost úložiště. Zmenšete velikost dávky nebo rychlost příjmu dat. Zvažte vzorkování. |
CLIENT_STORAGE_DISABLED |
Místní trvalost je zakázaná. Položky, které potřebují ukládání do vyrovnávací paměti, nelze uložit a vyřadí se. | Povolte místní úložiště nebo horizontální navýšení kapacity, abyste snížili tlak. |
*NON_RETRYABLE_STATUS_CODE |
Koncový bod příjmu dat vrátil neretrární stav, například 400, 401, 403nebo 404. |
Pomocí tabulek kódu HTTP opravte konfiguraci, přihlašovací údaje nebo schéma telemetrie a pak znovu nasaďte. |
Kontrola stavových kódů HTTP koncového bodu příjmu dat
| Stav HTTP | Typický důvod | Co byste měli udělat dál |
|---|---|---|
200 OK |
Všechny položky byly přijaty. | Není potřeba žádná akce. |
206 Partial Content |
Některé položky byly přijaty a jiné odmítnuty. | Zkontrolujte protokoly vývozce, jestli neobsahuje chyby jednotlivých položek. Ověřte schéma a velikosti. Zmenšení velikosti dávky, pokud jsou datové části blízko limitů velikosti. |
307 nebo 308 Redirect |
Přesměrujte na konkrétní koncový bod razítka. | Povolte přesměrování ve vašem prostředí. Aktualizujte připojovací řetězec. |
400 Bad Request |
Neplatné telemetrie nebo nepodporované schéma V některých případech se může chybná konfigurace Microsoft Entra zobrazit jako 400. | Ověřte velikosti a schéma datové části. Oprava připojovacího řetězce nebo cílové skupiny tokenů v případě nesprávného přesměrování |
401 Unauthorized |
Ověřování selhalo nebo token nemá požadovaná oprávnění. | Oprava připojovacího řetězce nebo přihlašovacích údajů Ujistěte se, že identita má správné role a obor tokenu pro Application Insights. |
402 Payment Required |
Denní limit byl překročen. | Upravte denní limit, snižte příjem dat nebo zvyšte vzorkování. Počkejte na resetování. |
403 Forbidden |
Oprávnění nebo mapování je nesprávné. | Opravte přiřazení rolí nebo mapování koncových bodů. Potvrďte, že prostředek a připojovací řetězec patří do stejného prostředí. |
404 Not Found |
Připojovací řetězec odkazuje na nesprávnou oblast nebo prostředek. | Aktualizujte připojovací řetězec. |
405 Method Not Allowed |
Metoda požadavku není povolená. | Upgradujte sadu SDK a potvrďte, že se používají pouze podporované metody. |
408 Request Timeout |
Časový limit sítě | Zkontrolujte latenci sítě a pravidla brány firewall. Pokud je to vhodné, zvyšte časový limit klienta. |
413 Payload Too Large |
Datová část batch překročila limity velikosti. | Snižte maximální velikost dávky. Zvažte odesílání častějších menších dávek. |
429 Too Many Requests |
Omezování s Retry-After. |
Snižte rychlost odesílání. Respekt Retry-After. Zvyšte vzorkování nebo horizontální navýšení kapacity. |
439 Daily Quota Exceeded
(zastaralé) |
Signál o starší verzi kvóty | Stejné jako 402. Nadále monitorujte 402. |
5xx Server Error |
Přechodný problém se službou | Očekávejte obnovení. Pokud trvá déle než několik minut, zkontrolujte stav Azure a otevřete případ podpory s časovými razítky a oblastmi. |
| Other | Nerozpoznalo se. | Zachyťte identifikátory korelace (ID) z protokolů a otevřete případ podpory. |
Diagnostika kódů opakování
Vývozce stanoví retry.code položky, které plánuje odeslat později. Opakování značí pokus o doručení, který ještě nebyl úspěšný, nikoli konečný pokles.
| retry.code | Co to znamená v praxi | Co byste měli udělat dál |
|---|---|---|
CLIENT_EXCEPTION |
Výjimka za běhu, jako je selhání sítě, zabránila doručení. | Zkontrolujte DNS, proxy servery, TLS a bránu firewall. Zkontrolujte podrobnosti o výjimce v protokolech vývozce. |
CLIENT_TIMEOUT |
Vývozce vypršel časový limit čekání na odpověď. | Pokud je to vhodné, zvyšte časový limit. Prozkoumejte latenci sítě a odezvu serveru. |
*RETRYABLE_STATUS_CODE |
Koncový bod příjmu dat vrátil opakovatelný stav HTTP (například 408429, ). 5xx |
Počítejte s případným obnovením. Snižte rychlost odesílání nebo vzorkování při omezování.
Retry-After Sledujte a respektujte to. |
Interpretace opakování
Item_Retry_Count Čítač se zvýší při každém naplánování opětovného odeslání telemetrie vývozcem. Odráží pokusy, nikoli konečné výsledky. Čítač se nikdy nezmenší. Pro porozumění stavu doručení použijte tuto metriku společně s úspěšnou a vynechanou sérií.
Interpretace trendů
- Zacházejte s rostoucí linií opakování jako se signálem, nikoli se ztrátou dat. Položky lze později úspěšně odeslat.
- Porovnejte opakované pokusy s úspěchem. Pokud se úspěšnost obnoví po několika opakovaných pokusech, je problém přechodný.
- Porovnejte opakování s vyřazenými. Pokud se opakované pokusy zvýší, zatímco poklesy zůstanou téměř na nule, exportér vyrovnává a zotavuje se.
- Prozkoumejte stále vysoký počet opakovaných pokusů s plošnou nebo klesající úspěšností. Tento model signalizuje blokující problém. Použijte obnovení úspěchu.
Prozkoumání podle kódu
Rozdělte metriku opakování, retry.code abyste zjistili, proč se pokusy opakují.
| retry.code | Co to obvykle znamená | Co zkontrolovat nebo udělat dál |
|---|---|---|
CLIENT_TIMEOUT |
Vývozce vypršel časový limit čekání na odpověď. | Pokud je to vhodné, zvyšte časový limit klienta. Zkontrolujte latenci, proxy servery a pravidla brány firewall. |
CLIENT_EXCEPTION |
Chyba sítě nebo modulu runtime zabránila doručení. | Zkontrolujte protokoly vývozce. Ověřte konfiguraci sítě DNS, TLS, proxy a odchozí sítě. |
408 |
Vypršel časový limit požadavku v koncovém bodu příjmu dat. | Prozkoumejte síťovou cestu a latenci. Zvažte menší dávky nebo vyšší frekvenci odesílání. |
429 |
Omezování příjmem dat, často s Retry-After. |
Snižte rychlost odesílání nebo zvyšte vzorkování. Ctihodnosti Retry-After před opakováním. |
5xx |
Přechodný problém se službou při příjmu dat | Očekávejte obnovení. Pokračujte v opakování s opakováním. Zkontrolujte stav Azure, jestli přetrvává. |
Úspěšné obnovení
Pokud opakování pokračuje ve stoupání a úspěch se neobnoví, přejděte k přetažení kódů a vyhledejte blokovací blok. Začněte problémy s konfigurací a kvótou, jako jsou (denní limit) nebo (ověřování nebo oprávnění) a problémy s úložištěm klientů, jako 402401je , 403nebo CLIENT_PERSISTENCE_CAPACITY.CLIENT_READONLYCLIENT_STORAGE_DISABLED Opravte základní příčinu a pak ověřte, že se pokles vrátí na nulu a úspěch se v dalších intervalech zvýší.
Odhad nákladů a objemu dat
Statistiky sady SDK odesílají agregované customMetrics záznamy. Úloha publikuje čítače místo každé položky telemetrie, takže objem dat zůstává nízký vzhledem k telemetrii aplikace. Záznamy se účtují jako standardní příjem customMetricsdat Application Insights a dodržují vaše nastavení uchovávání informací. Vývozce odešle čítače do existujícího kanálu příjmu dat.
Použití vzorce plánování
Estimated records per hour per instance ≈
(#metrics emitted per interval)
× (3600 / interval_seconds)
× (distinct dimension combinations you use)
Výchozí interval je 15 minut (interval_seconds = 900). Nakonfigurujte jiný interval pomocí APPLICATIONINSIGHTS_SDKSTATS_EXPORT_INTERVAL.
Použití statistik sady SDK mimo výchozí sešit
Pomocí statistik sady SDK můžete použít vlastní metriky s dalšími funkcemi služby Azure Monitor.
- Azure Data Explorer
-
Log Analytics prostřednictvím
customMetricstabulky - Výstrahy
- Power BI
- Průzkumník pro metriky
Dotazování v Azure Data Exploreru
Následují referenční ukázky jazyka KQL (Kusto Query Language ).
Export výsledků vs. času
let g = 15m; // align with export interval for clearer charts
customMetrics
| where name in ("Item_Success_Count", "Item_Dropped_Count", "Item_Retry_Count")
| summarize
success = sumif(todouble(value), name == "Item_Success_Count"),
dropped = sumif(todouble(value), name == "Item_Dropped_Count"),
retry = sumif(todouble(value), name == "Item_Retry_Count")
by bin(timestamp, g)
Sazby v průběhu času
let g = 15m;
customMetrics
| where name in ("Item_Success_Count", "Item_Dropped_Count", "Item_Retry_Count")
| summarize
success = sumif(todouble(value), name == "Item_Success_Count"),
dropped = sumif(todouble(value), name == "Item_Dropped_Count"),
retry = sumif(todouble(value), name == "Item_Retry_Count")
by bin(timestamp, g)
| extend drop_rate = dropped / iff((success + dropped) == 0.0, 1.0, (success + dropped))
| extend retry_to_attempt_ratio = retry / iff((success + dropped) == 0.0, 1.0, (success + dropped))
| project timestamp, drop_rate, retry_to_attempt_ratio
Analýza požadavků a závislostí v průběhu času (replikuje skládané pruhy)
let g = 15m;
// Successful request or dependency telemetry: sent vs dropped
let sent_success = (requests
| where success == true
| summarize c = count() by bin(timestamp, g)
| union (dependencies | where success == true | summarize c = count() by bin(timestamp, g))
| summarize sent = sum(c) by timestamp);
let dropped_success = (customMetrics
| where name == "Item_Dropped_Count"
| extend telemetry_type = tostring(customDimensions["telemetry_type"]),
telemetry_success = tostring(customDimensions["telemetry_success"])
| where telemetry_type in ("REQUEST","DEPENDENCY") and telemetry_success == "true"
| summarize dropped = sum(todouble(value)) by bin(timestamp, g));
sent_success
| join kind=fullouter dropped_success on timestamp
| project timestamp, ["Successful - Sent"] = todouble(sent), ["Successful - Dropped"] = todouble(dropped)
| order by timestamp asc;
// Failed request or dependency telemetry: sent vs dropped
let sent_failed = (requests
| where success == false
| summarize c = count() by bin(timestamp, g)
| union (dependencies | where success == false | summarize c = count() by bin(timestamp, g))
| summarize sent = sum(c) by timestamp);
let dropped_failed = (customMetrics
| where name == "Item_Dropped_Count"
| extend telemetry_type = tostring(customDimensions["telemetry_type"]),
telemetry_success = tostring(customDimensions["telemetry_success"])
| where telemetry_type in ("REQUEST","DEPENDENCY") and telemetry_success == "false"
| summarize dropped = sum(todouble(value)) by bin(timestamp, g));
sent_failed
| join kind=fullouter dropped_failed on timestamp
| project timestamp, ["Failed - Sent"] = todouble(sent), ["Failed - Dropped"] = todouble(dropped)
| order by timestamp asc
Souhrn důvodů vyřazení kódu
customMetrics
| where name == "Item_Dropped_Count"
| extend drop_reason = tostring(customDimensions["drop.reason"]),
drop_code = tostring(customDimensions["drop.code"])
| summarize total_dropped = sum(todouble(value)) by drop_reason, drop_code
| order by total_dropped desc
Vytváření upozornění
Vytvořte upozornění protokolu, která monitorují poměry nebo konkrétní kódy.
// Drop rate over 5 minutes
let window = 5m;
customMetrics
| where timestamp >= ago(window)
| where name in ("Item_Success_Count", "Item_Dropped_Count")
| summarize
success = sumif(todouble(value), name == "Item_Success_Count"),
dropped = sumif(todouble(value), name == "Item_Dropped_Count")
| extend drop_rate = dropped / iff((success + dropped) == 0.0, 1.0, (success + dropped))
| project drop_rate
// Over-quota daily cap (HTTP 402) in the last 10 minutes
let window = 10m;
customMetrics
| where timestamp >= ago(window)
| where name == "Item_Dropped_Count"
| extend drop_code = tostring(customDimensions["drop.code"])
| summarize dropped_402 = sum(todouble(value)) by drop_code
| where drop_code == "402" and dropped_402 > 0
| project dropped_402
Návod
Spárujte upozornění 402 s pokyny k dennímu limitu , aby respondenti mohli upravit limit nebo snížit příjem dat.
Používání Power BI
Pomocí konektoru protokolů služby Azure Monitor můžete tyto metriky přenést do Power BI.
// Drop and retry ratios by hour
let window = 14d;
let g = 1h;
customMetrics
| where timestamp >= ago(window)
| where name in ("Item_Success_Count", "Item_Dropped_Count", "Item_Retry_Count")
| summarize
success = sumif(todouble(value), name == "Item_Success_Count"),
dropped = sumif(todouble(value), name == "Item_Dropped_Count"),
retry = sumif(todouble(value), name == "Item_Retry_Count")
by bin(timestamp, g)
| extend drop_rate = dropped / iff((success + dropped) == 0.0, 1.0, (success + dropped))
| extend retry_to_attempt_ratio = retry / iff((success + dropped) == 0.0, 1.0, (success + dropped))
| order by timestamp asc
// Dropped items by reason
let window = 14d;
let g = 1h;
customMetrics
| where timestamp >= ago(window)
| where name == "Item_Dropped_Count"
| extend drop_reason = tostring(customDimensions["drop.reason"])
| summarize dropped = sum(todouble(value)) by bin(timestamp, g), drop_reason
| order by timestamp asc
Použijte Průzkumníka metrik
Graf těchto statistik sady SDK v metrikách
- Otevřete prostředek Application Insights.
- Otevřete metriky.
- Pro obor názvů metrik vyberte metriky založené na protokolech.
- Pro metriku vyberte jednu z těchto možností:
Item_Success_CountItem_Dropped_CountItem_Retry_Count
- (Volitelné) Nastavte Agregaci na Součet pro celkové hodnoty časového zrna.
- K prozkoumání použijte funkci Split by . Běžné rozdělení:
- drop.reason, drop.code
- telemetry_type, sdkVersion
- cloud_RoleName, cloud_RoleInstance
Porovnání statistik sady SDK s protokoly
Neočekávejte, že tyto čítače budou ve stejných počtech položek v tabulkách, jako requests je například .dependencies K rozdílům dochází z několika důvodů:
- Časování agregace Statistiky agregují v intervalech a dávkách. Protokoly ukládají jednotlivé položky, takže počty různých časových zrn se můžou lišit.
- Vzorkování a procesory. Statistiky po použití vzorkování a všech procesorů, které odstraňují nebo upravují telemetrii, použijí sadu SDK. Protokoly odrážejí, co koncový bod příjmu dat přijal.
- Částečné úspěchy. Koncový bod příjmu dat může přijmout část dávky a odmítnout zbytek. Vývozce zaznamenává položky jako úspěšné a odmítnuté položky, které byly vyřazeny ve stejném intervalu.
- Místní ukládání do vyrovnávací paměti. Když vývozce opakuje pokusy, může později odesílat položky ve vyrovnávací paměti. Čas, kdy statistiky přiřazují vyřazené, opakované nebo úspěšné počty, se vždy neshodují s časem události původní telemetrie.
- Nad kvótou nebo denním limitem. Když prostředek překročí denní limit, koncový bod příjmu vrátí chybu a záznamy vývozce se zahodí. Odpovídající telemetrie aplikace se během okna cap nezobrazuje v protokolech.
- Scope. Statistiky zahrnují chování vývozce. Protokoly zahrnují kompletní telemetrii, včetně polí, která nemají vliv na úspěch vývozce.
Upgrade ze statistik sady Preview SDK
Pokud jste testovali statistiky sady SDK během verze Preview, aktualizujte proměnné prostředí, dotazy, výstrahy a řídicí panely při upgradu na obecnou verzi sady SDK (GA).
Aktualizace proměnných prostředí
- Odeberte proměnnou prostředí
APPLICATIONINSIGHTS_SDKSTATS_ENABLED_PREVIEW. - Nastavte
APPLICATIONINSIGHTS_SDKSTATS_DISABLED=truena zastavení odesílání metrik statistik sady SDK. - Očekává se, že
APPLICATIONINSIGHTS_SDKSTATS_DISABLEDbude mít přednost, pokud jsou nastaveny oběAPPLICATIONINSIGHTS_SDKSTATS_DISABLEDaAPPLICATIONINSIGHTS_SDKSTATS_ENABLED_PREVIEW.
Aktualizace názvů metrik
Verze Preview SDK generují různé názvy metrik. Aktualizujte dotazy protokolu, výstrahy, řídicí panely a grafy, které odkazují na názvy metrik Preview.
| Náhled názvu metriky | Název metriky Google Analytics |
|---|---|
preview.item.success.count |
Item_Success_Count |
preview.item.dropped.count |
Item_Dropped_Count |
preview.item.retry.count |
Item_Retry_Count |
Pracovní sešit statistik SDK agreguje názvy metrik Preview a GA.
Použijte dotazy se smíšenými verzemi během upgradu
Pokud vaše prostředí obsahuje verze Preview i sady GA SDK, použijte dotazy, které agregují obě sady názvů. Po upgradu všech instancí odeberte z dotazů a upozornění názvy metrik předběžné.
let g = 15m;
customMetrics
| where name in (
"Item_Success_Count", "Item_Dropped_Count", "Item_Retry_Count",
"preview.item.success.count", "preview.item.dropped.count", "preview.item.retry.count"
)
| summarize
success = sumif(todouble(value), name in ("Item_Success_Count", "preview.item.success.count")),
dropped = sumif(todouble(value), name in ("Item_Dropped_Count", "preview.item.dropped.count")),
retry = sumif(todouble(value), name in ("Item_Retry_Count", "preview.item.retry.count"))
by bin(timestamp, g)