Diagnostische gegevens in Durable Functions in Azure

Artikel
01/31/2024

Er zijn verschillende opties voor het diagnosticeren van problemen met Durable Functions. Sommige van deze opties zijn hetzelfde voor gewone functies en sommige zijn uniek voor Durable Functions.

Analyses van toepassingen

Application Insights is de aanbevolen manier om diagnostische gegevens en bewaking uit te voeren in Azure Functions. Hetzelfde geldt voor Durable Functions. Zie Azure Functions bewaken voor een overzicht van het gebruik van Application Insights in uw functie-app.

De Durable Extension van Azure Functions verzendt ook traceringsgebeurtenissen waarmee u de end-to-end uitvoering van een indeling kunt traceren. Deze traceringsgebeurtenissen kunnen worden gevonden en opgevraagd met behulp van het Application Insights Analytics-hulpprogramma in Azure Portal.

Traceringsgegevens

Elke levenscyclus-gebeurtenis van een indelingsexemplaar zorgt ervoor dat een traceringsevenement naar de traceringsverzameling in Application Insights wordt geschreven. Deze gebeurtenis bevat een customDimensions-nettolading met verschillende velden. Veldnamen worden allemaal voorafgegaan door prop__.

hubName: de naam van de taakhub waarin uw indelingen worden uitgevoerd.
appName: de naam van de functie-app. Dit veld is handig wanneer u meerdere functie-apps hebt die hetzelfde Application Insights-exemplaar delen.
slotName: de implementatiesite waarin de huidige functie-app wordt uitgevoerd. Dit veld is handig wanneer u implementatiesites gebruikt om uw indelingen te versiebeheer.
functionName: de naam van de orchestrator- of activiteitsfunctie.
functionType: het type van de functie, zoals Orchestrator of Activity.
instanceId: de unieke id van het orchestration-exemplaar.
status: de uitvoeringsstatus van de levenscyclus van het exemplaar. Geldige waarden zijn:
- Gepland: De functie is gepland voor uitvoering, maar is nog niet gestart.
- Gestart: De functie is gestart, maar is nog niet in afwachting of voltooid.
- Wacht op: De orchestrator heeft wat werk gepland en wacht totdat het is voltooid.
- Luisteren: De orchestrator luistert naar een melding van een externe gebeurtenis.
- Voltooid: De functie is voltooid.
- Mislukt: de functie is mislukt met een fout.
reden: Aanvullende gegevens die zijn gekoppeld aan de tracerings gebeurtenis. Als een exemplaar bijvoorbeeld wacht op een melding van een externe gebeurtenis, geeft dit veld de naam aan van de gebeurtenis waarop wordt gewacht. Als een functie is mislukt, bevat dit veld de foutdetails.
isReplay: Booleaanse waarde die aangeeft of de traceringsgebeurtenis voor opnieuw afgespeelde uitvoering is.
extensionVersion: de versie van de Durable Task-extensie. De versie-informatie is vooral belangrijke gegevens wanneer mogelijke fouten in de extensie worden gerapporteerd. Langlopende exemplaren kunnen meerdere versies rapporteren als er een update plaatsvindt terwijl deze wordt uitgevoerd.
sequenceNumber: uitvoeringsreeksnummer voor een gebeurtenis. In combinatie met de tijdstempel kunt u de gebeurtenissen orden op uitvoeringstijd. Houd er rekening mee dat dit getal opnieuw wordt ingesteld op nul als de host opnieuw wordt opgestart terwijl het exemplaar wordt uitgevoerd, dus het is belangrijk dat u altijd eerst sorteert op tijdstempel en vervolgens sequenceNumber.

De uitgebreidheid van traceringsgegevens die naar Application Insights worden verzonden, kan worden geconfigureerd in de logger sectie (Functions 1.x) of logging (Functions 2.0) van het host.json bestand.

Functions 1.0

{
    "logger": {
        "categoryFilter": {
            "categoryLevels": {
                "Host.Triggers.DurableTask": "Information"
            }
        }
    }
}

Functions 2.0

{
    "logging": {
        "logLevel": {
            "Host.Triggers.DurableTask": "Information",
        },
    }
}

Standaard worden alle niet-herhalingstraceringsgebeurtenissen verzonden. Het volume aan gegevens kan worden verminderd door het instellen Host.Triggers.DurableTask van of "Warning" "Error" in welk geval het bijhouden van gebeurtenissen alleen wordt verzonden voor uitzonderlijke situaties. Als u het verzenden van de uitgebreide indelingsherplay-gebeurtenissen wilt inschakelen, stelt u het logReplayEvents true in op in het host.json configuratiebestand.

Notitie

Application Insights-telemetrie wordt standaard door de Azure Functions-runtime gemonsterd om te voorkomen dat gegevens te vaak worden verzonden. Dit kan ertoe leiden dat traceringsgegevens verloren gaan wanneer veel levenscyclusgebeurtenissen zich in een korte periode voordoen. In het artikel Azure Functions Monitoring wordt uitgelegd hoe u dit gedrag configureert.

Invoer en uitvoer van orchestrator-, activiteits- en entiteitsfuncties worden niet standaard geregistreerd. Dit standaardgedrag wordt aanbevolen omdat de invoer en uitvoer van logboekregistratie de Kosten van Application Insights kunnen verhogen. Functie-invoer- en uitvoerladingen kunnen ook gevoelige informatie bevatten. In plaats daarvan wordt het aantal bytes voor functie-invoer en -uitvoer vastgelegd in plaats van de werkelijke nettoladingen. Als u de Durable Functions-extensie de volledige nettoladingen voor invoer en uitvoer wilt registreren, stelt u de traceInputsAndOutputs eigenschap true in op het host.json configuratiebestand.

Query voor één exemplaar

In de volgende query ziet u historische traceringsgegevens voor één exemplaar van de hello sequence-functieindeling . Het is geschreven met behulp van de Kusto-querytaal. Hiermee wordt de uitvoering van herhalingen gefilterd, zodat alleen het logische uitvoeringspad wordt weergegeven. Gebeurtenissen kunnen worden gesorteerd op timestamp en sequenceNumber zoals wordt weergegeven in de onderstaande query:

let targetInstanceId = "ddd1aaa685034059b545eb004b15d4eb";
let start = datetime(2018-03-25T09:20:00);
traces
| where timestamp > start and timestamp < start + 30m
| where customDimensions.Category == "Host.Triggers.DurableTask"
| extend functionName = customDimensions["prop__functionName"]
| extend instanceId = customDimensions["prop__instanceId"]
| extend state = customDimensions["prop__state"]
| extend isReplay = tobool(tolower(customDimensions["prop__isReplay"]))
| extend sequenceNumber = tolong(customDimensions["prop__sequenceNumber"])
| where isReplay != true
| where instanceId == targetInstanceId
| sort by timestamp asc, sequenceNumber asc
| project timestamp, functionName, state, instanceId, sequenceNumber, appName = cloud_RoleName

Het resultaat is een lijst met bijhouden van gebeurtenissen die het uitvoeringspad van de indeling weergeven, inclusief alle activiteitsfuncties die zijn gerangschikt op de uitvoeringstijd in oplopende volgorde.

Geordende query van Application Insights met één exemplaar

Samenvattingsquery exemplaar

De volgende query geeft de status weer van alle indelingsexemplaren die in een opgegeven tijdsbereik zijn uitgevoerd.

let start = datetime(2017-09-30T04:30:00);
traces
| where timestamp > start and timestamp < start + 1h
| where customDimensions.Category == "Host.Triggers.DurableTask"
| extend functionName = tostring(customDimensions["prop__functionName"])
| extend instanceId = tostring(customDimensions["prop__instanceId"])
| extend state = tostring(customDimensions["prop__state"])
| extend isReplay = tobool(tolower(customDimensions["prop__isReplay"]))
| extend output = tostring(customDimensions["prop__output"])
| where isReplay != true
| summarize arg_max(timestamp, *) by instanceId
| project timestamp, instanceId, functionName, state, output, appName = cloud_RoleName
| order by timestamp asc

Het resultaat is een lijst met exemplaar-id's en hun huidige runtimestatus.

Query voor één exemplaar van Application Insights

Logboekregistratie van Durable Task Framework

De durable-extensielogboeken zijn handig om inzicht te krijgen in het gedrag van uw indelingslogica. Deze logboeken bevatten echter niet altijd voldoende informatie om prestatie- en betrouwbaarheidsproblemen op frameworkniveau op te sporen. Vanaf v2.3.0 van de Durable-extensie zijn logboeken die worden verzonden door het onderliggende Durable Task Framework (DTFx) ook beschikbaar voor verzameling.

Wanneer u logboeken bekijkt die door de DTFx worden verzonden, is het belangrijk om te begrijpen dat de DTFx-engine bestaat uit twee onderdelen: de kernverzendingsengine (DurableTask.Core) en een van de vele ondersteunde opslagproviders (Durable Functions maakt standaard gebruik DurableTask.AzureStorage van andere opties).

DurableTask.Core: Uitvoering van kernindeling en planningslogboeken op laag niveau en telemetrie.
DurableTask.AzureStorage: back-endlogboeken die specifiek zijn voor de Azure Storage-statusprovider. Deze logboeken bevatten gedetailleerde interacties met de interne wachtrijen, blobs en opslagtabellen die worden gebruikt om de interne indelingsstatus op te slaan en op te halen.
DurableTask.Netherite: back-endlogboeken die specifiek zijn voor de Netherite-opslagprovider, indien ingeschakeld.
DurableTask.SqlServer: back-endlogboeken die specifiek zijn voor de Microsoft SQL-opslagprovider (MSSQL), indien ingeschakeld.

U kunt deze logboeken inschakelen door de sectie van het logging/logLevel host.json-bestand van uw functie-app bij te werken. In het volgende voorbeeld ziet u hoe u waarschuwings- en foutlogboeken van beide DurableTask.Core en DurableTask.AzureStorage:

{
  "version": "2.0",
  "logging": {
    "logLevel": {
      "DurableTask.AzureStorage": "Warning",
      "DurableTask.Core": "Warning"
    }
  }
}

Als Application Insights is ingeschakeld, worden deze logboeken automatisch toegevoegd aan de trace verzameling. U kunt ze op dezelfde manier doorzoeken als u andere trace logboeken zoekt met behulp van Kusto-query's.

Notitie

Voor productietoepassingen is het raadzaam om logboeken in te schakelen DurableTask.Core en de juiste opslagprovider (bijvoorbeeld DurableTask.AzureStorage) met behulp van het "Warning" filter. Hogere uitgebreidheidsfilters, zoals "Information" zijn zeer nuttig voor het opsporen van prestatieproblemen. Deze logboekgebeurtenissen kunnen echter groot zijn en kunnen de opslagkosten voor Application Insights-gegevens aanzienlijk verhogen.

De volgende Kusto-query laat zien hoe u query's kunt uitvoeren op DTFx-logboeken. Het belangrijkste onderdeel van de query is where customerDimensions.Category startswith "DurableTask" dat de resultaten worden gefilterd op logboeken in de DurableTask.Core en DurableTask.AzureStorage categorieën.

traces
| where customDimensions.Category startswith "DurableTask"
| project
    timestamp,
    severityLevel,
    Category = customDimensions.Category,
    EventId = customDimensions.EventId,
    message,
    customDimensions
| order by timestamp asc

Het resultaat is een set logboeken die zijn geschreven door de Durable Task Framework-logboekproviders.

Application Insights DTFx-queryresultaten

Zie de documentatie over gestructureerde logboekregistratie van Durable Task Framework op GitHub voor meer informatie over welke logboeken er beschikbaar zijn.

App-logboekregistratie

Het is belangrijk dat u het gedrag van de orchestratorherhaling in gedachten houdt wanneer u logboeken rechtstreeks vanuit een orchestratorfunctie schrijft. Denk bijvoorbeeld aan de volgende orchestratorfunctie:

[FunctionName("FunctionChain")]
public static async Task Run(
    [OrchestrationTrigger] IDurableOrchestrationContext context,
    ILogger log)
{
    log.LogInformation("Calling F1.");
    await context.CallActivityAsync("F1");
    log.LogInformation("Calling F2.");
    await context.CallActivityAsync("F2");
    log.LogInformation("Calling F3");
    await context.CallActivityAsync("F3");
    log.LogInformation("Done!");
}

[Function("FunctionChain")]
public static async Task Run(
    [OrchestrationTrigger] TaskOrchestrationContext context,
    FunctionContext executionContext)
{
    ILogger log = executionContext.GetLogger("FunctionChain");
    log.LogInformation("Calling F1.");
    await context.CallActivityAsync("F1");
    log.LogInformation("Calling F2.");
    await context.CallActivityAsync("F2");
    log.LogInformation("Calling F3");
    await context.CallActivityAsync("F3");
    log.LogInformation("Done!");
}

const df = require("durable-functions");

module.exports = df.orchestrator(function*(context){
    context.log("Calling F1.");
    yield context.df.callActivity("F1");
    context.log("Calling F2.");
    yield context.df.callActivity("F2");
    context.log("Calling F3.");
    yield context.df.callActivity("F3");
    context.log("Done!");
});

import logging
import azure.functions as func
import azure.durable_functions as df

def orchestrator_function(context: df.DurableOrchestrationContext):
    logging.info("Calling F1.")
    yield context.call_activity("F1")
    logging.info("Calling F2.")
    yield context.call_activity("F2")
    logging.info("Calling F3.")
    yield context.call_activity("F3")
    return None

main = df.Orchestrator.create(orchestrator_function)

@FunctionName("FunctionChain")
public void functionChain(
        @DurableOrchestrationTrigger(name = "ctx") TaskOrchestrationContext ctx,
        ExecutionContext functionContext) {
    Logger log = functionContext.getLogger();
    log.info("Calling F1.");
    ctx.callActivity("F1").await();
    log.info("Calling F2.");
    ctx.callActivity("F2").await();
    log.info("Calling F3.");
    ctx.callActivity("F3").await();
    log.info("Done!");
}

De resulterende logboekgegevens zien er ongeveer als volgt uit:

Calling F1.
Calling F1.
Calling F2.
Calling F1.
Calling F2.
Calling F3.
Calling F1.
Calling F2.
Calling F3.
Done!

Notitie

Houd er rekening mee dat terwijl de logboeken F1, F2 en F3 aanroepen, deze functies alleen worden aangeroepen wanneer ze voor het eerst worden aangetroffen. Volgende aanroepen die plaatsvinden tijdens het opnieuw afspelen, worden overgeslagen en de uitvoer wordt opnieuw afgespeeld in de orchestratorlogica.

Als u alleen logboeken wilt schrijven over uitvoeringen die niet opnieuw worden afgespeeld, kunt u een voorwaardelijke expressie schrijven om alleen te registreren als de vlag 'is opnieuw afspelen' is false. Bekijk het bovenstaande voorbeeld, maar deze keer met controles voor opnieuw afspelen.

[FunctionName("FunctionChain")]
public static async Task Run(
    [OrchestrationTrigger] IDurableOrchestrationContext context,
    ILogger log)
{
    if (!context.IsReplaying) log.LogInformation("Calling F1.");
    await context.CallActivityAsync("F1");
    if (!context.IsReplaying) log.LogInformation("Calling F2.");
    await context.CallActivityAsync("F2");
    if (!context.IsReplaying) log.LogInformation("Calling F3");
    await context.CallActivityAsync("F3");
    log.LogInformation("Done!");
}

Vanaf Durable Functions 2.0 hebben .NET-orchestratorfuncties ook de mogelijkheid om tijdens ILogger het opnieuw afspelen automatisch logboekinstructies te filteren. Deze automatische filtering wordt uitgevoerd met behulp van de IDurableOrchestrationContext.CreateReplaySafeLogger(ILogger) API.

[FunctionName("FunctionChain")]
public static async Task Run(
    [OrchestrationTrigger] IDurableOrchestrationContext context,
    ILogger log)
{
    log = context.CreateReplaySafeLogger(log);
    log.LogInformation("Calling F1.");
    await context.CallActivityAsync("F1");
    log.LogInformation("Calling F2.");
    await context.CallActivityAsync("F2");
    log.LogInformation("Calling F3");
    await context.CallActivityAsync("F3");
    log.LogInformation("Done!");
}

Notitie

De vorige C#-voorbeelden zijn voor Durable Functions 2.x. Voor Durable Functions 1.x moet u in DurableOrchestrationContext plaats van IDurableOrchestrationContext. Zie het artikel Over Durable Functions-versies voor meer informatie over de verschillen tussen versies.

In Durable Functions voor . Net-geïsoleerde, kunt u een ILogger maken die automatisch logboekinstructies filtert tijdens het opnieuw afspelen. Het belangrijkste verschil met Durable Functions in-proc is dat u geen bestaande ILoggerfuncties opgeeft. Deze logger wordt gemaakt via de TaskOrchestrationContext.CreateReplaySafeLogger overbelastingen.

[Function("FunctionChain")]
public static async Task Run([OrchestrationTrigger] TaskOrchestrationContext context)
{
    ILogger log = context.CreateReplaySafeLogger("FunctionChain");
    log.LogInformation("Calling F1.");
    await context.CallActivityAsync("F1");
    log.LogInformation("Calling F2.");
    await context.CallActivityAsync("F2");
    log.LogInformation("Calling F3");
    await context.CallActivityAsync("F3");
    log.LogInformation("Done!");
}

Notitie

De mogelijkheid om een bestaande ILogger in een replay-safe logger te verpakken, is verwijderd in Durable Functions voor .NET geïsoleerde werkrol.

const df = require("durable-functions");

module.exports = df.orchestrator(function*(context){
    if (!context.df.isReplaying) context.log("Calling F1.");
    yield context.df.callActivity("F1");
    if (!context.df.isReplaying) context.log("Calling F2.");
    yield context.df.callActivity("F2");
    if (!context.df.isReplaying) context.log("Calling F3.");
    yield context.df.callActivity("F3");
    context.log("Done!");
});

import logging
import azure.functions as func
import azure.durable_functions as df

def orchestrator_function(context: df.DurableOrchestrationContext):
    if not context.is_replaying:
        logging.info("Calling F1.")
    yield context.call_activity("F1")
    if not context.is_replaying:
        logging.info("Calling F2.")
    yield context.call_activity("F2")
    if not context.is_replaying:
        logging.info("Calling F3.")
    yield context.call_activity("F3")
    logging.info("Done!")
    return None

main = df.Orchestrator.create(orchestrator_function)

@FunctionName("FunctionChain")
public void functionChain(
        @DurableOrchestrationTrigger(name = "ctx") TaskOrchestrationContext ctx,
        ExecutionContext functionContext) {
    Logger log = functionContext.getLogger();
    if (!ctx.getIsReplaying()) log.info("Calling F1.");
    ctx.callActivity("F1").await();
    if (!ctx.getIsReplaying()) log.info("Calling F2.");
    ctx.callActivity("F2").await();
    if (!ctx.getIsReplaying()) log.info("Calling F3.");
    ctx.callActivity("F3").await();
    log.info("Done!");
}

Met de eerder genoemde wijzigingen is de logboekuitvoer als volgt:

Calling F1.
Calling F2.
Calling F3.
Done!

Douanestatus

Met de aangepaste indelingsstatus kunt u een aangepaste statuswaarde instellen voor uw orchestratorfunctie. Deze aangepaste status is vervolgens zichtbaar voor externe clients via de HTTP-statusquery-API of via taalspecifieke API-aanroepen. De aangepaste indelingsstatus maakt uitgebreidere bewaking mogelijk voor orchestratorfuncties. De orchestratorfunctiecode kan bijvoorbeeld de API 'Aangepaste status instellen' aanroepen om de voortgang voor een langdurige bewerking bij te werken. Een client, zoals een webpagina of een ander extern systeem, kan vervolgens periodiek query's uitvoeren op de HTTP-statusquery-API's voor uitgebreidere voortgangsinformatie. Hieronder vindt u voorbeeldcode voor het instellen van een aangepaste statuswaarde in een orchestrator-functie:

[FunctionName("SetStatusTest")]
public static async Task SetStatusTest([OrchestrationTrigger] IDurableOrchestrationContext context)
{
    // ...do work...

    // update the status of the orchestration with some arbitrary data
    var customStatus = new { completionPercentage = 90.0, status = "Updating database records" };
    context.SetCustomStatus(customStatus);

    // ...do more work...
}

Notitie

Het vorige C#-voorbeeld is voor Durable Functions 2.x. Voor Durable Functions 1.x moet u in DurableOrchestrationContext plaats van IDurableOrchestrationContext. Zie het artikel Over Durable Functions-versies voor meer informatie over de verschillen tussen versies.

[Function("SetStatusTest")]
public static async Task SetStatusTest([OrchestrationTrigger] TaskOrchestrationContext context)
{
    // ...do work...

    // update the status of the orchestration with some arbitrary data
    var customStatus = new { completionPercentage = 90.0, status = "Updating database records" };
    context.SetCustomStatus(customStatus);

    // ...do more work...
}

const df = require("durable-functions");

module.exports = df.orchestrator(function*(context) {
    // ...do work...

    // update the status of the orchestration with some arbitrary data
    const customStatus = { completionPercentage: 90.0, status: "Updating database records", };
    context.df.setCustomStatus(customStatus);

    // ...do more work...
});

import logging
import azure.functions as func
import azure.durable_functions as df

def orchestrator_function(context: df.DurableOrchestrationContext):
    # ...do work...

    # update the status of the orchestration with some arbitrary data
    custom_status = {'completionPercentage': 90.0, 'status': 'Updating database records'}
    context.set_custom_status(custom_status)
    # ...do more work...

    return None

main = df.Orchestrator.create(orchestrator_function)

@FunctionName("SetStatusTest")
public void setStatusTest(
        @DurableOrchestrationTrigger(name = "ctx") TaskOrchestrationContext ctx) {
    // ...do work...

    // update the status of the orchestration with some arbitrary data
    ctx.setCustomStatus(new Object() {
        public final double completionPercentage = 90.0;
        public final String status = "Updating database records";
    });

    // ...do more work...
}

Terwijl de indeling wordt uitgevoerd, kunnen externe clients deze aangepaste status ophalen:

GET /runtime/webhooks/durabletask/instances/instance123?code=XYZ

Clients krijgen het volgende antwoord:

{
  "runtimeStatus": "Running",
  "input": null,
  "customStatus": { "completionPercentage": 90.0, "status": "Updating database records" },
  "output": null,
  "createdTime": "2017-10-06T18:30:24Z",
  "lastUpdatedTime": "2017-10-06T19:40:30Z"
}

Waarschuwing

De nettolading van de aangepaste status is beperkt tot 16 kB van UTF-16 JSON-tekst, omdat deze in een Azure Table Storage-kolom moet passen. U kunt externe opslag gebruiken als u een grotere nettolading nodig hebt.

Gedistribueerde tracering

Gedistribueerde tracering houdt aanvragen bij en laat zien hoe verschillende services met elkaar communiceren. In Durable Functions correleert het ook indelingen en activiteiten samen. Dit is handig om te begrijpen hoeveel tijdsstappen de indeling neemt ten opzichte van de hele indeling. Het is ook handig om te begrijpen waar een toepassing een probleem heeft of waar een uitzondering is opgetreden. Deze functie wordt ondersteund voor alle talen en opslagproviders.

Notitie

Gedistribueerde tracering V2 vereist Durable Functions v2.12.0 of hoger. Gedistribueerde tracering V2 heeft ook een preview-status en daarom zijn sommige Durable Functions-patronen niet geïnstrueerd. Durable Entities-bewerkingen worden bijvoorbeeld niet geïnstrueerd en traceringen worden niet weergegeven in Application Insights.

Gedistribueerde tracering instellen

Als u gedistribueerde tracering wilt instellen, werkt u de host.json bij en stelt u een Application Insights-resource in.

host.json

"durableTask": {
  "tracing": {
    "distributedTracingEnabled": true,
    "Version": "V2"
  }
}

Analyses van toepassingen

Als de functie-app niet is geconfigureerd met een Application Insights-resource, configureert u deze volgens de instructies hier.

De traceringen inspecteren

Navigeer in de Application Insights-resource naar Transaction Search. Controleer in de resultaten op Request gebeurtenissen Dependency die beginnen met specifieke voorvoegsels van Durable Functions (bijvoorbeeld orchestration:activity:, enzovoort). Als u een van deze gebeurtenissen selecteert, wordt een Gantt-diagram geopend dat de end-to-end gedistribueerde tracering weergeeft.

Probleemoplossing

Als u de traceringen niet ziet in Application Insights, moet u ongeveer vijf minuten wachten nadat u de toepassing hebt uitgevoerd om ervoor te zorgen dat alle gegevens worden doorgegeven aan de Application Insights-resource.

Foutopsporing

Azure Functions biedt rechtstreeks ondersteuning voor foutopsporingsfunctiecode en dezelfde ondersteuning biedt ondersteuning voor Durable Functions, ongeacht of deze wordt uitgevoerd in Azure of lokaal. Er zijn echter enkele gedragingen waar u rekening mee moet houden bij het opsporen van fouten:

Opnieuw afspelen: Orchestrator-functies worden regelmatig opnieuw afgespeeld wanneer nieuwe invoer wordt ontvangen. Dit gedrag betekent dat één logische uitvoering van een orchestratorfunctie meerdere keren hetzelfde onderbrekingspunt kan bereiken, vooral als deze vroeg in de functiecode is ingesteld.
Wacht op: Wanneer een await orchestratorfunctie wordt aangetroffen, wordt de besturing teruggezet naar de dispatcher van het Durable Task Framework. Als het de eerste keer is dat een bepaalde await taak is aangetroffen, wordt de bijbehorende taak nooit hervat. Omdat de taak nooit wordt hervat, is het niet mogelijk om de wacht te doorlopen (F10 in Visual Studio). Stappen werkt alleen wanneer een taak opnieuw wordt afgespeeld.
Time-outs voor berichten: Durable Functions maakt intern gebruik van wachtrijberichten om de uitvoering van orchestrator-, activiteits- en entiteitsfuncties te stimuleren. In een omgeving met meerdere VM's kan het inbreken van de foutopsporing gedurende langere tijd ertoe leiden dat een andere VIRTUELE machine het bericht ophaalt, wat resulteert in dubbele uitvoering. Dit gedrag bestaat ook voor reguliere wachtrijtriggerfuncties, maar is belangrijk om in deze context te wijzen omdat de wachtrijen een implementatiedetails zijn.
Stoppen en starten: Berichten in Durable Functions blijven behouden tussen foutopsporingssessies. Als u de foutopsporing stopt en het lokale hostproces beëindigt terwijl een duurzame functie wordt uitgevoerd, kan die functie automatisch opnieuw worden uitgevoerd in een toekomstige foutopsporingssessie. Dit gedrag kan verwarrend zijn wanneer dit niet wordt verwacht. Het gebruik van een nieuwe taakhub of het wissen van de inhoud van de taakhub tussen foutopsporingssessies is één techniek om dit gedrag te voorkomen.

Tip

Wanneer u onderbrekingspunten instelt in orchestratorfuncties, kunt u een voorwaardelijk onderbrekingspunt instellen dat alleen wordt verbroken als de waarde 'opnieuw afspelen' is false.

Storage

Durable Functions slaat standaard de status op in Azure Storage. Dit gedrag betekent dat u de status van uw indelingen kunt inspecteren met behulp van hulpprogramma's zoals Microsoft Azure Storage Explorer.

Schermopname van Azure Storage Explorer

Dit is handig voor foutopsporing, omdat u precies ziet in welke staat een indeling zich bevindt. Berichten in de wachtrijen kunnen ook worden onderzocht om te zien wat er in behandeling is (of in sommige gevallen vastloopt).

Waarschuwing

Hoewel het handig is om de uitvoeringsgeschiedenis in tabelopslag te bekijken, vermijdt u dat u afhankelijkheid van deze tabel maakt. De tabel kan veranderen naarmate de Durable Functions-uitbreiding zich ontwikkelt.

Notitie

Andere opslagproviders kunnen worden geconfigureerd in plaats van de standaard Azure Storage-provider. Afhankelijk van de opslagprovider die voor uw app is geconfigureerd, moet u mogelijk verschillende hulpprogramma's gebruiken om de onderliggende status te controleren. Zie de documentatie voor Durable Functions Storage Providers voor meer informatie.

Durable Functions Monitor

Durable Functions Monitor is een grafisch hulpprogramma voor het bewaken, beheren en opsporen van fouten in indeling en entiteitsexemplaren. Het is beschikbaar als een Visual Studio Code-extensie of een zelfstandige app. Informatie over het instellen en een lijst met functies vindt u in deze wiki.

Gids voor het oplossen van problemen met Durable Functions

Raadpleeg deze probleemoplossingsgids om veelvoorkomende problemen op te lossen, zoals indelingen die vastlopen, niet kunnen worden gestart, langzaam worden uitgevoerd, enzovoort.

Volgende stappen

Meer informatie over bewaking in Azure Functions

Share via

Diagnostische gegevens in Durable Functions in Azure

Analyses van toepassingen

Traceringsgegevens

Functions 1.0

Functions 2.0

Query voor één exemplaar

Samenvattingsquery exemplaar

Logboekregistratie van Durable Task Framework

App-logboekregistratie

Douanestatus

Gedistribueerde tracering

Gedistribueerde tracering instellen

host.json

Analyses van toepassingen

De traceringen inspecteren

Probleemoplossing

Foutopsporing

Storage

Durable Functions Monitor

Gids voor het oplossen van problemen met Durable Functions

Volgende stappen

Feedback

Aanvullende resources