Felsöka Azure Stream Analytics med hjälp av resursloggar

Ibland kan ett Azure Stream Analytics-jobb oväntat avbryta bearbetningen. Fel kan inträffa på grund av ett oväntat frågeresultat, enhetsanslutningar eller ett oväntat tjänstavbrott. Resursloggarna i Azure Stream Analytics kan hjälpa dig att identifiera orsaken till dessa fel och minska återställningstiden.

Aktivera resursloggar för alla Stream Analytics-jobb för att hjälpa till med felsökning och övervakning.

Loggtyper i Stream Analytics

Stream Analytics erbjuder två typer av loggar:

  • Aktivitetsloggar (alltid på) som ger insikter om åtgärder som utförs på jobb.

  • Resursloggar (kan konfigureras) som ger bättre insikter om allt som händer med ett jobb. Resursloggarna startar när jobbet skapas och slutar när jobbet tas bort. De omfattar händelser när jobbet uppdateras och medan det körs.

Kommentar

Du kan använda tjänster som Azure Storage, Azure Event Hubs och Azure Monitor-loggar för att analysera icke-konforma data. Du debiteras baserat på prismodellen för dessa tjänster.

Kommentar

Den här artikeln uppdaterades nyligen för att använda termen Azure Monitor-loggar i stället för Log Analytics. Loggdata lagras fortfarande på en Log Analytics-arbetsyta och samlas fortfarande in och analyseras av samma Log Analytics-tjänst. Vi uppdaterar terminologin för att bättre återspegla loggarnas roll i Azure Monitor. Mer information finns i Terminologiändringar i Azure Monitor.

Felsöka Stream Analytics-jobb med hjälp av aktivitetsloggar

Aktivitetsloggar är aktiverade som standard och ger insikter på hög nivå om åtgärder som utförs av ditt Stream Analytics-jobb. Information som finns i aktivitetsloggar kan hjälpa dig att hitta rotorsaken till de problem som påverkar ditt jobb. Följ dessa steg om du vill använda aktivitetsloggar i Stream Analytics:

  1. Logga in på Azure Portal och välj Aktivitetslogg under Översikt.

    Skärmbild av sidan Aktivitetslogg för ett Stream Analytics-jobb i Azure-portalen.

  2. Du kan se en lista över åtgärder som har utförts. Alla åtgärder som gjorde att jobbet misslyckades har en röd informationsbubbla.

  3. Välj en åtgärd för att se dess sammanfattningsvy. Informationen här är ofta begränsad. Om du vill veta mer om åtgärden väljer du JSON.

    Skärmbild av åtgärdssammanfattningsvyn i aktivitetsloggen för ett Stream Analytics-jobb.

  4. Rulla ned till avsnittet Egenskaper i JSON, som innehåller information om felet som orsakade den misslyckade åtgärden. I det här exemplet berodde felet på ett körningsfel som orsakades av latitudvärden utanför det giltiga intervallet. En avvikelse i de data som ett Stream Analytics-jobb bearbetar orsakar ett datafel. Du kan lära dig mer om olika indata- och utdatafel och varför de inträffar.

    Skärmbild av avsnittet JSON-egenskaper som visar felinformation för en misslyckad åtgärd.

  5. Vidta korrigerande åtgärder baserat på felmeddelandet i JSON. I det här exemplet lägger du till kontroller för att säkerställa att latitudvärdet är mellan -90 grader och 90 grader.

  6. Om felmeddelandet i aktivitetsloggarna inte hjälper dig att identifiera grundorsaken, aktiverar du resursloggar och använder Azure Monitor-loggar.

Skicka diagnostik för Stream Analytics till Azure Monitor-loggar

Aktivera resursloggar och skicka dem till Azure Monitor loggar. Resursloggar är inaktiverade som standard.

  1. Skapa en Log Analytics-arbetsyta om du inte redan har en. Placera din Log Analytics arbetsyta i samma region som ditt Stream Analytics-jobb.

  2. Logga in på Azure Portal och navigera till ditt Stream Analytics-jobb. Under Övervakning väljer du Diagnostikloggar. Välj sedan Aktivera diagnostik.

    Skärmbild som visar navigeringen till resursloggar.

  3. Ange ett namn i Namn på diagnostikinställning och markera kryssrutorna för Körning och Redigering under loggar, och AllMetrics under mått. Välj sedan Skicka till Log Analytics och välj din arbetsyta. Välj Spara.

    Skärmbild av sidan diagnostikinställningar för att konfigurera resursloggar i ett Stream Analytics-jobb.

  4. När Stream Analytics-jobbet startar dirigeras resursloggar till Din Log Analytics-arbetsyta. Om du vill visa resursloggar för ditt jobb väljer du Loggar under avsnittet Övervakning .

    Skärmbild som visar menyn Allmänt med Loggar markerat.

  5. Stream Analytics tillhandahåller fördefinierade frågor som gör att du enkelt kan söka efter loggarna som du är intresserad av. Du kan välja fördefinierade frågor i det vänstra fönstret och sedan välja Kör. Du ser resultatet av frågan i det nedre fönstret.

    Skärmbild som visar sidan Loggar för ett Stream Analytics-jobb.

Kategorier för resursloggar i Stream Analytics

Azure Stream Analytics samlar in två kategorier av resursloggar:

  • Redigering: Samlar in logghändelser som är relaterade till jobbredigeringsåtgärder, till exempel jobbskapande, tillägg och borttagning av indata och utdata, tillägg och uppdatering av frågan samt start eller stopp av jobbet.

  • Körning: Samlar in händelser som inträffar under jobbkörningen.

    • Anslutningsfel
    • Databearbetningsfel, inklusive:
      • Händelser som inte överensstämmer med frågedefinitionen (felmatchade fälttyper och värden, saknade fält och så vidare)
      • Fel vid utvärdering av uttryck
    • Andra händelser och fel

Alla loggar lagras i JSON-format. Mer information om schemat för resursloggar finns i Schema för resursloggar.

Nästa steg

  • Last updated on