Ustawianie zasad retencji i automatycznego usuwania dla usługi Azure Functions Durable Task Scheduler

Aby zapobiec osiągnięciu limitu pamięci jednostki pojemności (CU), najlepszym rozwiązaniem jest okresowe przeczyszczanie danych historii aranżacji. Harmonogram zadań Durable Task Scheduler oferuje uproszczoną, konfigurowalną funkcję automatycznego czyszczenia, która ułatwia zarządzanie czyszczeniem danych orkiestracji bez ręcznej interwencji.

Autopurge działa asynchronicznie w tle, jest zoptymalizowany do minimalizowania użycia zasobów systemowych i zapobiegania zakłóceniom w innych operacjach Durable Task. Chociaż autopurge nie działa według ścisłego harmonogramu, jego szybkość czyszczenia zazwyczaj współgra z tempem planowania orkiestracji.

Jak to działa

Autopurge to funkcja wymagająca aktywnej zgody użytkownika. Można ją włączyć, definiując zasady przechowywania, które kontrolują, jak długo mają być zachowywane dane aranżacji w określonych stanach. Funkcja automatycznego przeczyszczania danych orkiestracji skojarzonych ze stanami terminalu. "Terminal" odnosi się do orkiestracji, które osiągnęły stan końcowy bez dalszego planowania, przetwarzania zdarzeń ani generowania zadań roboczych. Statusy terminalu obejmują:

Completed
Failed
Canceled
Terminated

Wystąpienia orkiestracji kwalifikujące się do autopurge są zgodne z wystąpieniami docelowymi interfejsu API Durable SDK PurgeInstancesAsync.

Autopurge ignoruje dane dotyczące orkiestracji skojarzone ze stanami nieterminalnymi. Statusy "niemające charakteru końcowego" wskazują, że instancja orkiestracji jest aktywnie wykonywana, wstrzymana lub znajduje się w stanie, w którym może być wznowiona w przyszłości (czeka na zdarzenia zewnętrzne lub liczniki czasowe). Te orkiestracje, które kontynuują się w nowej formie, gdzie obecne wykonanie zostało ukończone, lecz uruchomiono nowe wystąpienie jako kontynuację.

Te statusy obejmują:

Pending
Running
Suspended
Continued_As_New

Po włączeniu autopurge okresowo usuwa dane aranżacji starsze niż ustawiony okres przechowywania. Tylko autopurge

Uwaga / Notatka

Zdefiniowane zasady przechowywania są stosowane do wszystkich centrów zadań w harmonogramie.

Wartość zasad

Wartość przechowywania może zawierać się z zakresu od 0 (przeczyszczanie możliwie jak najszybciej) do maksymalnej wartości całkowitej, przy czym jednostka jest w dniach.

Domyślne i maksymalne przechowywanie danych
Domyślnie automatyczne przechowywanie jest ustawione na 30 dni. Ta wartość zapewnia zrównoważone podejście do oczyszczania danych i wydajności zasobów.
Okres przechowywania można wydłużyć do maksymalnie 90 dni, co pozwala na elastyczność scenariuszy wymagających dłuższego przechowywania historii aranżacji.

Okres przechowywania odnosi się do czasu, odkąd orkiestracja weszła w stan końcowy. Można na przykład ustawić wartość przechowywania 1 dzień. Jeśli aranżacja potrwa 10 dni, autopurge nie usunie jej do następnego dnia. Autopurge nie zostanie wyzwolony do momentu zakończenia orkiestracji.

Mimo że okresy przechowywania nie mają maksymalnego limitu, zalecamy unikanie przechowywania dużych ilości nieaktualnych danych aranżacji przez dłuższy czas. Ta praktyka zapewnia efektywne wykorzystanie zasobów magazynu i zapewnia optymalną wydajność aplikacji.

Typy zasad

Podczas konfigurowania zasad automatycznego przechowywania można ustawić określone lub domyślne zasady.

Domyślne zasady czyszczą dane orkiestracji niezależnie odorchestrationState. Następujące dane orkiestracji zasad obejmują wszystkie stany objęte tą funkcją po 2 dniach:
```
{
  "retentionPeriodInDays": 2
}
```
Określone zasady definiują usuwanie danych koordynacji dla określonego elementu orchestrationState. Polityka opisana poniżej informuje program Durable Task Scheduler o zachowaniu ukończonych danych orkiestracji przez 1 dzień, po czym te dane są usuwane.
```
{
  "retentionPeriodInDays": 1,
  "orchestrationState": "Completed"
}
```

Dodaj konkretne zasady, aby nadpisać domyślne zasady zastosowane do orkiestracji. W poniższym przykładzie drugie i trzecie zasady zastępują zasady domyślne ("retentionPeriodInDays": 1).

Dane skojarzone z aranżacjami completed są usuwane tak szybko, jak to możliwe.

Dane skojarzone z aranżacjami failed są czyszczone po 60 dniach.

[
  {
    "retentionPeriodInDays": 1
  },
  {
    "retentionPeriodInDays": 0,
    "orchestrationState": "Completed"
  },
  {
    "retentionPeriodInDays": 60,
    "orchestrationState": "Failed"
  }
]

Ponieważ nie ustawiono żadnych konkretnych zasad ani canceledterminated aranżacji, domyślne zasady nadal dotyczą tych zasad, przeczyszczając dane po upływie 1 dnia.

Aby uzyskać więcej informacji, zobacz specyfikację referencyjną interfejsu API dla zasad przechowywania harmonogramu zadań trwałych.

Włącz automatyczne czyszczenie

Zasady przechowywania można zdefiniować przy użyciu następujących metod:

Stała konsola dla zadań
Azure Resource Manager (ARM)
Biceps

Upewnij się, że masz najnowszą wersję rozszerzenia interfejsu wiersza polecenia rozszerzenia Durable Task.

az extension add --name durabletask
az extension update --name durabletask

Utwórz lub zaktualizuj zasady przechowywania, uruchamiając następujące polecenie.

az durabletask retention-policy create --scheduler-name SCHEDULER_NAME --resource-group RESOURCE_GROUP --default-days 1 --completed-days 0 --failed-days 60

Poniższe właściwości określają czas przechowywania dla danych orkiestracji różnych statusów.

Majątek	Opis
`--canceled-days` lub `-x`	Liczba dni przechowywania anulowanych aranżacji.
`--completed-days` lub `-c`	Liczba dni przechowywania ukończonych aranżacji.
`--default-days` lub `-d`	Liczba dni przechowywania aranżacji.
`--failed-days` lub `-f`	Liczba dni przechowywania aranżacji zakończonych niepowodzeniem.
`--terminated-days` lub `-t`	Liczba dni przechowywania zakończonych aranżacji.

Przykładowa odpowiedź

Jeśli tworzenie zakończy się pomyślnie, otrzymasz następującą odpowiedź.

{
  "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAMER/retentionPolicies/default",
  "name": "default",
  "properties": {
    "provisioningState": "Succeeded",
    "retentionPolicies": [
      {
        "retentionPeriodInDays": 1
      },
      {
        "orchestrationState": "Completed",
        "retentionPeriodInDays": 0
      },
      {
        "orchestrationState": "Failed",
        "retentionPeriodInDays": 60
      }
    ]
  },
  "resourceGroup": "RESOURCE_GROUP",
  "systemData": {
    "createdAt": "2025-04-23T23:41:17.3165122Z",
    "createdBy": "someone@microsoft.com",
    "createdByType": "User",
    "lastModifiedAt": "2025-04-23T23:41:17.3165122Z",
    "lastModifiedBy": "someone@microsoft.com",
    "lastModifiedByType": "User"
  },
  "type": "microsoft.durabletask/schedulers/retentionpolicies"
}

Wskazówka

Dowiedz się więcej o poleceniu dotyczącym zasad przechowywania, korzystając z dokumentacji CLI.

Zasady przechowywania można utworzyć lub zaktualizować przy użyciu interfejsu API usługi Azure Resource Manager, korzystając z następującego żądania. Upewnij się, że pobierasz z najnowszej wersji zapoznawczej.

PUT https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAME/retentionPolicies/default?api-version=2025-04-01-preview

{
  "properties": {
    "retentionPolicies": [
      {
        "retentionPeriodInDays": 1
      },
      {
        "retentionPeriodInDays": 0,
        "orchestrationState": "Completed"
      },
      {
        "retentionPeriodInDays": 60,
        "orchestrationState": "Failed"
      }
    ]
  }
}

Przykładowa odpowiedź

Jeśli tworzenie zakończy się pomyślnie, otrzymasz następującą odpowiedź.

{
  "properties": {
    "provisioningState": "Succeeded",
    "retentionPolicies": [
      {
        "retentionPeriodInDays": 1
      },
      {
        "retentionPeriodInDays": 0,
        "orchestrationState": "Completed"
      },
      {
        "retentionPeriodInDays": 60,
        "orchestrationState": "Failed"
      }
    ]
  },
  "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAME/retentionPolicies/default",
  "name": "default",
  "type": "Microsoft.DurableTask/schedulers/retentionPolicies",
  "systemData": {
    "createdBy": "someone@microsoft.com",
    "createdByType": "User",
    "createdAt": "2025-03-31T23:34:09.612Z",
    "lastModifiedBy": "someone@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2025-03-31T23:34:09.612Z"
  }
}

Zasady przechowywania można utworzyć lub zaktualizować, dodając konfigurację retentionPolicies do pliku Bicep. Upewnij się, że pobierasz z najnowszej wersji zapoznawczej.

resource exampleResource 'Microsoft.DurableTask/schedulers/retentionPolicies@2025-04-01-preview' = {
  parent: parentResource 
  name: 'default'
  properties: {
    retentionPolicies: [
      {
        retentionPeriodInDays: 1
      }
      {
        "retentionPeriodInDays": 0,
        "orchestrationState": "Completed"
      }
      {
        retentionPeriodInDays: 60
        orchestrationState: 'Failed'
      }
    ]
  }
}

Wyłącz autopurge

Usuń zasady przechowywania przy użyciu następującego polecenia. Planista trwałych zadań zatrzymuje proces czyszczenia danych orkiestracji w przeciągu 5 do 10 minut.

az durabletask retention-policy delete --scheduler-name SCHEDULER_NAME --resource-group RESOURCE_GROUP

Usuń zasady przechowywania przy użyciu wywołania interfejsu API.

DELETE https://management.azure.com/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAME/retentionPolicies/default?api-version=2025-04-01-preview

Dalsze kroki

Monitoruj i zarządzaj stanem oraz historią orkiestracji za pomocą pulpitu nawigacyjnego Durable Task Scheduler.

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-10-02