Dapr-komponentåterhämtning (förhandsversion)

Återhämtningsprinciper förhindrar, identifierar och återställer proaktivt från dina containerappfel. I den här artikeln får du lära dig hur du tillämpar återhämtningsprinciper för program som använder Dapr för att integrera med olika molntjänster, till exempel delstatsbutiker, pub-/undermeddelandeköer, hemliga butiker med mera.

Du kan konfigurera återhämtningsprinciper som återförsök, timeouter och kretsbrytare för följande utgående och inkommande åtgärdsriktningar via en Dapr-komponent:

• Utgående åtgärder: Anrop från Dapr-sidovagnen till en komponent, till exempel:
  • Bevara eller hämta tillstånd
  • Publicera ett meddelande
  • Anropa en utdatabindning
• Inkommande åtgärder: Anrop från Dapr-sidovagnen till containerappen, till exempel:
  • Prenumerationer när du levererar ett meddelande
  • Indatabindningar som levererar en händelse

Följande skärmbild visar hur ett program använder en återförsöksprincip för att försöka återställa från misslyckade begäranden.

Återhämtningsprinciper som stöds

• Timeout
• Återförsök (HTTP)
• Kretsbrytare

Konfigurera återhämtningsprinciper

Du kan välja om du vill skapa återhämtningsprinciper med hjälp av Bicep, CLI eller Azure Portal.

Bicep

Följande återhämtningsexempel visar alla tillgängliga konfigurationer.

resource myPolicyDoc 'Microsoft.App/managedEnvironments/daprComponents/resiliencyPolicies@2023-11-02-preview' = {
  name: 'my-component-resiliency-policies'
  parent: '${componentName}'
  properties: {
    outboundPolicy: {
      timeoutPolicy: {
          responseTimeoutInSeconds: 15
      }
      httpRetryPolicy: {
          maxRetries: 5
          retryBackOff: {
            initialDelayInMilliseconds: 1000
            maxIntervalInMilliseconds: 10000
          }
      }
      circuitBreakerPolicy: {  
          intervalInSeconds: 15
          consecutiveErrors: 10
          timeoutInSeconds: 5     
      }  
    } 
    inboundPolicy: {
      timeoutPolicy: {
        responseTimeoutInSeconds: 15
      }
      httpRetryPolicy: {
        maxRetries: 5
        retryBackOff: {
          initialDelayInMilliseconds: 1000
          maxIntervalInMilliseconds: 10000
        }
      }
      circuitBreakerPolicy: {  
          intervalInSeconds: 15
          consecutiveErrors: 10
          timeoutInSeconds: 5     
      }  
    }
  }
}

CLI

Innan du börjar

Logga in på Azure CLI:

az login

Kontrollera att du har den senaste versionen av Azure Container App-tillägget.

az extension show --name containerapp
az extension update --name containerapp

Skapa specifika principer

Kommentar

Om alla egenskaper i en princip inte anges under skapande eller uppdatering tillämpar CLI automatiskt de rekommenderade standardinställningarna. Ange specifika principer med flaggor.

Skapa återhämtningsprinciper genom att rikta in dig på en enskild princip. Om du till exempel vill skapa Outbound Timeout principen kör du följande kommando.

az containerapp env dapr-component resiliency create --group MyResourceGroup --name MyDaprResiliency --environment MyEnvironment --dapr-component-name MyDaprComponentName --out-timeout 20

En fullständig lista över parametrar finns i CLI-referensguiden.

Skapa principer med återhämtnings-YAML

Kör följande kommando för att tillämpa återhämtningsprinciperna från en YAML-fil:

az containerapp env dapr-component resiliency create --group MyResourceGroup --name MyDaprResiliency --environment MyEnvironment --dapr-component-name MyDaprComponentName --yaml <MY_YAML_FILE>

Det här kommandot skickar YAML-filen för återhämtningsprincip, som kan se ut ungefär som i följande exempel:

outboundPolicy:
  httpRetryPolicy:
    maxRetries: 5
    retryBackOff:
      initialDelayInMilliseconds: 1000
      maxIntervalInMilliseconds: 10000
  timeoutPolicy:
    responseTimeoutInSeconds: 15
  circuitBreakerPolicy:
    intervalInSeconds: 15
    consecutiveErrors: 10
    timeoutInSeconds: 5
inboundPolicy:
  httpRetryPolicy:
    maxRetries: 3
    retryBackOff:
      initialDelayInMilliseconds: 500
      maxIntervalInMilliseconds: 5000
  circuitBreakerPolicy:
    intervalInSeconds: 15
    consecutiveErrors: 10
    timeoutInSeconds: 5

Uppdatera specifika principer

Uppdatera dina återhämtningsprinciper genom att rikta in dig på en enskild princip. Om du till exempel vill uppdatera tidsgränsen för svar för Outbound Timeout principen kör du följande kommando.

az containerapp env dapr-component resiliency update --group MyResourceGroup --name MyDaprResiliency --environment MyEnvironment --dapr-component-name MyDaprComponentName --out-timeout 20

Uppdatera principer med återhämtnings-YAML

Du kan också uppdatera befintliga återhämtningsprinciper genom att uppdatera återhämtnings-YAML som du skapade tidigare.

az containerapp env dapr-component resiliency update --group MyResourceGroup --name MyDaprResiliency --environment MyEnvironment --dapr-component-name MyDaprComponentName --yaml <MY_YAML_FILE>

Visa principer

resiliency list Använd kommandot för att visa en lista över alla återhämtningsprinciper som är kopplade till en containerapp.

az containerapp env dapr-component resiliency list --group MyResourceGroup --environment MyEnvironment --dapr-component-name MyDaprComponentName

Använd resiliency show kommandot för att visa en enskild princip efter namn.

az containerapp env dapr-component resiliency show --group MyResourceGroup --name MyDaprResiliency --environment MyEnvironment --dapr-component-name MyDaprComponentName

Ta bort principer

Om du vill ta bort återhämtningsprinciper kör du följande kommando.

az containerapp env dapr-component resiliency delete --group MyResourceGroup --name MyDaprResiliency --environment MyEnvironment --dapr-component-name MyDaprComponentName

Azure-portalen

Navigera till containerappmiljön i Azure Portal. I menyn till vänster under Inställningar väljer du Dapr-komponenter för att öppna dapr-komponentfönstret.

Du kan lägga till återhämtningsprinciper i en befintlig Dapr-komponent genom att välja Lägg till återhämtning för komponenten.

I fönstret Återhämtningsprincip väljer du Utgående eller Inkommande för att ange principer för utgående eller inkommande åtgärder. För utgående åtgärder kan du till exempel ange timeout- och HTTP-återförsöksprinciper som liknar följande.

Spara återhämtningsprinciperna genom att klicka på Spara .

Kommentar

För närvarande kan du bara ange timeout- och återförsöksprinciper via Azure Portal.

Du kan redigera eller ta bort återhämtningsprinciperna genom att välja Redigera återhämtning.

Viktigt!

När du har tillämpat alla återhämtningsprinciper måste du starta om Dina Dapr-program.

Principspecifikationer

Timeouter

Tidsgränser används för att avsluta tidskrävande åtgärder tidigt. Tidsgränsprincipen innehåller följande egenskaper.

properties: {
  outbound: {
    timeoutPolicy: {
        responseTimeoutInSeconds: 15
    }
  }
  inbound: {
    timeoutPolicy: {
        responseTimeoutInSeconds: 15
    }
  }
}

Metadata	Obligatoriskt	Beskrivning	Exempel
responseTimeoutInSeconds	Ja	Tidsgräns väntar på ett svar från Dapr-komponenten.	15

Försök

Definiera en httpRetryPolicy strategi för misslyckade åtgärder. Återförsöksprincipen innehåller följande konfigurationer.

properties: {
  outbound: {
    httpRetryPolicy: {
        maxRetries: 5
        retryBackOff: {
          initialDelayInMilliseconds: 1000
          maxIntervalInMilliseconds: 10000
        }
    }
  }
  inbound: {
    httpRetryPolicy: {
        maxRetries: 5
        retryBackOff: {
          initialDelayInMilliseconds: 1000
          maxIntervalInMilliseconds: 10000
        }
    }
  } 
}

Metadata	Obligatoriskt	Beskrivning	Exempel
maxRetries	Ja	Maximalt antal återförsök som ska köras för en misslyckad http-begäran.	5
retryBackOff	Ja	Övervaka begäranden och stäng av all trafik till den påverkade tjänsten när tidsgränsen och återförsökskriterierna uppfylls.	Ej tillämpligt
retryBackOff.initialDelayInMilliseconds	Ja	Fördröjning mellan det första felet och första återförsöket.	1000
retryBackOff.maxIntervalInMilliseconds	Ja	Maximal fördröjning mellan återförsök.	10000

Kretsbrytare

Definiera en circuitBreakerPolicy för att övervaka begäranden som orsakar förhöjda felfrekvenser och stänga av all trafik till den påverkade tjänsten när ett visst villkor uppfylls.

properties: {  
  outbound: {  
    circuitBreakerPolicy: {  
        intervalInSeconds: 15
        consecutiveErrors: 10
        timeoutInSeconds: 5     
    }  
  },  
  inbound: {  
    circuitBreakerPolicy: {  
        intervalInSeconds: 15
        consecutiveErrors: 10
        timeoutInSeconds: 5     
    }  
  }  
}

Metadata	Obligatoriskt	Beskrivning	Exempel
intervalInSeconds	Nej	Cyklisk tidsperiod (i sekunder) som används av kretsbrytaren för att rensa dess interna antal. Om det inte anges anges intervallet till samma värde som anges för timeoutInSeconds.	15
consecutiveErrors	Ja	Antal begärandefel som tillåts inträffa innan kretsen snubblar och öppnas.	10
timeoutInSeconds	Ja	Tidsperiod (i sekunder) med öppet tillstånd, direkt efter fel.	5

Kretsbrytareprocess

Om du anger consecutiveErrors (kretsresans villkor som ) anges antalet fel som consecutiveFailures > $(consecutiveErrors)-1tillåts inträffa innan kretsen går ut och öppnas halvvägs.

Kretsen väntar halvöppen under den timeoutInSeconds tid under vilken consecutiveErrors antalet begäranden måste lyckas.

• Om begäranden lyckas stängs kretsen.
• Om begäranden misslyckas förblir kretsen i ett halvöppnat tillstånd.

Om du inte har angett något intervalInSeconds värde återställs kretsen till ett stängt tillstånd efter den tid du har angett för timeoutInSeconds, oavsett om begäran lyckades eller misslyckades i följd. Om du anger intervalInSeconds till 0återställs kretsen aldrig automatiskt och flyttas bara från halvöppet till stängt tillstånd genom att consecutiveErrors slutföra begäranden på en rad.

Om du angav ett intervalInSeconds värde avgör det hur lång tid det tar innan kretsen återställs till stängt tillstånd, oberoende av om begäranden som skickats i halvöppnat tillstånd lyckades eller inte.

Återhämtningsloggar

I avsnittet Övervakning i containerappen väljer du Loggar.

I fönstret Loggar skriver och kör du en fråga för att hitta återhämtning via systemloggarna för containerappen. Om du till exempel vill ta reda på om en återhämtningsprincip har lästs in:

ContainerAppConsoleLogs_CL
| where ContainerName_s == "daprd"
| where Log_s contains "Loading Resiliency configuration:"
| project time_t, Category, ContainerAppName_s, Log_s
| order by time_t desc

Klicka på Kör för att köra frågan och visa resultatet med loggmeddelandet som anger att principen läses in.

Du kan också hitta den faktiska återhämtningsprincipen genom att aktivera felsökningsloggar i containerappen och fråga för att se om en återhämtningsresurs har lästs in.

När felsökningsloggar har aktiverats använder du en fråga som liknar följande:

ContainerAppConsoleLogs_CL
| where ContainerName_s == "daprd"
| where Log_s contains "Resiliency configuration ("
| project time_t, Category, ContainerAppName_s, Log_s
| order by time_t desc

Klicka på Kör för att köra frågan och visa det resulterande loggmeddelandet med principkonfigurationen.

Relaterat innehåll

Se hur återhämtning fungerar för service-till-tjänst-kommunikation med hjälp av Azure Container Apps inbyggd tjänstidentifiering