Asztali folyamat műveleti naplóinak konfigurálása (előzetes verzió)
[Ez a témakör kiadás előtti dokumentáció, és változhat.]
Ez az oldal konfigurációs útmutatást nyújt az asztali folyamatnaplókhoz, amelyek a felügyeleti központ környezet szolgáltatásszakaszában Power Platform találhatók.
Fontos
- Ez egy előnézeti funkció.
- Az előzetes verziójú funkciók nem éles környezetben használhatók, és korlátozott funkciókkal rendelkezhetnek.
- Ez a funkció még nem érhető el az asztali számítógépről származó helyi felügyelt futtatásokhoz Power Automate .
- Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.
- Az ezen az oldalon felsorolt funkciók némelyike még fokozatosan bevezetés alatt áll, és előfordulhat, hogy még nem érhető el az Ön régiójában.
A Futtatási műveletnaplók aktiválási állapota beállítás határozza meg, hogy mikor kell rögzíteni az asztali folyamat futtatási műveletnaplóit, és lehetővé teszi azok teljes kikapcsolását is.
| Aktiválás állapota | Details |
|---|---|
| Engedélyezve (alapértelmezett) | Ez a beállítás az alapértelmezett beállítás mind a meglévő, mind az új környezetekben, ahol a naplók rögzítése a szokásos módon történik. |
| Futtatás közbeni hiba | Ez a beállítás csak futásidejű hiba esetén rögzíti az asztali folyamat műveleti naplóit. Ez azt jelenti, hogy a naplók nem érhetők el minden egyes futtatáshoz, de csak hiba esetén. Ha azonban hiba történik, az adott futtatás összes naplója elérhető, beleértve a sikeres és sikertelen műveleteket is. |
| Fogyatékos | Ez a beállítás gyakorlatilag teljesen letiltja az asztali folyamat futtatási műveletnaplóit. |
Figyelmeztetés
Ezen beállítások bármelyikének módosítása jelentős hatással lehet az olyan funkciókra, mint a futtatási hibák, a hibaelhárítás és a naplózás. A folytatás előtt gondolja át a beállítások módosításának következményeit.
Az asztali folyamat műveleti naplójának verziója (előzetes verzió)
A műveleti naplók verziója lehetővé teszi a V1, V2 vagy mindkettő kiválasztását.
| Naplók verziója | Ismertetés |
|---|---|
| V1 – A FlowSession entitás AdditionalContext mezőjében tárolva | Ez az alapértelmezett beállítás. A naplók a Flow Session tábla AdditionalContext mezőjében vannak tárolva, amely egy blobként Microsoft Dataverse tárolt fájlattribútum. A naplók V1 fájlkapacitást Dataverse használ. |
| V2 – A FlowLogs entitásban tárolva (előzetes verzió) | Ez az új beállítás lehetővé teszi, hogy a naplókat a Folyamatnaplók táblában tárolja, amely rugalmas táblákban van tárolva. A Logs V2 felhasználja az adatbázis kapacitását Dataverse . |
| Mindkettő (előzetes verzió) | Ez a beállítás lehetővé teszi a naplók tárolását a Flow Session tábla és a Folyamatnaplók tábla hagyományos AdditionalContext mezőjében is. Ez a funkció előzetes verzióban érhető el, és fájl- és adatbázis-kapacitást is Dataverse használ. Ez hibakeresési vagy tesztelési célokra szolgál, mivel adatbázis- és fájlkapacitást Dataverse ishasznál. |
A FlowLogs entitás élettartama percben (előzetes verzió) érték határozza meg, hogy mennyi ideig kell megőrizni a műveletnaplókat a Folyamatnaplók rugalmas táblában. Dataverse Automatikusan törli a megadott időkeretnél régebbi rekordokat. Íme néhány példa az értékek kényelmére.
| Napok | perc |
|---|---|
| Egy nap | 1,440 perc |
| Három nap | 4,320 perc |
| Hét nap | 10,080 perc |
| 14 nap | 20,160 perc |
| 28 nap | 40,320 perc |
| 60 nap | 86,400 perc |
| 90 nap | 129,600 perc |
| 180 nap | 259,200 perc |
| 365 nap | 525,600 perc |
| Örökre | Legfeljebb 0 (nulla) perc |
Feljegyzés
A naplók V2 engedélyezése előtt győződjön meg arról, hogy elegendő Dataverse adatbázis-kapacitással rendelkezik, amely támogatja az adatmegőrzési beállításokat, és igazodik a kapacitástervezéshez, a jogosultsághoz és szükség szerint módosítja. Néhány méretezési példáért tekintse meg a Minta Dataverse kapacitásigény-számítások a naplók V2-hez következő szakaszát.
Az asztali folyamatnaplók fő különbségei V1 és V2
Az alábbi táblázat a V1 és V2 asztali folyamatnaplók közötti különbségeket ismerteti:
| Szolgáltatás | Naplók V1 | Naplók V2 | Details |
|---|---|---|---|
| Automatikus adatmegőrzés | Nem érhető el | Elérhető | A V2 rugalmas táblákat használ, amelyeket az Azure Cosmos DB működtet, és beépített élettartam-funkcióval rendelkezik az automatikus adatmegőrzéshez. |
| Nagy rönkméretek támogatása | Nagyjából 50 000–80 000 műveletnapló (maximum) | Nagyjából kétszer annyi V1 műveletnapló (kezdetben) | A V2 a jövőben elméletileg akár gigabájtnyi műveletnaplót is skálázhat futtatásonként, míg a V1 csak a táblázatban megadott kötetre skálázható. |
| Speciális jelentéskészítés és irányítás támogatása | Nem érhető el | Elérhető | A V1-ben az AdditionalContext attribútum egy blobként Dataverse tárolt fájltípus, ami megnehezíti a jelentéskészítési és irányítási vezérlők elemzését. A naplók sokkal hozzáférhetőbbek a V2-ben. |
| Azure Synapse Link for Dataverse Az integráció támogatása | Nem érhető el | Tervezett | A V1-ben az AdditionalContext attribútum egy blobként Dataverse tárolt fájltípus, amely nem támogatott a szinkronizáláshoz Azure Synapse. |
| Naplózási Dataverse támogatás | Nem érhető el | Tervezett | A V1-ben az AdditionalContext attribútum egy blobként tárolt fájltípus, amely nem Dataverse támogatott a naplózásban Dataverse . |
| Dataverse A hosszú távú megőrzés támogatása | Nem érhető el | Tervezett | A V1-ben az AdditionalContext attribútum egy blobként Dataverse tárolt fájltípus, amely hosszú távú megőrzés esetén nem támogatott Dataverse . |
| Dataverse Szerepköralapú hozzáférés-vezérlés (RBAC) alapján | Elérhető | Elérhető | Mindkét verzió RBAC-t használ Dataverse , és örökli a műveletnapló-engedélyeket a szülő folyamat munkamenet-rekordjától. |
A Logs V2 jelentős fejlesztéseket kínál az előző, V1-es verzióhoz képest. A V2 a rugalmas táblák funkciót használja, amely kiválóan alkalmas nagy adatmennyiségek, például műveletnapló-forgatókönyvek kezelésére, és beépített adatmegőrzéssel (TTL) rendelkezik. Ideális olyan szervezetek számára, amelyeknek jelentős mennyiségű adathoz kell hozzáférniük jelentéskészítéshez, irányításhoz és integrációhoz automatikus adatmegőrzési vezérléssel.
Feljegyzés
A Folyamatnapló tábla speciális tulajdonságai alatt található Adattulajdonságok változásainak naplózása jelölőnégyzet jelölését mindaddig törölni kell, amíg a naplózás nem támogatott a V2-es naplókban. Erről és más speciális táblabeállításokról itt olvashat bővebben.
Dataverse kapacitásigény-számítások naplók esetén V2
Az alábbi táblázat a V2-es naplók használata esetén futtatott asztali folyamatonkénti mintaadatbázis-tárolási Dataverse felhasználási becsléseket mutatja be. Felvázolja a különböző számú művelet hozzávetőleges tárolási igényét, műveletenként átlagosan 3 KB tárterületet feltételezve.
| Tevékenységek száma | Műveletenkénti tárolási igény (KB) | Teljes tárterület-felhasználás (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 |
Fontos
A fenti táblázatban látható adatok csak becslések, és a tényleges tárterület-felhasználás jelentősen eltérhet. A pontos tárolási igény az egyes műveletnaplók konkrét részleteitől és összetettségétől függ. Ezért ezeket a számokat hozzávetőleges útmutatóként kell használni a potenciális tárolási igény megértéséhez és a tárolási követelmények ennek megfelelő megtervezéséhez.
Naplók lekérdezése V2-adatok
Az asztali folyamat műveleti naplóinak adataihoz való hozzáférés úgy érhető el, hogy API-hívást kezdeményez a Dataverse háttérhez a hagyományos API-hívási szintaxissal vagy az új ExecuteCosmosSqlQuery metódussal. Ez a módszer lehetővé teszi SQL-lekérdezés Dataverse végrehajtását, lehetővé téve az adatok beolvasását és szűrését.
A V2 naplók adatmodellje a Flow Session és a Flow Log táblák közötti szülő-gyermek kapcsolaton alapul. Minden rekord örökli az engedélyeket a szülő folyamatmunkamenet-rekordjától. Egy adott asztali folyamat futtatásának műveleti naplóinak lekérdezéséhez használhatja a következő lekérdezési szintaxist.
Hagyományos Dataverse API-hívási szintaxis
A következő API-hívás lekér egy adott folyamatmunkamenetet az azonosítója (9d51aa1f-315e-43ab-894f-bc445dfb049b) alapján, majd a flowsession_flowlog_parentobjectid kapcsolat használatával hozzáfér a társított műveleti naplókhoz.
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
Új ExecuteCosmosSqlQuery API-hívásszintaxis a FlowLogs tábla használatával
[Organization URI]/api/data/v9.2/ExecuteCosmosSqlQuery(
QueryText=@p1,EntityLogicalName=@p2,PartitionId=@p3,QueryParameters=@p4,PageSize=@p5)?
@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='flowsession_9d51aa1f-315e-43ab-894f-bc445dfb049b'&
@p4={"Keys":["@referencingParentId"],"Values":[{"Type":"System.Guid","Value":"9d51aa1f-315e-43ab-894f-bc445dfb049b"}]}&@p5=50
További információ a JSON-oszlopok rugalmas táblákban való lekérdezéséről.
A hívás különálló darabokra bontása
- Az alap URL-cím (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) a webes API végpont Dataverse .
- Az ExecuteCosmosSqlQuery a hívott metódus. Ez a módszer lehetővé teszi egy SQL-lekérdezés Dataverse végrehajtását.
- Az ExecuteCosmosSqlQuery metódus paraméterei zárójelben vannak megadva a metódus neve után. Ezek a következők:
QueryText=@p1: A végrehajtandó SQL-lekérdezés. Ebben az esetben a lekérdezés különböző tulajdonságokat választ ki egy táblából, ahol a típus 100000001 (asztali folyamat műveletnapló típusa), és az eredményeket a startTime tulajdonság szerint csökkenő sorrendbe rendezi.EntityLogicalName=@p2: Ez a műveletnaplókat tároló tábla (flowlog) logikai neve.PartitionId=@p3: Ezzel a paraméterrel azonosítható az Azure-on Cosmos DB belüli partíció, ahol a lekérdezést végre kell hajtani. Be van állítvaflowsession_[flowsessionid].QueryParameters=@p4: Ez egy JSON-objektum, amely paramétereket ad meg a lekérdezéshez. Az előző példában egy kulcs-érték pár ad meg, ahol a kulcs@referencingParentIdés az érték theflowsessionid(GUID).
Ismert korlátozások
- A naplók V2 csak olyan asztali folyamatfuttatásokhoz érhetők el, amelyek felhőfolyamatból indulnak el az asztali folyamatösszekötő műveleten keresztül.
- A műveletnapló verziójának módosítása nem telepíti át az asztali folyamat korábbi műveleti naplóit az új naplótároló-típusba.
- A kaszkádolt törlés jelenleg nem támogatott. Folyamat munkamenet-rekordjának törlésekor a mögöttes naplók nem törlődnek automatikusan.
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: