Logboeken Azure Monitor en diagnostische gegevens verzamelen voor Azure Logic Apps

Artikel
10/23/2021
7 minuten om te lezen

Als u uitgebreidere informatie over debuggen van uw logische apps tijdens runtime wilt krijgen, kunt u Azure Monitor-logboeken instellen en gebruiken om informatie over runtimegegevens en -gebeurtenissen, zoals triggergebeurtenissen, gebeurtenissen en actiegebeurtenissen in een Log Analytics-werkruimte,vast te stellen en op te slaan. Azure Monitor helpt u uw cloud- en on-premises omgevingen te bewaken, zodat u hun beschikbaarheid en prestaties gemakkelijker kunt onderhouden. Met behulp Azure Monitor logboeken kunt u logboekquery's maken die u helpen bij het verzamelen en controleren van deze informatie. U kunt deze diagnostische gegevens ook gebruiken met andere Azure-services,zoals Azure Storage en Azure Event Hubs.

Als u logboekregistratie voor uw logische app wilt instellen, kunt u Log Analyticsinschakelen wanneer u uw logische app maakt. U kunt ook de oplossing Logic Apps Management installeren in uw Log Analytics-werkruimte voor bestaande logische apps. Deze oplossing biedt geaggregeerde informatie voor uw logische app-uitvoeringen en bevat specifieke details, zoals status, uitvoeringstijd, status van opnieuwubmission en correlatie-ID's. Als u logboekregistratie wilt inschakelen en query's wilt maken voor deze informatie, stelt u de logboeken Azure Monitor in.

In dit artikel wordt beschreven hoe u Log Analytics kunt inschakelen voor nieuwe logische apps en bestaande logische apps, hoe u de Logic Apps-beheeroplossing installeert en in stelt, en hoe u query's kunt instellen en maken voor Azure Monitor logboeken.

Vereisten

Voordat u begint, hebt u een Log Analytics-werkruimte nodig. Als u geen werkruimte hebt, leert u hoe u een Log Analytics-werkruimte maakt.

Log Analytics inschakelen voor nieuwe logische apps

Wanneer u uw logische app maakt, kunt u Log Analytics in- of in- of uit- zetten.

Volg in Azure Portalhet deelvenster waar u de informatie op om uw logische app te maken de volgende stappen uit:
1. Selecteer onder Log Analytics de optie Aan.
2. Selecteer in de lijst Log Analytics-werkruimte de werkruimte waar u de gegevens vanuit uw logische app wilt verzenden.
  
  Nadat u deze stap hebt uitgevoerd, maakt Azure uw logische app, die nu is gekoppeld aan uw Log Analytics-werkruimte. Met deze stap wordt ook automatisch de Logic Apps Management-oplossing in uw werkruimte geïnstalleerd.
Selecteer Maken als u klaar bent.
Nadat u uw logische app hebt uitgevoerd, gaat u verder met deze stappen om de runs van uw logische app te bekijken.

Een Logic Apps managementoplossing installeren

Als u Log Analytics hebt ingeschakeld toen u uw logische app maakte, slaat u deze stap over. U hebt de oplossing Logic Apps Management al geïnstalleerd in uw Log Analytics-werkruimte.

Voer in Azure Portalzoekvak van de service log analytics workspaces in en selecteer vervolgens Log Analytics-werkruimten.
Selecteer uw werkruimte onder Log Analytics-werkruimten.
Selecteer in het deelvenster Overzicht onder Aan de slag met Log Analytics > Bewakingsoplossingen configureren de optie Oplossingen weergeven.
Selecteer onder Overzicht de optie Toevoegen.
Nadat Marketplace is geopend, voert u in het zoekvak in logic apps management en selecteert Logic Apps Management.
Selecteer Maken in het deelvenster beschrijving van de oplossing.
Controleer en bevestig de Log Analytics-werkruimte waar u de oplossing wilt installeren en selecteer opnieuw 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.

Azure Monitor-logboeken instellen

Wanneer u informatie over runtimegebeurtenissen en -gegevens opgeslagenin Azure Monitor logboeken, kunt u logboekquery's maken die u helpen bij het vinden en controleren van deze informatie.

Notitie

Nadat u diagnostische instellingen hebt ingeschakeld, worden diagnostische gegevens mogelijk niet tot 30 minuten naar de logboeken op de opgegeven bestemming gestroomd, zoals Log Analytics, Event Hub of opslagaccount. Deze vertraging betekent dat diagnostische gegevens uit deze periode mogelijk niet bestaan om te controleren. Voltooide gebeurtenissen en bij te houden eigenschappen worden mogelijk 10-15 minuten niet weergegeven in uw Log Analytics-werkruimte.

Zoek en selecteer Azure Portallogische app in de Azure Portal.
Selecteer in het menu van uw logische app onder Bewaking de optie Diagnostische instellingen > Diagnostische instelling toevoegen.
Volg deze stappen om de instelling te maken:
1. Geef een naam op voor de instelling.
2. Selecteer Verzenden naar Log Analytics.
3. Selecteer bij Abonnement het Azure-abonnement dat is gekoppeld aan uw Log Analytics-werkruimte.
4. Selecteer voor Log Analytics-werkruimte de werkruimte die u wilt gebruiken.
5. Selecteer onder logboek de categorie WorkflowRuntime, waarmee de gebeurteniscategorie wordt opgegeven die u wilt opnemen.
6. Als u alle metrische gegevens wilt selecteren, selecteert u onder metrische gegevens AllMetrics.
7. Selecteer Opslaan als u klaar bent.
Bijvoorbeeld:

De status van de logische app-runs weergeven

Nadat uw logische app is uitgevoerd, kunt u de gegevens over deze runs bekijken in uw Log Analytics-werkruimte.

Zoek en open Azure PortalLog Analytics-werkruimte in de Azure Portal.
Selecteer in het menu van uw werkruimte Werkruimteoverzicht > Logic Apps Beheer.

Notitie

Als de Logic Apps Management-tegel niet onmiddellijk resultaten laat zien na een run, selecteert u Vernieuwen of wacht u even voordat u het opnieuw probeert.

Hier worden de uitvoeringen van uw logische app gegroepeerd op naam of op uitvoeringsstatus. Op deze pagina worden ook details weergegeven over fouten in acties of triggers voor de logische app-runs.
Als u alle runs voor een specifieke logische app of status wilt weergeven, selecteert u de rij voor die logische app of status.

Hier ziet u een voorbeeld van alle runs voor een specifieke logische app:

Voor acties waarbij u bijgespoorde eigenschappen hebtingesteld, kunt u deze eigenschappen ook weergeven door Weergave te selecteren in de kolom Bijgespoorde eigenschappen. Als u wilt zoeken in de bijgespoorde eigenschappen, gebruikt u het kolomfilter.
Als u de resultaten wilt filteren, kunt u zowel aan de clientzijde als aan de serverzijde filteren.
- Filter aan de clientzijde: Selecteer voor elke kolom de filters die u wilt, bijvoorbeeld:
- Filter aan serverzijde: als u een specifiek tijdvenster wilt selecteren of het aantal weergegeven runs wilt beperken, gebruikt u het bereikbesturingselement boven aan de pagina. Standaard worden er slechts 1000 records tegelijk weergegeven.
Als u alle acties en de details voor een specifieke run wilt weergeven, selecteert u de rij voor het uitvoeren van een logische app.

Hier ziet u een voorbeeld van alle acties en triggers voor het uitvoeren van een specifieke logische app:

Diagnostische gegevens verzenden naar Azure Storage en Azure Event Hubs

Samen met Azure Monitor logboeken kunt u uitbreiden hoe u de diagnostische gegevens van uw logische app gebruikt met andere Azure-services, bijvoorbeeld:

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

Op basis van de locaties waar u diagnostische gegevens wilt verzenden, moet u eerst een Azure-opslagaccount maken of een Azure Event Hub maken. Vervolgens kunt u de bestemmingen selecteren waar u die gegevens wilt verzenden. Bewaarperioden zijn alleen van toepassing wanneer u een opslagaccount gebruikt.

Gegevens verzenden naar een Azure-opslagaccount of Event Hub

Azure Monitor diagnostische gebeurtenissen

Elke diagnostische gebeurtenis heeft details over uw logische app en die gebeurtenis, bijvoorbeeld de status, begintijd, eindtijd, en meer. Als u programmatisch bewaking, tracering en logboekregistratie wilt instellen, kunt u deze informatie gebruiken met de REST API voor Azure Logic Apps en de REST API voor Azure Monitor. U kunt ook de eigenschappen clientTrackingId en trackedProperties gebruiken, die worden weergegeven in

clientTrackingId: Als dit niet wordt opgegeven, genereert Azure deze id automatisch en correleert het gebeurtenissen in een logische app-run, met inbegrip van geneste werkstromen die worden aangeroepen vanuit de logische app. U kunt deze id handmatig opgeven in een trigger door een header met uw aangepaste id-waarde door te geven x-ms-client-tracking-id in de triggeraanvraag. U kunt een aanvraagtrigger, HTTP-trigger of webhooktrigger gebruiken.

trackedProperties: Als u invoer of uitvoer in diagnostische gegevens wilt bijhouden, kunt u een sectie toevoegen aan een actie met behulp van logic app designer of rechtstreeks in de JSON-definitie van uw logische trackedProperties app. Bijgespoorde eigenschappen kunnen slechts de in- en uitvoer van één actie bijhouden, maar u kunt de eigenschappen van gebeurtenissen gebruiken om te correleren tussen acties correlation in een run. Als u meer dan één eigenschap, een of meer eigenschappen, wilt bijhouden, voegt u de sectie en de eigenschappen trackedProperties toe die u aan de actiedefinitie wilt toevoegen.

Hier is een voorbeeld dat laat zien hoe de actiedefinitie Variabele initialiseren bij te houden eigenschappen bevat van de invoer van de actie waarbij de invoer een matrix is, niet een record.

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

In dit voorbeeld worden meerdere bij te houden eigenschappen weergeven:

"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>']"
   }
}

In dit voorbeeld ziet u hoe ActionCompleted de gebeurtenis de kenmerken en clientTrackingId trackedProperties bevat:

{
   "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>"
      }
   }
}