Konfigurera Azure Monitor loggar och samla in diagnostikdata för Azure Logic Apps

  • Artikel
  • 6 minuter för att läsa

För att få mer omfattande felsökningsinformation om dina logikappar under körning kan du konfigurera och använda Azure Monitor-loggar för att registrera och lagra information om körningsdata och händelser, till exempel utlösarhändelser, körningshändelser och åtgärdshändelser på en Log Analytics-arbetsyta. Azure Monitor hjälper dig att övervaka dina molnmiljöer och lokala miljöer så att du enklare kan underhålla deras tillgänglighet och prestanda. Med hjälp Azure Monitor loggar kan du skapa loggfrågor som hjälper dig att samla in och granska den här informationen. Du kan också använda dessa diagnostikdata med andra Azure-tjänster,till exempel Azure Storage och Azure Event Hubs.

Om du vill konfigurera loggning för logikappen kan du aktivera Log Analyticsnär du skapar logikappen, eller så kan du installera Logic Apps Management-lösningen på Log Analytics-arbetsytan för befintliga logikappar. Den här lösningen tillhandahåller aggregerad information för logikappkörningar och innehåller specifik information som status, körningstid, status för återsändning och korrelations-ID: er. Om du sedan vill aktivera loggning och skapa frågor för den här informationen måste du konfigurera Azure Monitor loggar.

Den här artikeln visar hur du aktiverar Log Analytics på nya logikappar och befintliga logikappar, hur du installerar och ställer in Logic Apps Management-lösningen och hur du ställer in och skapar frågor för Azure Monitor loggar.

Förutsättningar

Innan du börjar behöver du en Log Analytics-arbetsyta. Om du inte har en arbetsyta kan du lära dig hur du skapar en Log Analytics-arbetsyta.

Aktivera Log Analytics för nya logikappar

Du kan aktivera Log Analytics när du skapar logikappen.

  1. I fönstret Azure Portaldär du anger information för att skapa logikappen gör du följande:

    1. Under Log Analytics väljer du På.

    2. I listan Log Analytics-arbetsyta väljer du den arbetsyta där du vill skicka data från logikappen som körs.

      Ange information om din logikapp

      När du är klar med det här steget skapar Azure din logikapp, som nu är associerad med Log Analytics-arbetsytan. Det här steget installerar även automatiskt Logic Apps management-lösningen på din arbetsyta.

  2. När du är färdig väljer du Skapa.

  3. Om du vill visa dina logikappkörningar när du har kört logikappen fortsätter du med de här stegen.

Installera Logic Apps Management-lösning

Om du har aktiverat Log Analytics när du skapade logikappen kan du hoppa över det här steget. Du har redan Logic Apps management-lösningen installerad på Log Analytics-arbetsytan.

  1. I Azure Portalsökrutan anger du log analytics workspaces och väljer sedan Log Analytics-arbetsytor.

    Välj "Log Analytics-arbetsytor"

  2. Under Log Analytics-arbetsytor väljer du din arbetsyta.

    Välj din Log Analytics-arbetsyta

  3. I fönstret Översikt under Kom igång med Log Analytics Konfigurera > övervakningslösningar väljer du Visa lösningar.

    I översiktsfönstret väljer du "Visa lösningar"

  4. Under Översikt väljer du Lägg till.

    Lägg till en ny lösning i översiktsfönstret

  5. När Marketplace har öppnats skriver du i sökrutan logic apps management och väljer Logic Apps Hantering.

    Från Marketplace väljer du "Logic Apps Management" (Logic Apps Management)

  6. I lösningsbeskrivningsfönstret väljer du Skapa.

    Välj "Skapa" för att lägga till Logic Apps hanteringslösning

  7. Granska och bekräfta Log Analytics-arbetsytan där du vill installera lösningen och välj Skapa igen.

    Välj "Skapa" för "Logic Apps Management"

    När Azure har distribuerat lösningen till den Azure-resursgrupp som innehåller Log Analytics-arbetsytan visas lösningen i arbetsytans sammanfattningsfönster.

    Sammanfattningsfönster för arbetsyta

Konfigurera Azure Monitor loggar

När du lagrar information om körningshändelser och data Azure Monitor loggarkan du skapa loggfrågor som hjälper dig att hitta och granska den här informationen.

Anteckning

När du aktiverar diagnostikinställningar kanske diagnostikdata inte flödar på upp till 30 minuter till loggarna på det angivna målet, till exempel Log Analytics, händelsehubb eller lagringskonto. Den här fördröjningen innebär att diagnostikdata från den här tidsperioden kanske inte finns att granska. Slutförda händelser och spårade egenskaper kanske inte visas på Log Analytics-arbetsytan på 10–15 minuter.

  1. I Azure Portaldu och väljer din logikapp.

  2. På logikappmenyn går du till Övervakning och väljer Diagnostikinställningar Lägg till > diagnostikinställning.

    Under "Övervakning" väljer du "Diagnostikinställningar" > "Lägg till diagnostikinställning"

  3. Följ dessa steg för att skapa inställningen:

    1. Ange ett namn för inställningen.

    2. Välj Skicka till Log Analytics.

    3. För Prenumeration väljer du den Azure-prenumeration som är associerad med Log Analytics-arbetsytan.

    4. För Log Analytics-arbetsyta väljer du den arbetsyta som du vill använda.

    5. Under loggen väljer du kategorin WorkflowRuntime, som anger den händelsekategori som du vill spela in.

    6. Om du vill välja alla mått går du till måttet och väljer AllMetrics.

    7. När du är klar väljer du Spara.

    Ett exempel:

    Välj Log Analytics-arbetsyta och data för loggning

Visa status för logikappkörningar

När logikappen har körs kan du visa data om dessa körningar på Log Analytics-arbetsytan.

  1. I Azure Portaldu och öppnar Log Analytics-arbetsytan.

  2. På arbetsytans meny väljer du Arbetsytesammanfattning > Logic Apps Hantering.

    Körningsstatus och antal för logikapp

    Anteckning

    Om panelen Logic Apps management inte omedelbart visar resultat efter en körning kan du prova att välja Uppdatera eller vänta en kort stund innan du försöker igen.

    Här grupperas dina logikappkörningar efter namn eller körningsstatus. Den här sidan visar också information om fel i åtgärder eller utlösare för logikappen som körs.

    Statussammanfattning för dina logikappkörningar

  3. Om du vill visa alla körningar för en specifik logikapp eller status väljer du raden för den logikappen eller statusen.

    Här är ett exempel som visar alla körningar för en specifik logikapp:

    Visa logikappkörningar och status

    För åtgärder där du ställer in spårade egenskaperkan du också visa dessa egenskaper genom att välja Visa i kolumnen Spårade egenskaper. Om du vill söka efter spårade egenskaper använder du kolumnfiltret.

    Visa spårade egenskaper för en logikapp

  4. Om du vill filtrera resultaten kan du utföra filtrering på både klientsidan och serversidan.

    • Filter på klientsidan: För varje kolumn väljer du de filter som du vill ha, till exempel:

      Exempel på kolumnfilter

    • Filter på serversidan: Om du vill välja ett specifikt tidsfönster eller begränsa antalet körningar som visas använder du omfångskontrollen överst på sidan. Som standard visas endast 1 000 poster i taget.

      Ändra tidsfönstret

  5. Om du vill visa alla åtgärder och deras information för en specifik körning väljer du raden för en logikappkörning.

    Här är ett exempel som visar alla åtgärder och utlösare för en specifik logikappkörning:

    Visa åtgärder för en logikappkörning

Skicka diagnostikdata till Azure Storage och Azure Event Hubs

Tillsammans med Azure Monitor-loggar kan du utöka hur du använder logikappens diagnostikdata med andra Azure-tjänster, till exempel:

Du kan sedan få realtidsövervakning med hjälp av telemetri och analys från andra tjänster, till exempel Azure Stream Analytics och Power BI. Ett exempel:

Baserat på de platser där du vill skicka diagnostikdata ser du till att du först skapar ett Azure Storage-konto eller skapar en Azure-händelsehubb. Du kan sedan välja de mål där du vill skicka dessa data. Kvarhållningsperioder gäller bara när du använder ett lagringskonto.

Skicka data till Ett Azure Storage-konto eller en händelsehubb

Azure Monitor diagnostikhändelser

Varje diagnostikhändelse innehåller information om din logikapp och den händelsen, till exempel status, starttid, sluttid och så vidare. Om du vill konfigurera övervakning, spårning och loggning programmässigt kan du använda den här informationen med REST API för Azure Logic Apps och REST API för Azure Monitor. Du kan också använda egenskaperna clientTrackingId trackedProperties och som visas i

  • clientTrackingId: Om det inte anges genererar Azure automatiskt detta ID och korrelerar händelser i en logikappkörning, inklusive alla kapslade arbetsflöden som anropas från logikappen. Du kan ange detta ID manuellt i en utlösare genom att skicka en x-ms-client-tracking-id rubrik med ditt anpassade ID-värde i utlösarbegäran. Du kan använda en begärandeutlösare, HTTP-utlösare eller webhook-utlösare.

  • trackedProperties: Om du vill spåra indata eller utdata i diagnostikdata kan du lägga till ett avsnitt i en åtgärd antingen med hjälp av Logikappdesignern eller direkt i trackedProperties logikappens JSON-definition. Spårade egenskaper kan bara spåra indata och utdata för en enskild åtgärd, men du kan använda egenskaperna för händelser för att correlation korrelera mellan åtgärder i en körning. Om du vill spåra fler än en egenskap, en eller flera egenskaper, lägger du till trackedProperties avsnittet och de egenskaper som du vill använda i åtgärdsdefinitionen.

    Här är ett exempel som visar hur åtgärdsdefinitionen Initiera variabel innehåller spårade egenskaper från åtgärdens indata där indata är en matris, inte en post.

    {
   "Initialize_variable": {
      "type": "InitializeVariable",
      "inputs": {
         "variables": [
            {
               "name": "ConnectorName", 
               "type": "String", 
               "value": "SFTP-SSH" 
            }
         ]
      },
      "runAfter": {},
      "trackedProperties": { 
         "myTrackedPropertyName": "@action().inputs.variables[0].value"
      }
   }
}

    Det här exemplet visar flera spårade egenskaper:

    "HTTP": {
   "type": "Http",
   "inputs": {
      "body": "@triggerBody()",
      "headers": {
         "Content-Type": "application/json"
      },
      "method": "POST",
      "uri": "http://store.fabrikam.com",
   },
   "runAfter": {},
   "trackedProperties": {
      "myActionHTTPStatusCode": "@action()['outputs']['statusCode']",
      "myActionHTTPValue": "@action()['outputs']['body']['<content>']",
      "transactionId": "@action()['inputs']['body']['<content>']"
   }
}

Det här exemplet visar ActionCompleted hur händelsen innehåller clientTrackingId attributen och trackedProperties :

{
   "time": "2016-07-09T17:09:54.4773148Z",
   "workflowId": "/subscriptions/XXXXXXXXXXXXXXX/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp",
   "resourceId": "/subscriptions/<subscription-ID>/resourceGroups/MyResourceGroup/providers/Microsoft.Logic/workflows/MyLogicApp/runs/<run-ID>/actions/Http",
   "category": "WorkflowRuntime",
   "level": "Information",
   "operationName": "Microsoft.Logic/workflows/workflowActionCompleted",
   "properties": {
      "$schema": "2016-06-01",
      "startTime": "2016-07-09T17:09:53.4336305Z",
      "endTime": "2016-07-09T17:09:53.5430281Z",
      "status": "Succeeded",
      "code": "OK",
      "resource": {
         "subscriptionId": "<subscription-ID>",
         "resourceGroupName": "MyResourceGroup",
         "workflowId": "<logic-app-workflow-ID>",
         "workflowName": "MyLogicApp",
         "runId": "08587361146922712057",
         "location": "westus",
         "actionName": "Http"
      },
      "correlation": {
         "actionTrackingId": "e1931543-906d-4d1d-baed-dee72ddf1047",
         "clientTrackingId": "<my-custom-tracking-ID>"
      },
      "trackedProperties": {
         "myTrackedPropertyName": "<value>"
      }
   }
}

Nästa steg