Diagnostische gegevens bewaken en verzamelen voor werkstromen in Azure Logic Apps

Van toepassing op: Azure Logic Apps (verbruik + standaard)

Als u uitgebreidere gegevens wilt voor foutopsporing en diagnose van uw werkstromen in Azure Logic Apps, kunt u runtimegegevens en gebeurtenissen van werkstromen vastleggen, zoals trigger-gebeurtenissen, uitvoerings- en actie-gebeurtenissen, die u kunt verzenden naar een Log Analytics-werkruimte, Azure-opslagaccount, Azure Event Hub, een andere partnerbestemming of al deze bestemmingen wanneer u Azure Monitor-logboeken instelt en gebruikt.

Notitie

Azure Monitor-resourcelogboeken zijn niet 100% verliesloos. Resourcelogboeken zijn gebaseerd op een opslag- en forward-architectuur die is ontworpen om petabytes aan gegevens per dag op schaal te verplaatsen. Deze mogelijkheid omvat ingebouwde redundantie en nieuwe pogingen op het platform, maar biedt geen transactionele garanties. Transactionele bewaking kan de betrouwbaarheid en prestaties van de bewaakte service verminderen. Tijdelijke logboekfouten moeten ook de upstream-service stoppen wanneer de bezorging van het logboek niet kan worden bevestigd. Wanneer het Azure Monitor-team een permanente bron van gegevensverlies kan bevestigen, beschouwt het team oplossing en preventie als de hoogste prioriteit. Kleine gegevensverlies kan echter nog steeds optreden als gevolg van tijdelijke, niet-herhalende serviceproblemen die zijn gedistribueerd over Azure, en niet allemaal kunnen worden opgevangen.

In deze handleiding ziet u hoe u de volgende taken kunt uitvoeren, afhankelijk van of u een logische app-resource Verbruik of Standaard hebt.

Verbruik

1. Bij het maken van logische app verbruik schakelt u Log Analytics in en geeft u uw Log Analytics-werkruimte op.

   -of-

   Voor een bestaande logische app Verbruik installeert u de Logic Apps Management-oplossing in uw Log Analytics-werkruimte. Deze oplossing biedt geaggregeerde informatie voor uw logische app-uitvoeringen en bevat specifieke details, zoals status, uitvoeringstijd, status van opnieuw verzenden en correlatie-id's.

2. Voeg een diagnostische instelling toe om gegevensverzameling in te schakelen.

3. De uitvoeringsstatus van de werkstroom weergeven.

4. Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs.

5. Aangepaste eigenschappen opnemen in telemetrie.

Standard

1. Voeg een diagnostische instelling toe om gegevensverzameling in te schakelen.

2. De uitvoeringsstatus van de werkstroom weergeven.

3. Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs.

4. Aangepaste eigenschappen opnemen in telemetrie.

Vereisten

• Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meld u dan aan voor een gratis Azure-account.

  Voor een logische app-resource verbruik hebt u de machtigingen Eigenaar of Inzender van het Azure-abonnement nodig, zodat u de Logic Apps Management-oplossing kunt installeren vanuit de Azure Marketplace. Zie de volgende documentatie voor meer informatie:

  • Machtiging om te kopen - Azure Marketplace aankoop

  • Azure-rollen, Azure AD-rollen en klassieke abonnementsbeheerdersrollen

• De doelresource voor waar u diagnostische gegevens naartoe wilt verzenden:

  • Een Log Analytics-werkruimte

  • Een Azure-opslagaccount

  • Een Azure Event Hub

• De resource en werkstroom van uw logische app

Log Analytics inschakelen

Verbruik

Voor een logische verbruiks-app moet u eerst Log Analytics inschakelen.

Log Analytics inschakelen bij het maken van een logische app

1. Voer in het Azure Portal in het deelvenster Logische app maken de volgende stappen uit:

   1. Zorg ervoor dat u onder Plannende optie Verbruik selecteert, zodat alleen de opties voor verbruikswerkstromen worden weergegeven.

   2. Selecteer Ja voor Log Analytics inschakelen.

   3. Selecteer in de lijst Log Analytics-werkruimte de werkruimte waarnaar u de gegevens wilt verzenden vanuit de werkstroomuitvoering.

      

2. Voltooi het maken van uw logische app-resource.

   Wanneer u klaar bent, wordt uw logische app gekoppeld aan uw Log Analytics-werkruimte. Met deze stap wordt ook automatisch de Logic Apps Management-oplossing in uw werkruimte geïnstalleerd.

3. Nadat u uw werkstroom hebt uitgevoerd, bekijkt u de uitvoeringsstatus van de werkstroom.

Logic Apps Management-oplossing installeren

Als u Log Analytics hebt ingeschakeld toen u de resource voor de logische app maakte, slaat u deze sectie over. U hebt de Logic Apps Management-oplossing al geïnstalleerd in uw Log Analytics-werkruimte. Ga anders verder met de volgende stappen voor een bestaande logische verbruiks-app:

1. Voer in het zoekvak Azure PortalLog Analytics-werkruimten in en selecteer Log Analytics-werkruimten in de resultaten.

   

2. Selecteer uw werkruimte onder Log Analytics-werkruimten.

   

3. Selecteer in het deelvenster Overzicht onder Aan de slag met Log Analytics>Bewakingsoplossingen configurerende optie Oplossingen weergeven.

   

4. Selecteer onder Overzichtde optie Toevoegen, waarmee u een nieuwe oplossing aan uw werkruimte toevoegt.

5. Nadat de pagina Marketplace is geopend, voert u in het zoekvak Logic Apps Management in en selecteert u Logic Apps Management.

   

6. Selecteer op de tegel Logic Apps Management in de lijst Maken de optie Logic Apps Management.

   

7. Selecteer in het deelvenster Oplossing voor Logic Apps Management (preview) maken de Log Analytics-werkruimte waarin u de oplossing wilt installeren. Selecteer Beoordelen en maken, controleer uw gegevens en selecteer Maken.

   

   Nadat Azure de oplossing heeft geïmplementeerd in de Azure-resourcegroep die uw Log Analytics-werkruimte bevat, wordt de oplossing weergegeven in het overzichtsvenster van uw werkruimte onder Overzicht.

   

Standard

Voor een logische standaard-app kunt u doorgaan met Een diagnostische instelling toevoegen. Er zijn geen andere vereiste stappen nodig om Log Analytics in te schakelen en de oplossing Logic Apps Management is ook niet van toepassing op logische standaard-apps.

Een diagnostische instelling toevoegen

Verbruik

1. Open in de Azure Portal de resource van de logische app Verbruik.

2. Selecteer in het resourcemenu van de logische app onder Bewakingde optie Diagnostische instellingen. Selecteer op de pagina Diagnostische instellingen de optie Diagnostische instelling toevoegen.

   

3. Geef bij Naam van diagnostische instelling de gewenste naam op voor de instelling.

4. Selecteer onder Logboekcategorieën> de optie Diagnostische gebeurtenissen van werkstroomruntime. Selecteer onder Metrische gegevensde optie AlleMetrics.

5. Selecteer onder Doeldetails een of meer bestemmingen, op basis van waar u de logboeken wilt verzenden.

   Doel	Aanwijzingen
   Verzenden naar Log Analytics-werkruimte	Selecteer het Azure-abonnement voor uw Log Analytics-werkruimte en de werkruimte.
   Archiveren naar een opslagaccount	Selecteer het Azure-abonnement voor uw Azure-opslagaccount en het opslagaccount. Zie Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs voor meer informatie.
   Streamen naar een Event Hub	Selecteer het Azure-abonnement voor uw Event Hub-naamruimte, Event Hub en Event Hub-beleidsnaam. Zie Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs- en Azure Monitor-partnerintegraties voor meer informatie.
   Oplossing voor verzenden naar partner	Selecteer uw Azure-abonnement en de bestemming. Zie Overzicht van Azure Native ISV-services voor meer informatie.

   In het volgende voorbeeld wordt een Log Analytics-werkruimte als doel geselecteerd:

   

6. Als u het toevoegen van uw diagnostische instelling wilt voltooien, selecteert u Opslaan.

Standard

1. Open in de Azure Portal de resource voor de logische standaard-app.

2. Selecteer in het resourcemenu van de logische app onder Bewakingde optie Diagnostische instellingen. Selecteer op de pagina Diagnostische instellingende optie Diagnostische instelling toevoegen.

   

3. Geef bij Naam van diagnostische instelling de gewenste naam op voor de instelling.

4. Selecteer onder Logboekcategorieën> de optie Werkstroomruntimelogboeken. Selecteer onder Metrische gegevensde optie AllMetrics.

5. Selecteer onder Doeldetails een of meer bestemmingen, op basis van waar u de logboeken wilt verzenden.

   Doel	Aanwijzingen
   Verzenden naar Log Analytics-werkruimte	Selecteer het Azure-abonnement voor uw Log Analytics-werkruimte en de werkruimte.
   Archiveren naar een opslagaccount	Selecteer het Azure-abonnement voor uw Azure-opslagaccount en het opslagaccount. Zie Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs voor meer informatie.
   Streamen naar een Event Hub	Selecteer het Azure-abonnement voor uw Event Hub-naamruimte, Event Hub en Event Hub-beleidsnaam. Zie Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs- en Azure Monitor-partnerintegraties voor meer informatie.
   Oplossing verzenden naar partner	Selecteer uw Azure-abonnement en de bestemming. Zie Overzicht van Azure Native ISV Services voor meer informatie.

   In het volgende voorbeeld wordt een Log Analytics-werkruimte als doel geselecteerd:

   

6. Als u telemetrie wilt opnemen voor gebeurtenissen zoals Host.Startup, Host.Bindings en Host.LanguageWorkerConfig, selecteert u Desgewenst Functietoepassingslogboeken. Zie Azure Functions bewaken met Azure Monitor-logboeken voor meer informatie.

7. Als u het toevoegen van uw diagnostische instelling wilt voltooien, selecteert u Opslaan.

Azure Logic Apps verzendt nu telemetrie over uw werkstroomuitvoeringen naar uw Log Analytics-werkruimte.

Notitie

Nadat u diagnostische instellingen hebt ingeschakeld, stromen diagnostische gegevens mogelijk niet langer dan 30 minuten naar de logboeken op de opgegeven bestemming, zoals Log Analytics, opslagaccount of Event Hub. Deze vertraging betekent dat diagnostische gegevens uit deze periode mogelijk niet door u kunnen worden gecontroleerd. Voltooide gebeurtenissen en bijgehouden eigenschappen worden mogelijk 10-15 minuten niet weergegeven in uw Log Analytics-werkruimte.

Uitvoeringsstatus van werkstroom weergeven

Verbruik

Nadat uw werkstroom is uitgevoerd, kunt u de gegevens over deze uitvoeringen bekijken in uw Log Analytics-werkruimte.

1. Open in de Azure Portal uw Log Analytics-werkruimte.

2. Selecteer in het werkruimtemenu onder Klassiek de optie Werkruimteoverzicht. Selecteer Logic Apps Management op de pagina Overzicht.

   Notitie

   Als op de tegel Logic Apps Management na een uitvoering niet direct resultaten worden weergegeven, selecteert u Vernieuwen of wacht u even voordat u het opnieuw probeert.

   

   Op de overzichtspagina ziet u werkstromen gegroepeerd op naam of op uitvoeringsstatus. De pagina bevat ook details over fouten in de acties of triggers voor de werkstroomuitvoeringen.

   

3. Als u alle uitvoeringen voor een specifieke werkstroom of status wilt weergeven, selecteert u de rij voor die werkstroom of status.

   In dit voorbeeld ziet u alle uitvoeringen voor een specifieke werkstroom:

   

   Voor acties waarbij u bijgehouden eigenschappen hebt toegevoegd, kunt u zoeken naar de bijgehouden eigenschappen met behulp van het kolomfilter. Als u de eigenschappen wilt weergeven, selecteert u Weergave in de kolom Bijgehouden eigenschappen.

   

4. Als u uw resultaten wilt filteren, kunt u filteren op zowel client- als serverzijde.

   • Filter aan clientzijde: selecteer voor elke kolom de gewenste filters, bijvoorbeeld:

     

   • Filter aan de serverzijde: als u een specifiek tijdvenster wilt selecteren of het aantal uitvoeringen wilt beperken dat wordt weergegeven, gebruikt u het bereikbesturingselement boven aan de pagina. Standaard worden er slechts 1000 records tegelijk weergegeven.

     

5. Als u alle acties en de bijbehorende details voor een specifieke uitvoering wilt weergeven, selecteert u de rij voor het uitvoeren van een werkstroom van een logische app.

   In het volgende voorbeeld ziet u hoe alle acties en triggers voor een specifieke werkstroom van een logische app worden uitgevoerd:

   

Standard

1. Open in de Azure Portal uw Log Analytics-werkruimte.

2. Selecteer Logboeken in het navigatiemenu van de werkruimte.

3. Vouw op het nieuwe querytabblad in de linkerkolom onder Tabellen de optie LogManagement uit en selecteer LogicAppWorkflowRuntime.

   In het rechterdeelvenster onder Resultaten toont de tabel records die betrekking hebben op de volgende gebeurtenissen:

   • WorkflowRunStarted
   • WorkflowRunCompleted
   • WorkflowTriggerStarted
   • WorkflowTriggerEnded
   • WorkflowActionStarted
   • WorkflowActionCompleted
   • WorkflowBatchMessageSend
   • WorkflowBatchMessageRelease

   Voor voltooide gebeurtenissen publiceert de kolom EndTime de tijdstempel voor wanneer deze zijn voltooid. Deze waarde helpt u bij het bepalen van de duur tussen de start-gebeurtenis en de voltooide gebeurtenis.

   

Voorbeeldquery's

In het queryvenster van uw Log Analytics-werkruimte kunt u uw eigen query's invoeren om specifieke gegevens te zoeken, bijvoorbeeld:

• Selecteer alle gebeurtenissen voor een specifieke werkstroomuitvoerings-id:

  LogicAppWorkflowRuntime
  | where RunId == "08585258189921908774209033046CU00"
  

• Alle uitzonderingen weergeven:

  LogicAppWorkflowRuntime
  | where Error != ""
  | sort by StartTime desc
  

• Acties identificeren waarvoor nieuwe pogingen zijn opgetreden:

  LogicAppWorkflowRuntime
  | where RetryHistory != ""
  | sort by StartTime desc 
  

Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs

Samen met Azure Monitor-logboeken kunt u de verzamelde gegevens verzenden naar andere bestemmingen, bijvoorbeeld:

• Azure-resourcelogboeken archiveren naar opslagaccount
• Azure-platformlogboeken streamen naar Azure Event Hubs

Vervolgens kunt u realtime bewaking krijgen met behulp van telemetrie en analyses van andere services, zoals Azure Stream Analytics en Power BI, bijvoorbeeld:

• Gegevens streamen van Event Hubs naar Stream Analytics
• Streaminggegevens analyseren met Stream Analytics en een realtime analysedashboard maken in Power BI

Notitie

Bewaarperioden zijn alleen van toepassing wanneer u een opslagaccount gebruikt.

Aangepaste eigenschappen opnemen in telemetrie

In uw werkstroom hebben triggers en acties de mogelijkheid om de volgende aangepaste eigenschappen toe te voegen, zodat hun waarden samen met de verzonden telemetrie worden weergegeven in uw Log Analytics-werkruimte.

Aangepaste tracerings-id

De meeste triggers hebben een aangepaste tracerings-id-eigenschap waarmee u een tracerings-id kunt opgeven met behulp van een expressie. U kunt deze expressie gebruiken om gegevens op te halen uit de nettolading van het ontvangen bericht of om unieke waarden te genereren, bijvoorbeeld:

Als u deze aangepaste tracerings-id niet opgeeft, wordt deze id automatisch door Azure gegenereerd en worden gebeurtenissen in een werkstroomuitvoering gecorreleerd, inclusief geneste werkstromen die worden aangeroepen vanuit de bovenliggende werkstroom. U kunt deze id handmatig opgeven in een trigger door een x-ms-client-tracking-id header door te geven met uw aangepaste id-waarde in de triggeraanvraag. U kunt een aanvraagtrigger, HTTP-trigger of webhook-trigger gebruiken.

Verbruik

Standard

Bijgehouden eigenschappen

Acties hebben een sectie Bijgehouden eigenschappen waarin u een aangepaste eigenschapsnaam en -waarde kunt opgeven door een expressie of vastgelegde waarde in te voeren om specifieke invoer of uitvoer bij te houden, bijvoorbeeld:

Verbruik

Standard

Bijgehouden eigenschappen kunnen slechts de invoer en uitvoer van één actie bijhouden, maar u kunt de correlation eigenschappen van gebeurtenissen gebruiken om verschillende acties in een werkstroomuitvoering te correleren.

Bijgehouden eigenschappen kunnen alleen verwijzen naar de parameters, invoer en uitvoer voor de eigen trigger of actie.

Bijgehouden eigenschappen zijn niet toegestaan voor een trigger of actie met beveiligde invoer, beveiligde uitvoer of beide. Ze mogen ook niet verwijzen naar een andere trigger of actie met beveiligde invoer, beveiligde uitvoer of beide.

In de volgende voorbeelden ziet u waar aangepaste eigenschappen worden weergegeven in uw Log Analytics-werkruimte:

Verbruik

1. Selecteer in het menu van uw Log Analytics-werkruimte onder Klassiekde optie Werkruimteoverzicht. Selecteer Logic Apps Management op de pagina Overzicht.

2. Selecteer de rij voor de werkstroom die u wilt controleren.

3. Zoek op de pagina Uitvoeringen in de tabel Logic App Runs de kolom Tracerings-id en de kolom Bijgehouden eigenschappen .

   

4. Als u de bijgehouden eigenschappen wilt doorzoeken, gebruikt u het kolomfilter. Als u de eigenschappen wilt weergeven, selecteert u Beeld.

   

Standard

De aangepaste tracerings-id wordt weergegeven in de kolom ClientTrackingId en bijgehouden eigenschappen worden weergegeven in de kolom TrackedProperties , bijvoorbeeld:

Volgende stappen

• Bewakings- en traceringsquery's maken
• B2B-berichten bewaken met Azure Monitor-logboeken