Työpöydän työnkulkutoimintolokien määritykset
Tämä sivu sisältää määritysohjeita työpöytätyönkulkujen lokeille, jotka sijaitsevat ympäristön ominaisuusosassa Power Platformin hallintakeskuksessa.
Tärkeää
- Tämä ominaisuus on käytettävissä vain sellaisiin työpöytätyönkulkuihin, jotka käynnistetään pilvityönkuluista, eikä ole vielä käytettävissä Power Automaten paikallisiin valvottuihin suorituksiin.
Suoritettujen toimintojen aktivointitila -asetus määrittää, milloin työpöytätyönkulun suoritettujen toimintojen lokeja pitäisi tallentaa, ja mahdollistaa myös niiden kokonaan käytöstä poistamisen.
| Aktivoinnin tila | Details |
|---|---|
| Käytössä (oletus) | Tämä asetus on oletusarvo sekä olemassa oleville että uusille ympäristöille, joissa lokit tallennetaan tavanomaiseen tapaan. |
| Suorittamisen virhe | Tämä vaihtoehto tallentaa työpöytätyönkulkujen toimintolokeja vain, kun tapahtuu suorituspalvelun aikainen virhe. Tämä tarkoittaa, että lokeja ei ole saatavilla jokaisesta suorituksista, vaan vain niistä, joissa tapahtuu virhe. Jos kuitenkin tapahtuu virhe, kaikki kulloisenkin suorituksen lokit ovat käytettävissä sisältäen sekä onnistuneet että epäonnistuneet toiminnot. |
| Disabled | Tämä asetus poistaa käytöstä tehokkaasti työpöytätyönkulun toimintolokit kokonaan. |
Varoitus
Näiden asetusten muuttaminen voi vaikuttaa merkittävästi ominaisuuksiin, kuten suoritusvirheiden vianmääritykseen ja seurantaan. Ota huomioon näiden asetusten muuttamisen vaikutukset, ennen kuin jatkat.
edellytykset
- Power Automaten Premium-käyttöoikeus ja järjestelmänvalvojan oikeudet määrittää lokiasetuksia
- Power Automaten URL- ja IP-osoitemääritykset
Työpöytätyönkulun toimintolokin version määritys
Toimintolokien versio mahdollistaa valinnat V1, V2 ja molemmat.
| Lokien versio | Selitys |
|---|---|
| V1 – Tallennettu FlowSession-entiteetin AdditionalContext-kenttään | Tämä vaihtoehto on oletusasetus. Lokit tallennetaan työnkulkuistunnon taulukon AdditionalContext-kenttään, joka on blob-objektina Microsoft Dataverseen tallennettu tiedostomäärite . V1-lokit kuluttavat Dataversen tiedostokapasiteettia. |
| V2 – tallennettu FlowLogs-entiteettiin | Tämän vaihtoehdon avulla voit tallentaa lokit työnkulkulokien taulukkoon, joka tallennetaan Joustaviin taulukkoihin. V2-lokit kuluttavat Dataversen tietokantakapasiteettia. |
| Molemmat | Tämä asetus mahdollistaa lokien tallentamisen sekä perinteiseen työnkulkuistunnon taulukon AdditionalContext-kenttään että työnkulkulokien taulukkoon. Tämä kuluttaa Dataversen sekä tiedosto- että tietokantakapasiteettia. Tämä asetus on tarkoitettu virheenkorjaukseen tai testaamiseen, koska se kuluttaa Dataversen sekä tietokanta- että tiedostokapasiteettia. |
FlowLogs-entiteetin käyttöaika minuuteissa -arvo määrittää, kuinka pitkään toimintolokit säilytetään joustavassa työnkulkulokien taulukossa. Dataverse poistaa automaattisesti tietueet, jotka ovat määritettyä aikaväliä vanhempia. Seuraavassa on esimerkkiarvoja.
| Viikonpäivät | Minuutit |
|---|---|
| Yksi päivä | 1 440 minuuttia |
| Kolme päivää | 4 320 minuuttia |
| Seitsemän päivää | 10 080 minuuttia |
| 14 päivää | 20 160 minuuttia |
| 28 päivää | 40 320 minuuttia |
| 60 päivää | 86 400 minuuttia |
| 90 päivää | 129 600 minuuttia |
| 180 päivää | 259 200 minuuttia |
| 365 päivää | 525 600 minuuttia |
| Aina | 0 (nolla) minuuttia |
Muistiinpano
Varmista ennen V2-lokien käyttöönottoa, että sinulla on riittävästi Dataversen tietokantakapasiteettia tukemaan tietojen säilytyskäytäntöä ja sopimaan yhteen kapasiteettisuunnittelusi ja oikeuksiesi kanssa ja tee tarvittaessa muutoksia. Katso mitoitusesimerkkejä seuraavasta osasta Esimerkkejä V2-lokien Dataverse-kapasiteetin tarvelaskennoista.
Keskeiset erot työpöytätyönkulkujen lokien versioiden V1 ja V2 välillä
Seuraavassa taulukossa on kuvattu työpöytätyönkulkujen lokien versioiden V1 ja V2 erot:
| Ominaisuus | V1-lokit | V2-lokit | Details |
|---|---|---|---|
| Automaattinen tietojen säilytys | Ei käytettävissä | Saatavilla | V2-lokit käyttävät joustavia taulukkoja, joissa käytetään Azure Cosmos DB:tä, ja ne sisältävät käyttöikätoiminnon automaattista tietojen säilyttämistä varten. |
| Suurten lokikokojen tuki | Jopa noin 50 000–80 000 toimintolokia (enintään) | Noin kaksinkertainen määrä V1-toimintolokeihin verrattuna (aluksi) | V2-lokit voisivat teoriassa tulevaisuudessa kasvattaa suorituskohtaisten toimintolokien koon gigabitteihin, kun taas V1-lokien koko voi kasvaa vain tässä taulukossa esitetyllä tavalla. |
| Kehittyneen raportoinnin ja hallinnon tuki | Ei käytettävissä | Saatavilla | V1-lokeissa AdditionalContext-määrite on tiedostotyyppi, joka tallennetaan Dataverseen blob-objektina, mikä tekee jäsentämisestä raportoinnin ja hallinnon valvontaa varten haastavaa. V2-lokit ovat paljon paremmin käytettävissä. |
| Azure Synapse Link for Dataverse -integroinnin tuki | Ei käytettävissä | Saatavilla | V1-lokeissa AdditionalContext-määrite on tiedostotyyppi, joka tallennetaan Dataverseen bolb-objektina, jonka synkronointia Azure Synapseen ei tueta. |
| Dataverse-valvonnan tuki | Ei käytettävissä | Saatavilla | V1-lokeissa AdditionalContext-määrite on tiedostotyyppi, joka tallennetaan Dataverseen bolb-objektina, jota ei tueta Dataverse-valvonnassa. |
| Pitkäaikaisen Dataversessä säilyttämisen tuki | Ei käytettävissä | Suunniteltu | V1-lokeissa AdditionalContext-määrite on tiedostotyyppi, joka tallennetaan Dataverseen bolb-objektina, jota ei Dataversen pitkäaikaisessa säilytyksessä. |
| Dataversen roolipohjaiseen käyttöoikeuksien hallintaan (RBAC) perustuen | Saatavilla | Saatavilla | Molemmissa versioissa käytetään Dataversen roolipohjaista käyttöoikeuksien hallintaa siten, että toimintolokien oikeudet peritään päätason työnkulun istuntotietueesta. |
V2-lokit sisältävät huomattavia parannuksia aiempaan V1-versioon nähden. V2-lokeissa käytetään joustavien taulukkojen ominaisuutta, joka sopii erinomaisesti suurten tietomäärien käsittelyyn, kuten toimintolokiskenaarioihin, ja sisältää tietojen säilytyksen. Ne sopivat ihanteellisesti organisaatioille, joiden on käytettävä merkittäviä tietomääriä raportointia, hallintoa ja integrointia hyödyntäen automaattista tietojen säilyttämisen hallintaa.
V2-lokien Dataverse-kapasiteetin tarvelaskennat
Seuraavassa taulukossa on esimerkki Dataversen tietokantatallennustilan käyttöarvioista työpöytätyönkulkua kohden käytettäessä V2-lokeja. Siinä esitetään eri toimintomäärien arvioitu tallennustilan tarve olettaen, että toimintokohtainen tallennustilan tarve on keskimäärin 3 kt.
| Toimintojen lukumäärä | Tallennustilan tarve toimintoa kohden (kt) | Käytetyn tallennustilan kokonaismäärä (Mt) |
|---|---|---|
| 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 |
Tärkeää
Edellä olevassa taulukossa esitetyt luvut ovat vain arvioita, ja todellinen tallennustilan käyttö voi poiketa siitä merkittävästi. Tarkka tallennustilan tarve määräytyy kunkin toimintolokin erityispiirteiden ja monimutkaisuuden mukaan. Siksi näitä lukuja pitäisi käyttää karkeana ohjenuorana mahdollisen tallennustilantarpeen ymmärtämiseen ja tallennustilatarpeen suunnittelemiseen niiden mukaan.
V2-lokien tietojen kyseleminen
Työpöytätyönkulkujen toimintolokien tietoja voidaan saada käyttöön tekemällä ohjelmointirajapintakutsu Dataversen taustajärjestelmään käyttäen joko perinteistä ohjelmointirajapintakutsujen syntaksia tai uutta ExecuteCosmosSqlQuery-menetelmää. Tämän menetelmän avulla voit suorittaa SQL-kyselyn Dataverseen, mikä mahdollistaa tietojen noutamisen ja suodatuksen.
V2-lokien tietomalli perustuu ali-pääelementtisuhteeseen työnkulkuistunnon taulukon ja työnkulkulokin taulukon välillä. Kukin tietue perii oikeudet ylätason työnkulkunsa istuntotietueesta. Tietyn työpöytätyönkulun suorituksen toimintolokeihin suoritettaviin kyselyihin voi käyttää seuraavaa kyselysyntaksia.
Perinteinen Dataversen ohjelmointirajapintakutsun syntaksi
Seuraava ohjelmointirajapintakutsu noutaa tietyn työnkulkuistunnon tunnuksensa (9d51aa1f-315e-43ab-894f-bc445dfb049b) perusteella ja käyttää sitten siihen liittyviä toimintolokeja käyttäen suhdetta flowsession_flowlog_parentobjectid.
[Organization URI]/api/data/v9.0/flowsessions(9d51aa1f-315e-43ab-894f-bc445dfb049b)/flowsession_flowlog_parentobjectid
Uusi ohjelmointirajapintakutsun syntaksi ExecuteCosmosSqlQuery käyttäen FlowLogs-taulukkoa
[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
Lue lisää JSON-sarakkeisiin suoritettavista kyselyistä joustavissa taulukoissa.
Kutsun jakaminen yksittäisiin osiin
- Perus-URL-osoite (https://[oma organisaatio].api.crm[oma alue].dynamics.com/api/data/v9.2/) on Dataversen verkko-ohjelmointirajapinnan päätepiste.
- ExecuteCosmosSqlQuery on kutsuttava menetelmä. Tämä menetelmä mahdollistaa SQL-kyselyn suorittamisen Dataverseen.
- ExecuteCosmosSqlQuery-menetelmän parametrit annetaan sulkeissa menetelmän nimen jälkeen:
QueryText=@p1: Suoritettava SQL-kysely. Tässä tapauksessa kysely valitsee taulukosta erilaisia ominaisuuksia, joiden tyyppi on 100000001 (työpöytätyönkulun lokityyppi), ja järjestää tulokset laskevassa startTime-ominaisuuden mukaiseen järjestykseen.EntityLogicalName=@p2: Tämä osa on toimintolokien tallennuspaikkana toimivan taulukon (flowlog) looginen nimi.QueryParameters=@p3: Tämä osa on JSON-objekti, joka määrittää kyselyn parametrit. Edellisessä esimerkissä se määrittää avain-arvoparin, jonka avaimet ovat@referencingParentIdja@referencingParentLogicalNameja arvotflowsessionid(GUID) ja taulukonflowsessiontyyppi.PageSize=p4: Tämä osa on kyselysivun koko.
Tunnetut rajoitukset
- V2-lokit ovat käytettävissä vain sellaisten työpöytätyönkulkujen suoritusten osalta, jotka käynnistetään pilvityönkulussa työpöytätyönkulun yhdistintoimintoa käyttäen.
- Joukkopoistotehtäviä ei tällä hetkellä tueta Työnkulkuloki-taulukon osalta.
- Työnkulkulokitietueita ei voi vielä tarkastella Maker Portalin Taulukko-osassa (make.powerapps.com).
- Toimintolokin version muuttaminen ei siirrä aiempia työpöytätyönkulkujen toimintolokeja uuteen lokien tallennustilatyyppiin.