Dela via


Samla in felsökningsdata för SharePoint 2013-arbetsflöde med ShowScopeDebugInfo

Funktionen ShowScopeDebugInfo() är ett enklare sätt att felsöka vanliga problem som påverkar SharePoint 2013-arbetsflöden och även ge ytterligare information till supportagenter som hjälper dig att lösa arbetsflödesproblem.

Så här kör du funktionen ShowScopeDebugInfo()

  1. På den webbplats där arbetsflödesproblemet uppstår väljer du Inställningar (kugghjulsikonen) och väljer sedan Arbetsflödesstatus för webbplatsinställningar>för arbetsflödesinställningar.>

    • Du kan också komma åt Arbetsflödeshälsa från en URL. Exempel: https://<contoso>.sharepoint.com/sites/<test>/_layouts/15/WorkflowServiceHealth.aspx. (I det här exemplet ersätter du contoso med din domän och testar med namnet på SharePoint-webbplatsen.)
  2. Öppna Utvecklarverktyg från en webbläsare (Edge eller Google Chrome rekommenderas).

    • Tryck på F12 för Microsoft Edge.
    • För Google Chrome trycker du på Skift+Ctrl+J.
  3. Välj Konsol.

  4. Ange följande funktionsnamn: ShowScopeDebugInfo()och tryck sedan på Retur. Kommandot kör en JavaScript-funktion för att skriva ut data i bakgrunden.

    • Obs! Sidan Arbetsflödestjänsthälsa måste uppdateras för att hämta uppdaterade data från ShowScopeDebugInfo. Informationen som genereras av ShowScopeDebugInfo returneras inte i realtid. Det finns en liten fördröjning innan resultatet uppdateras.

Exempel på utdata:

{
  "SupportDocument": "https://go.microsoft.com/fwlink/?linkid=847765",
  "ScopePath": "/spo/ec63b09b-9748-47ba-9018-beeadd405204/f19089ae-d6c6-4feb-be0b-ff4de40a04fc/88890858-ae38-407a-b1e7-152c7cff6fe5",
  "WorkflowEndpoint": "spo-dm3-001.workflow.windows.net",
  "WorkflowAppId": "i:0i.t|ms.sp.ext|5958c314-3699-407a-b142-2d459b5161c4@72f988bf-86f1-41af-91ab-2d7cd011db47",
  "IsThrottled": false,
  "ThrottledUntil": "",
  "ActiveMessageCount": "965436",
  "StatusDetails": "MaxTopicSize",
  "ScopeSizeInBytes": "6447069028",
  "MaxScopeSizeInBytes": "6442450944",
  "CorrelationFilterCount": "1851",
  "MaxCorrelationFilterCount": "100000",
  "ScopeUsageInfoAggregatedByWorkflow": [
    {
      "workflowName": "87effe93-5c6a-474d-8a72-0ef451ff0100",
      "workflowDisplayName": "ANewWF",
      "sizeInBytes": 0,
      "correlationFilterCount": 0
    },
    {
      "workflowName": "df26aa85-85a7-4466-a273-1775c9da38bb",
      "workflowDisplayName": "Neat2013ListWorkflow",
      "sizeInBytes": 52591272,
      "correlationFilterCount": 1827
    },
    {
      "workflowName": "fc7a63c5-ff72-42e5-87fd-3f2944f8a6ef",
      "workflowDisplayName": "Spec_Document_Approval",
      "sizeInBytes": 277327,
      "correlationFilterCount": 24
    }
  ]
}

Så här läser du resultatet

Etikett Definition
SupportDokument Offentlig dokumentation om SharePoint 2013-arbetsflöde som hjälper arbetsflödesförfattare att undvika vanliga problematiska arbetsflödesdesigner och vanliga fel.
ScopePath Nödvändig information för att engagera SharePoint 2013 Workflow-funktionsägare.
WorkflowEndpoint Nödvändig information för att engagera SharePoint 2013 Workflow-funktionsägare.
WorkflowAppId Nödvändig information för att engagera SharePoint 2013 Workflow-funktionsägare.
IsThrottled Anger om Azure Workflow Service begränsar den aktuella SharePoint-webbplatsens SharePoint 2013-arbetsflöden. Begränsning sker per SharePoint-webbplats och utvärderas var 10:e minut. Om alla SharePoint 2013 Workflow-instanser överskrider den dynamiska begränsningsgränsen begränsar Azure Workflow Service alla SharePoint 2013 Workflow-instanser i minst fem minuter och Arbetsflödesinstanser återupptas under nästa 10-minuters bearbetningsfönster.
ThrottledUntil Om IsThrottled är sant innehåller ThrottledUntil ett UTC-datum och en tid som anger när begränsningen upphör att gälla.
ActiveMessageCount Representerar ServiceBus-prenumerationen ActiveMessageCount. När SharePoint 2013 Workflow-instanser initieras placeras meddelanden i kö i Azure ServiceBus och dessa meddelanden bearbetas av Azure Workflow Service-serverdelen. Om SharePoint 2013 Workflow-instanser bearbetas långsamt beror det ofta på begränsning och/eller en stor Azure ServiceBus-kö, vilket anges av ActiveMessageCount.
StatusDetails Anger orsaken till att den aktuella SharePoint-webbplatsens SharePoint 2013-arbetsflöden inte fortskrider och varför det inte går att starta SharePoint 2013-arbetsflödesinstanser manuellt eller automatiskt. För närvarande ingår MaxTopicSize och MaxCorrelationFilter för att ange vilken gräns som överskreds.
ScopeSizeInBytes Representerar sharepoint-webbplatsens SharePoint 2013 Workflow Storage i Azure Workflow Service. Azure Workflow Service använder Azure Service Bus och Azure SQL för att aktivera SharePoint 2013-arbetsflöden. Varje SharePoint-webbplats tilldelas 6 GB. Azure Workflow Service är molnversionen av den lokala Arbetsflödeshanteraren. Om ScopeSizeInBytes överskred MaxScopeSizeInBytes anger StatusDetails MaxTopicSize. Det innebär att gränsen har överskridits och att SharePoint 2013 Workflow-instanser inte startar när de utlöses manuellt eller genom att skapa och redigera data i SharePoint Online. Du kan ta reda på vilket SharePoint 2013-arbetsflöde som använder mest utrymme genom att undersöka ScopeUsageInfoAggregatedByWorkflow. ScopeUsageInfoAggregatedByWorkflow returneras inte i realtid men är relativt uppdaterat. Varje SharePoint 2013-arbetsflöde innehåller storlekInByte och kan användas som en guide för att identifiera vilket SharePoint 2013-arbetsflöde som ska tas bort från en SharePoint-lista eller ett SharePoint-bibliotek. Genom att ta bort ett SharePoint 2013-arbetsflöde från sidan Arbetsflödesinställningar för en lista eller ett bibliotek initieras en rensningsprocess. När processen är klar återupptas bearbetningen av SharePoint-webbplatsens arbetsflöde. Kolumnen StatusDetails innehåller inte längre MaxTopicSize eller ScopeSizeInBytes. Den är mindre än MaxScopeSizeInBytes. Det går att starta SharePoint 2013-arbetsflöden.
MaxScopeSizeInBytes Representerar det maximala lagringsutrymme som allokeras i Azure Workflow Service för den aktuella SharePoint-webbplatsen.
CorrelationFilterCount Representerar den aktuella användningen av Azure ServiceBus-korrelationsfilter i Azure Workflow Service. När ett enkelt SharePoint 2013-arbetsflöde startas manuellt eller genom att skapa eller redigera data i SharePoint Online används två korrelationsfilter per arbetsflödesinstans. När ett SharePoint 2013-arbetsflöde blir mer komplext används fler korrelationsfilter. Åtgärder som Wait for Field to Change (Vänta på att fältet ändras ) eller Wait for Change in List (Vänta på ändring i listan ) förbrukar korrelationsfilter helt.

MaxCorrelationFilterCount representerar den maximala korrelationsfiltergränsen på 100 000. Om det enklaste SharePoint 2013-arbetsflödet skapas innebär det att det finns högst 50 000 aktiva arbetsflödesinstanser per SharePoint-webbplats. Det är dock osannolikt att du kan nå 50 000 arbetsflödesinstanser, eftersom de flesta arbetsflöden använder mer än de två standardkorrelationsfilter som krävs för att starta en arbetsflödesinstans. När en arbetsflödesinstans har slutförts minskas antalet korrelationsfilter. Detta ger utrymme för fler arbetsflödesinstanser.

Om CorrelationFilterCount är större än MaxCorrelationFilterCount innehåller StatusDetails MaxCorrelationFilter. Det går inte att starta arbetsflödesinstanser. Samma beteende som beskrivs i ScopeSizeInBytes inträffar när CorrelationFilterCount överskrider MaxCorrelationFilterCount. Samma lösning är också möjlig. Använd ScopeUsageInfoAggregatedByWorkflow och leta upp arbetsflödet med den högsta korrelationenFilterCount och överväg att ta bort det från SharePoint-listan eller biblioteket med hjälp av sidan Arbetsflödesinställningar. Om ett SharePoint 2013-arbetsflöde tas bort med SharePoint Designer tas arbetsflödeslogik bort och arbetsflödet måste återskapas. Det är bäst att ta bort arbetsflödet med hjälp av sidan Arbetsflödesinställningar och sedan justera arbetsflödeslogik baserat på de rekommendationer som finns här.
MaxCorrelationFilterCount Representerar antalet korrelationsfilter som allokeras i Azure Workflow Service för den aktuella SharePoint-webbplatsen.
ScopeUsageInfoAggregatedByWorkflow Innehåller den aktuella SharePoint-webbplatsens SharePoint 2013-arbetsflöden. Varje arbetsflöde innehåller följande data: workflowName, workflowDisplayName, sizeInBytes och correlationFilterCount. Data i ScopeUsageInfoAggregatedByWorkflow uppdateras inte i realtid. Det är en ögonblicksbild som uppdateras ofta.
  • workflowName mappar till WorkflowSubscription.Id.
  • workflowDisplayName mappar till WorkflowSubscription.Name. Det här namnet är SharePoint 2013-arbetsflödets namn i SharePoint UX. Det här namnet kan skilja sig från det som finns i SharePoint Designer.
  • sizeInBytes är arbetsflödets lagringsanvändning. Den aggregeras till ScopeSizeInBytes.
  • correlationFilterCount är användningen av korrelationsfilter för arbetsflöden. Den aggregeras till CorrelationFilterCount.