Použití Azure Application Insights v Tvůrci rozhraní Data API

Diagram posloupnosti průvodce nasazením, včetně těchto umístění, v uvedeném pořadí: Přehled, Plán, Příprava, Publikování, Monitorování a Optimalizace Umístění 'Monitor' je aktuálně zvýrazněné.

Azure Application Insights je služba poskytovaná Microsoft Azure, která vývojářům umožňuje monitorovat a získávat přehled o výkonu a využití svých aplikací. Tento průvodce ukazuje, jak povolit Application Insights pro Data API Builder (DAB). Pomocí Application Insights můžete sledovat dostupnost aplikací, dobu odezvy, metriky výkonu, chování uživatelů a další užitečné metriky.

Požadavky

Varování

Application Insights pro Tvůrce rozhraní DATA API se nepodporuje při hostování Tvůrce rozhraní DATA API ve webových aplikacích Azure App Service.

• Spuštěné řešení pomocí Tvůrce rozhraní Data API

Aktualizace konfiguračního souboru

Nejprve byste měli do existujícího konfiguračního souboru přidat oddíl application-insights. Tato část obsahuje přihlašovací údaje potřebné k připojení DAB k Application Insights.

1. Vyhledejte a otevřete existující konfigurační soubor pro vaše řešení DAB.

2. V části runtime konfiguračního souboru přidejte oddíl telemetry s následujícími vlastnostmi.

   	Popis
   enabled	Povolí nebo zakáže Application Insights.
   connection-string	Připojovací řetězec pro instanci Application Insights

   {
       "runtime": {
       ...
       "telemetry": {
           "application-insights": {
           "enabled": true,
           "connection-string": "@env('app-insights-connection-string')"
           }
       },
       ...
       }
   }
   

   Spropitné

   Případně můžete pomocí rozhraní příkazového řádku DAB přidat telemetrii:

   dab add-telemetry --app-insights-enabled true --app-insights-conn-string "@env('app-insights-connection-string')"
   

   Poznámka

   Tato ukázka předpokládá, že váš hostitel má proměnnou prostředí s názvem app-insights-connection-string s připojovacím řetězcem. Další informace o načtení připojovacího řetězce najdete v tématu připojovací řetězce služby Azure Monitor.

3. Uložte konfigurační soubor a znovu nasaďte řešení.

Přezkoumání metrik

Když ve své aplikaci povolíte Application Insights, začne okamžitě odesílat data do služby Application Insights.

1. Na webu Azure Portal přejděte k prostředku Application Insights (https://portal.azure.com).

2. Projděte si následující typy dat zachycených službou Application Insights o vašem řešení DAB.

   	Popis
   vyžádání telemetrie	Informace o každém příchozím požadavku daB, jako je adresa URL, doba odezvy a stavový kód
   trasování telemetrie	Protokoly generované systémem DAB
   telemetrie výjimek	Informace o všech výjimkách nebo chybách, ke kterým dochází v JAZYCE DAB
   Čítače výkonu	Metriky související s výkonem DAB, jako je využití procesoru, využití paměti a síťový provoz

   Poznámka

   Protokoly odesílané do Application Insights jsou stejné jako protokoly vytištěné tvůrcem rozhraní DATA API v konzole.

3. Na stránce Application Insights přejděte do sekce Protokoly. Zkontrolujte protokoly pomocí tohoto dotazu.

   traces
   | order by timestamp
   

4. Zkontrolujte výsledky dotazu. LogLevel se mapuje na úrovně závažnosti pomocí této tabulky.

   LogLevel	Úroveň závažnosti	Hodnota úrovně závažnosti
   Stopa	Užvaněný	0
   Ladění	Užvaněný	0
   Informace	Informace	1
   Varování	Varování	2
   Chyba	Chyba	3
   Kritický	Kritický	4

   Rada

   Nastavte stávající úroveň protokolu pomocí možnosti --LogLevel pro příkazové rozhraní DAB (CLI). V opačném případě režim hostitele v konfiguračním souboru určuje minimální úroveň protokolu. Pokud je režim hostitele nastaven na Production, minimální úroveň protokolu je Error. V režimu hostitele Development je minimální úroveň protokolu Debug.

5. Přejděte na stránku Live Metrics.

   

6. Pomocí tohoto dotazu zkontrolujte požadavky na aplikace.

   requests
   | order by timestamp
   

   

7. Vyjmenujte výjimky pomocí stránky Výjimky aplikace.

   exceptions
   | order by timestamp
   

   

Další krok

osvědčené postupy konfigurace