Udostępnij za pośrednictwem

Konfiguracja dzienników akcji przepływu pulpitu

  • Artykuł

Ta strona zawiera wskazówki dotyczące konfigurowania dzienników przepływu pulpitu, które są umieszczone w sekcji funkcji środowiska w centrum administracyjnym Power Platform.

Ważne

  • Ta funkcja ma zastosowanie tylko do przepływów pulpitu, które są uruchamiane z przepływu w chmurze i nie jest jeszcze dostępna dla lokalnych uczestników uruchamianych z aplikacji klasycznej Power Automate.

Ustawienie Stan aktywacji dzienników akcji uruchamiania określa, kiedy powinny być przechwytywane dzienniki akcji uruchomienia przepływu pulpitu, a nawet można je całkowicie wyłączyć.

Zrzut ekranu i ustawienie na poziomie środowiska umożliwiające skonfigurowanie ustawień określających czas przechwytywania dzienników przepływu pulpitu.

Stan aktywacji Details
Włączone (domyślnie) Ta opcja jest ustawieniem domyślnym zarówno w istniejących, jak i nowych środowiskach, w których dzienniki są przechwytywane w sposób normalny.
Po niepowodzeniu przebiegu Ta opcja umożliwia przechwytywanie dzienników akcji przepływu pulpitu tylko wtedy, gdy wystąpi błąd środowiska uruchomieniowego. Oznacza to, że dzienniki nie są dostępne przy każdym uruchomieniu, ale tylko w przypadku wystąpienia błędu. Jeśli jednak wystąpi błąd, będą dostępne wszystkie dzienniki danego uruchomienia, w tym zarówno akcje pomyślne, jak i te, które zakończyły się niepowodzeniem.
Disabled Ta opcja powoduje całkowite wyłączenie dzienników akcji przebiegu przepływu pulpitu.

Uwaga

Zmiana tych ustawień może mieć znaczący wpływ na funkcje, takie jak rozwiązywanie problemów z niepowodzeniem i inspekcja. Rozważ konsekwencje zmiany tych ustawień przed przystąpieniem do pracy.

Wymagania wstępne

Konfiguracja wersji dzienników akcji przepływu pulpitu

Wersja dzienników akcji umożliwia wybranie wersji V1, V2 lub obu tych wersji.

Zrzut ekranu i ustawienie na poziomie środowiska umożliwiające skonfigurowanie ustawień dzienników przepływu pulpitu V2.

Wersja dzienników Objaśnienie
V1 — wartość przechowywana w polu AdditionalContext encji FlowSession Ta opcja jest domyślna. Dzienniki są przechowywane w polu AdditionalContext tabeli Sesji przepływu, która jest atrybutem pliku przechowywanym jako obiekt blob w Microsoft Dataverse. Dzienniki V1 zużywają wydajność plików Dataverse.
V2 — wartość przechowywana w encji FlowLogs Ta opcja umożliwia przechowywanie dzienników w tabeli dzienników przepływu, która jest przechowywana w Tabelach elastycznych. Dzienniki V2 zużywają wydajność bazy danych Dataverse.
Oba To ustawienie umożliwia przechowywanie dzienników w tradycyjnych polach AdditionalContext tabeli sesji przepływu i tabeli dzienników przepływu. Funkcja ta jest dostępna i zużywa zarówno wydajność plików, jak i bazy danych Dataverse. To ustawienie przeznaczone do debugowania lub testowania, ponieważ zużywa jednocześnie wydajność bazy danych i plików Dataverse.

Czas wygaśnięcia encji FlowLogs określa czas działania dzienników przepływu pracy, jak długo mają zostać zachowane dzienniki przepływu. Dataverse automatycznie usuwa rekordy, które są starsze niż określony czas. Oto kilka przykładowych wartości podanych dla Twojej wygody.

dni Minuty
Jeden dzień 1,440 min
Trzy dni 4,320 min
Siedem dni 10,080 min
14 dni 20,160 min
28 dni 40,320 min
60 dni 86,400 min
90 dni 129,600 min
180 dni 259,200 min
365 dni 525,600 min
Zawsze Mniejsze niż lub równe 0 (zero) minut

Uwaga

Przed włączeniem dzienników V2 należy upewnić się, wydajność bazy danych Dataverse jest wystarczająca do obsługi ustawień przechowywania danych i jest wyrównana z planowaniem wydajności, uprawnieniami i dostosowywaniem w razie potrzeby. Aby zobaczyć niektóre przykłady określania rozmiarów, przejdź do poniższej sekcji Przykładowe obliczenia zapotrzebowania na wydajność w przypadku dzienników Dataverse V2.

Kluczowe różnice w dziennikach przepływu pulpitu V1 i V2

W poniższej tabeli opisano różnice między dziennikami przepływu pulpitu V1 i V2:

Funkcja Dzienniki V1 Dzienniki V2 Details
Automatyczne przechowywanie danych Niedostępne Dostępna W wersji V2 są używane Tabele elastyczne, które są obsługiwane przez Azure Cosmos DB i mają wbudowaną funkcję automatycznego przechowywania danych.
Obsługa dużych rozmiarów dzienników W przybliżeniu do 50 000 do 80 000 dzienników akcji (maksymalnie) W przybliżeniu dwa razy więcej dzienników akcji V1 (na początku) Wersja V2 może w przyszłości skalować się do gigabajtów wartości dzienników akcji, podczas gdy wersja V1 może być skalowana tylko do takiej ilości, jaka jest podana w poniższej tabeli.
Obsługa zaawansowanych funkcji raportowania i ładu Niedostępne Dostępna W wersji V1 atrybut AdditionalContext jest typem pliku przechowywanym jako obiekt blob w Dataverse, co stanowi wyzwanie dla analiz kontrolek raportowania i ładu. Dzienniki są o wiele bardziej dostępne w wersji V2.
Obsługa integracji w usłudze Azure Synapse Link for Dataverse Niedostępne Dostępna W wersji V1 atrybut AdditionalContext jest typem pliku przechowywanym jako obiekt blob Dataverse, który nie jest obsługiwany podczas synchronizacji Azure Synapse.
Obsługa inspekcja dla Dataverse Niedostępne Dostępna W wersji V1 atrybut AdditionalContext jest typem pliku przechowywanym jako obiekt blob Dataverse, który nie jest obsługiwany podczas inspekcji w Dataverse.
Obsługa przechowywania długoterminowego Dataverse Niedostępne Planowane W wersji V1 atrybut AdditionalContext jest typem pliku przechowywanym jako obiekt blob Dataverse, który nie jest obsługiwany podczas przechowywania długoterminowego w Dataverse.
W oparciu o kontrolę dostępu na podstawie ról (RBAC) w Dataverse Dostępna Dostępna W obu wersjach jest używana kontrola Dataverse RBAC, która dziedziczy uprawnienia dziennika akcji po rekordzie sesji przepływu nadrzędnego.

Dzienniki V2 oferują znaczne ulepszenia w związku z poprzednią wersją, V1. W wersji V2 jest używana funkcja tabel elastycznych, która świetnie nadaje się do obsługi dużych ilości danych, takich jak scenariusze w dziennikach akcji, i ma wbudowane przechowywanie danych (TTL). Idealna opcja dla organizacji potrzebujących dostępu do dużych ilości danych na potrzeby raportowania, przechowywania i integracji z kontrolą automatycznego przechowywania danych.

Obliczenia dotyczące wymagania wydajności Dataverse dla dzienników V2

W poniższej tabeli przedstawiono przykładowe szacowane wartości magazynu baz danych Dataverse na przebieg przepływu pulpitu w przypadku używania dzienników V2. Przyjmuje w zarysie szacowane zapotrzebowanie na magazyn dla różnych akcji, przy założeniu że średnia wartość to 3 KB magazynu na akcję.

Liczba akcji Zapotrzebowanie na magazyn na akcję (KB) Łączny rozmiar magazynu (MB)
1,000 3 2.93
10,000 3 29.3
30,000 3 87.9
60,000 3 175.8
100,000 3 293
160,000 3 480

Ważne

Wyniki przedstawione w powyższej tabeli to tylko prognozy, a rzeczywista ilość miejsca w magazynie może znacząco się różnić. Dokładne zapotrzebowanie na magazyn zależy od konkretnych szczegółów i stopnia złożoności każdego dziennika akcji. Dlatego te liczby powinny być używane jako przewodnik interpretacji potencjalnego zapotrzebowania na przechowywanie danych i planowania wymagań dotyczących magazynu.

Wykonywanie zapytań dotyczących danych w dziennikach V2

Dostęp do danych dzienników akcji przepływu pulpitu można uzyskać, wywołując interfejs API do wewnętrznej bazy danych Dataverse, używając tradycyjnej składni wywołań interfejsu API lub nowej metody ExecuteCosmosSqlQuery. Ta metoda umożliwia wykonywanie zapytania SQL w Dataverse, włączenie pobierania i filtrowania danych.

Model danych dzienników V2 jest oparty na relacji nadrzędny-podrzędny między sesji przepływu a tabelami dzienników przepływu. Każdy rekord dziedziczy uprawnienia po swoim rekordzie sesji przepływu nadrzędnego. Aby utworzyć zapytania dotyczące dzienników akcji określonego przepływu pulpitu, można użyć następującej składni zapytania.

Tradycyjna sposób składnia wywołań interfejsu API Dataverse

Następujące wywołanie interfejsu API pobiera określoną sesji przepływu za pomocą identyfikatora (9d51aa1f-315e-43ab-894f-bc445dfb049b), a następnie uzyskuje dostęp do skojarzonych dzienników akcji przy użyciu relacji flowsession_flowlog_parentobjectid.

[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid

Nowa składnia wywołań interfejsu API ExecuteCosmosSqlQuery przy użyciu tabeli FlowLogs

    [Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
    QueryText=@p1,EntityLogicalName=@p2,QueryParameters=@p3,PageSize=@p4)?
    @p1: 'SELECT c.props.flowlogid as flowlogid, c.props.createdon as createdon, c.props.data as data, c.props.level as level, c.props.type as type, c.ttl as ttlinseconds, c.props.cloudflowid as cloudflowid, c.props.cloudflowrunid as cloudflowrunid, c.props.desktopflowid as desktopflowid, c.props.flowmachineid as flowmachineid, c.props.flowmachinegroupid as flowmachinegroupid, c.props.flowsessionid as flowsessionid, c.props.workqueueid as workqueueid, c.props.workqueueitemid as workqueueitemid FROM c WHERE c.props.type IN (100000001) ORDER BY c.props.data.startTime DESC'
    @p2: 'flowlog'
    @p3: {"Keys":["@referencingParentId","@referencingParentLogicalName"],"Values":[{"Type":"System.Guid","Value":"40590757-a9c0-4f4c-abfc-e2f389049d90"},{"Type":"System.String","Value":"flowsession"}]}
    @p4: 50

Dowiedz się więcej o zapytaniach o kolumny JSON w tabelach elastycznych.

Dzielenie wywołania na poszczególne fragmenty

  • Podstawowy adres URL (https://[moja organizacja].api.crm[mój region].dynamics.com/api/data/v9.2/) to punkt końcowy internetowego interfejsu API Dataverse.
  • Metoda ExecuteCosmosSqlQuery to wywoływana metoda. Ta metoda umożliwia wykonywanie zapytania SQL w Dataverse.
  • Parametry metody ExecuteCosmosSqlQuery są podane w elementach nadrzędnych następujący po nazwie metody:
    • QueryText=@p1: zapytanie SQL do wykonania. W takim przypadku zapytanie wybiera różne właściwości z tabeli, w której typ to 100000001 (typ dziennika akcji przepływu pulpitu) i porządkuje wyniki według właściwości startTime w porządku malejącym.
    • EntityLogicalName=@p2: logiczna nazwa tabeli (flowlog), w których są przechowywane dzienniki akcji.
    • QueryParameters=@p3: jest to obiekt JSON określający parametry zapytania. W poprzednim przykładzie określono parę klucz-wartość, w której kluczami są @referencingParentId i @referencingParentLogicalName z wartościami flowsessionid (GUID) i typem tabeli flowsession.
    • PageSize=p4: Ta sekcja to rozmiar strony zapytania.

Znane ograniczenia

  • Dzienniki V2 są dostępne tylko dla przepływów pulpitów uruchamianych z przepływu w chmurze za pośrednictwem akcji łącznika przepływu pulpitu.
  • Zadania masowego usuwania nie są obecnie obsługiwane dla tabeli dziennik przepływu.
  • Rekordy dziennika przepływu nie mogą być jeszcze wyświetlane w sekcji Tabela portalu twórców (make.powerapps.com).
  • Zmiana wersji dziennika akcji nie migruje poprzednich dzienników akcji przepływu pulpitu do nowego typu magazynu dzienników.