แชร์ผ่าน

การกำหนดค่าบันทึกการดำเนินการของโฟลว์เดสก์ท็อป

  • บทความ

หน้านี้ให้คำแนะนำในการกำหนดค่าสำหรับบันทึกของโฟลว์เดสก์ท็อป ซึ่งอยู่ใต้ส่วนคุณลักษณะของสภาพแวดล้อมใน ศูนย์จัดการ Power Platform

สำคัญ

  • คุณลักษณะนี้ใช้ได้กับโฟลว์เดสก์ท็อปที่เปิดใช้งานจากโฟลว์ระบบคลาวด์เท่านั้น และยังไม่สามารถใช้งานสำหรับการเรียกใช้แบบมีผู้ใช้ดูแลที่เครื่องจากเดสก์ท็อป Power Automate

การตั้งค่า สถานะการเปิดใช้งานของบันทึกการดำเนินการเรียกใช้ เป็นตัวกำหนดว่าเมื่อใดที่ควรบันทึกข้อมูลของบันทึกการดำเนินการเรียกใช้โฟลว์เดสก์ท็อป และยังช่วยให้คุณปิดการทำงานทั้งหมดได้ด้วย

การตั้งค่าภาพหน้าจอและระดับสภาพแวดล้อมทำให้คุณสามารถกำหนดค่าได้ว่าเมื่อใดควรบันทึกข้อมูลบันทึกของโฟลว์เดสก์ท็อป

สถานะการเปิดใช้งาน คำอธิบาย
เปิดใช้งานแล้ว (ค่าเริ่มต้น) ตัวเลือกนี้เป็นค่าเริ่มต้นสำหรับทั้งสภาพแวดล้อมที่มีอยู่และสภาพแวดล้อมใหม่ซึ่งมีการบันทึกข้อมูลบันทึกตามปกติ
ความล้มเหลวขณะเรียกใช้ ตัวเลือกนี้จะบันทึกข้อมูลเฉพาะบันทึกการดำเนินการของโฟลว์เดสก์ท็อปเมื่อมีข้อผิดพลาดรันไทม์ ซึ่งหมายความว่าจะไม่มีบันทึกสำหรับการทำงานทุกครั้ง แต่จะมีอยู่เมื่อมีข้อผิดพลาดเกิดขึ้นเท่านั้น อย่างไรก็ตาม หากเกิดข้อผิดพลาด บันทึกทั้งหมดสำหรับการเรียกใช้นั้นจะมีอยู่ รวมถึงการดำเนินการทั้งที่สำเร็จและล้มเหลว
Disabled ตัวเลือกนี้ ปิดใช้งาน บันทึกการดำเนินการเรียกใช้โฟลว์เดสก์ท็อป ทั้งหมด ได้อย่างมีประสิทธิภาพ

ข้อควรระวัง

การเปลี่ยนแปลงการตั้งค่าใดๆ เหล่านี้อาจส่งผลกระทบอย่างมีนัยสำคัญต่อคุณลักษณะต่างๆ เช่น การแก้ไขปัญหาความล้มเหลวและการตรวจสอบ พิจารณาผลกระทบของการเปลี่ยนแปลงการตั้งค่าเหล่านี้ก่อนดำเนินการต่อ

ข้อกำหนดเบื้องต้น

กำหนดค่าเวอร์ชันบันทึกการดำเนินการของโฟลว์เดสก์ท็อป

เวอร์ชันบันทึกการดำเนินการ ให้คุณสามารถเลือก V1, V2 หรือทั้งคู่

การตั้งค่าภาพหน้าจอและระดับสภาพแวดล้อมทำให้คุณสามารถกำหนดค่าบันทึกของโฟลว์เดสก์ท็อป V2

เวอร์ชันบันทึก คำอธิบาย
V1 - จัดเก็บไว้ในฟิลด์ AdditionalContext ของเอนทิตี FlowSession ตัวเลือกนี้เป็นค่าเริ่มต้น บันทึกจะถูกจัดเก็บไว้ในฟิลด์ AdditionalContext ของตาราง Flow Session ซึ่งเป็นแอตทริบิวต์ของไฟล์ที่จัดเก็บไว้ใน Blob ใน Microsoft Dataverse บันทึก V1 ใช้ ความจุของไฟล์ Dataverse
V2 - จัดเก็บไว้ในเอนทิตี FlowLogs ตัวเลือกนี้ช่วยให้คุณจัดเก็บบันทึกในตารางบันทึกของโฟลว์ ซึ่งจัดเก็บไว้ใน ตารางยืดหยุ่น บันทึก V2 ใช้ ความจุของฐานข้อมูล Dataverse
ทั้งสอง การตั้งค่านี้ช่วยให้สามารถจัดเก็บบันทึกได้ทั้งในฟิลด์ AdditionalContext เดิมของตารางเซสชันของโฟลว์และตารางบันทึกของโฟลว์ คุณลักษณะนี้ใช้ทั้งความจุไฟล์และความจุฐานข้อมูล Dataverse การตั้งค่านี้มีจุดประสงค์เพื่อการแก้ไขจุดบกพร่องหรือการทดสอบ เนื่องจากใช้ทั้ง ความจุไฟล์และความจุฐานข้อมูล Dataverse

ค่า เวลาที่ดำรงอยู่ของเอนทิตี FlowLogs เป็นนาที จะกำหนดระยะเวลาที่ควรเก็บบันทึกการดำเนินการไว้ในตารางยืดหยุ่นของบันทึกของโฟลว์ Dataverse จะลบเรกคอร์ดที่เก่ากว่ากรอบเวลาที่กำหนดโดยอัตโนมัติ ต่อไปนี้คือค่าตัวอย่างบางส่วนเพื่อความสะดวกของคุณ:

วัน นาที
หนึ่งวัน 1,440 นาที
สามวัน 4,320 นาที
เจ็ดวัน 10,080 นาที
14 วัน 20,160 นาที
28 วัน 40,320 นาที
60 วัน 86,400 นาที
90 วัน 129,600 นาที
180 วัน 259,200 นาที
365 วัน 525,600 นาที
ตลอดไป 0 (ศูนย์) นาที

หมายเหตุ

ก่อนเปิดใช้งานบันทึก V2 ตรวจสอบให้แน่ใจว่าคุณมีความจุฐานข้อมูล Dataverse เพียงพอที่จะรองรับการตั้งค่าการเก็บข้อมูล และสอดคล้องกับการวางแผนความจุ การให้สิทธิ์ และปรับเปลี่ยนตามความจำเป็น ดูที่ การคำนวณความต้องการความจุ Dataverse ตัวอย่างสำหรับบันทึก V2 ส่วนต่อไปนี้สำหรับตัวอย่างการกำหนดขนาดบางส่วน

ความแตกต่างที่สำคัญของบันทึกของโฟลว์เดสก์ท็อป V1 และ V2

ตารางต่อไปนี้อธิบายความแตกต่างระหว่างบันทึกของโฟลว์เดสก์ท็อป V1 กับ V2:

คุณสมบัติ บันทึก V1 บันทึก V2 คำอธิบาย
การเก็บข้อมูลโดยอัตโนมัติ ไม่พร้อมใช้งาน พร้อมใช้งาน V2 ใช้ ตารางยืดหยุ่น ซึ่งขับเคลื่อนโดย Azure Cosmos DB และมาพร้อมกับคุณลักษณะเวลาที่ดำรงอยู่ในตัวสำหรับการเก็บข้อมูลอัตโนมัติ
รองรับบันทึกขนาดใหญ่ บันทึกการดำเนินการประมาณ 50,000 ถึง 80,000 รายการ (สูงสุด) ประมาณสองเท่าของจำนวนบันทึกการดำเนินการ V1 (เริ่มแรก) ตามทฤษฎี V2 สามารถขยายขนาดบันทึกการดำเนินการได้ถึงกิกะไบต์ต่อการทำงานในอนาคต ขณะที่ V1 สามารถปรับขนาดเป็นปริมาณที่ระบุในตารางนี้เท่านั้น
รองรับการรายงานและการกำกับดูแลขั้นสูง ไม่พร้อมใช้งาน พร้อมใช้งาน ใน V1 แอตทริบิวต์ AdditionalContext เป็นชนิดไฟล์ที่จัดเก็บเป็นแบบ Blob ใน Dataverse ทำให้การแยกวิเคราะห์การรายงานและการควบคุมการกำกับดูแลทำได้ยาก บันทึกสามารถเข้าถึงได้มากขึ้นใน V2
รองรับการรวม Azure Synapse Link for Dataverse ไม่พร้อมใช้งาน พร้อมใช้งาน ใน V1 แอตทริบิวต์ AdditionalContext เป็นชนิดไฟล์ที่จัดเก็บเป็นแบบ Blob ใน Dataverse ซึ่งไม่รองรับการซิงโครไนซ์กับ Azure Synapse
รองรับการตรวจสอบ Dataverse ไม่พร้อมใช้งาน พร้อมใช้งาน ใน V1 แอตทริบิวต์ AdditionalContext เป็นชนิดไฟล์ที่จัดเก็บเป็นแบบ Blob ใน Dataverse ซึ่งไม่รองรับการตรวจสอบใน Dataverse
รองรับการเก็บข้อมูลระยะยาวใน Dataverse ไม่พร้อมใช้งาน ที่วางแผนไว้ ใน V1 แอตทริบิวต์ AdditionalContext เป็นชนิดไฟล์ที่จัดเก็บเป็นแบบ Blob ใน Dataverse ซึ่งไม่รองรับการเก็บข้อมูลระยะยาวใน Dataverse
อิงตามการควบคุมการเข้าถึงตามบทบาท (RBAC) ของ Dataverse พร้อมใช้งาน พร้อมใช้งาน ทั้งสองเวอร์ชันใช้ Dataverse RBAC โดยรับสิทธิ์บันทึกการดำเนินการจากเรกคอร์ดของเซสชันโฟลว์หลัก

บันทึก V2 มีการปรับปรุงที่สำคัญกว่าเวอร์ชันก่อนหน้า V1 V2 ใช้คุณลักษณะ ตารางยืดหยุ่น ซึ่งเหมาะสำหรับการจัดการข้อมูลปริมาณมาก เช่น สถานการณ์ของบันทึกการดำเนินการ และมีการเก็บข้อมูลในตัว (TTL) เหมาะสำหรับองค์กรที่ต้องการเข้าถึงข้อมูลจำนวนมากสำหรับการรายงาน การกำกับดูแล และการรวมกับการควบคุมการเก็บข้อมูลอัตโนมัติ

การคำนวณความต้องการความจุ Dataverse สำหรับบันทึก V2

ตารางต่อไปนี้แสดงตัวอย่างปริมาณการใช้ที่เก็บฐานข้อมูล Dataverse ต่อการเรียกใช้โฟลว์เดสก์ท็อปเมื่อใช้บันทึก V2 โดยสรุปความต้องการที่จัดเก็บข้อมูลโดยประมาณสำหรับการดำเนินการในจำนวนต่างๆ โดยถือว่าที่เก็บข้อมูลเฉลี่ย 3 KB ต่อการดำเนินการ

จำนวนของการดำเนินการ ความต้องการที่เก็บข้อมูลต่อการดำเนินการ (KB) ปริมาณการใช้ที่เก็บข้อมูลทั้งหมด (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

สำคัญ

ตัวเลขที่แสดงในตารางด้านบนเป็นเพียงประมาณการ และปริมาณการใช้ที่เก็บข้อมูลจริงอาจแตกต่างกันอย่างมาก ความต้องการที่เก็บข้อมูลที่แน่นอนจะขึ้นอยู่กับรายละเอียดเฉพาะและความซับซ้อนของบันทึกการดำเนินการแต่ละรายการ ดังนั้น ตัวเลขเหล่านี้จึงควรใช้เป็นแนวทางคร่าวๆ เพื่อทำความเข้าใจความต้องการที่เก็บข้อมูลที่อาจเกิดขึ้น และวางแผนความต้องการที่เก็บข้อมูลของคุณให้สอดคล้องกัน

การสอบถามข้อมูลบันทึก V2

การเข้าถึงข้อมูลบันทึกการดำเนินการของโฟลว์เดสก์ท็อปสามารถทำได้โดยการเรียก API ไปที่แบ็กเอนด์ Dataverse ไม่ว่าจะใช้ไวยากรณ์การเรียก API แบบเดิมหรือใช้วิธีการ ExecuteCosmosSqlQuery ใหม่ วิธีนี้ช่วยให้คุณสามารถดำเนินการสอบถาม SQL กับ Dataverse ทำให้สามารถดึงและกรองข้อมูลได้

โมเดลข้อมูลของบันทึก V2 ขึ้นอยู่กับความสัมพันธ์หลัก-รองระหว่างตารางเซสชันของโฟลว์และบันทึกของโฟลว์ ทุกเรกคอร์ดสืบทอดสิทธิ์จากเรกคอร์ดเซสชันของโฟลว์หลัก ในการสอบถามบันทึกการดำเนินการของการเรียกใช้โฟลว์เดสก์ท็อปที่เฉพาะเจาะจง คุณสามารถใช้ไวยากรณ์การสอบถามต่อไปนี้

ไวยากรณ์การเรียก Dataverse API เดิม

การเรียก API ต่อไปนี้ดึงข้อมูลเซสชันของโฟลว์เฉพาะตามรหัส (9d51aa1f-315e-43ab-894f-bc445dfb049b) จากนั้นเข้าถึงบันทึกการดำเนินการที่เกี่ยวข้องโดยใช้ความสัมพันธ์ flowsession_flowlog_parentobjectid

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

ไวยากรณ์การเรียก ExecuteCosmosSqlQuery API ใหม่โดยใช้ตาราง 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

เรียนรู้เพิ่มเติมเกี่ยวกับ การสอบถามคอลัมน์ JSON ในตารางยืดหยุ่น

การแบ่งการเรียกออกเป็นส่วนๆ

  • URL ฐาน (https://[my org].api.crm[my region].dynamics.com/api/data/v9.2/) เป็นตำแหน่งข้อมูลสำหรับ Dataverse Web API
  • ExecuteCosmosSqlQuery เป็นวิธีการที่ถูกเรียก วิธีนี้ช่วยให้สามารถดำเนินการสอบถาม SQL กับ Dataverse ได้
  • พารามิเตอร์สำหรับวิธีการ ExecuteCosmosSqlQuery อยู่ในวงเล็บตามชื่อวิธีการ:
    • QueryText=@p1: การสอบถาม SQL ที่จะดำเนินการ ในกรณีนี้ การสอบถามจะเลือกคุณสมบัติต่างๆ จากตารางโดยที่ ชนิด คือ 100000001 (ชนิดบันทึกการดำเนินการโฟลว์เดสก์ท็อป) และเรียงลำดับผลลัพธ์ตามคุณสมบัติ startTime ตามลำดับจากมากไปหาน้อย
    • EntityLogicalName=@p2: ส่วนนี้เป็นชื่อตรรกะของตาราง (flowlog) ที่เก็บบันทึกการดำเนินการ
    • QueryParameters=@p3: ส่วนนี้เป็นออบเจ็กต์ JSON ที่ระบุพารามิเตอร์สำหรับการสอบถาม ในตัวอย่างก่อนหน้านี้ มีการระบุคู่คีย์-ค่า โดยที่คีย์คือ @referencingParentId และ @referencingParentLogicalName ที่มีค่า flowsessionid (GUID) และชนิดตาราง flowsession
    • PageSize=p4: ส่วนนี้เป็นขนาดหน้าการสอบถาม

ข้อจำกัดที่ทราบ

  • Logs V2 สามารถใช้งานสำหรับการเรียกใช้โฟลว์เดสก์ท็อปที่เปิดใช้จากโฟลว์ระบบคลาวด์ผ่านการดำเนินการของตัวเชื่อมต่อโฟลว์เดสก์ท็อปเท่านั้น
  • ขณะนี้ตาราง บันทึกของโฟลว์ ยังไม่รองรับงานการลบจำนวนมาก
  • เรกคอร์ดบันทึกของโฟลว์ยังไม่สามารถดูได้ในส่วนตารางของ Maker Portal (make.powerapps.com)
  • การเปลี่ยนเวอร์ชันบันทึกการดำเนินการจะไม่ย้ายบันทึกการดำเนินการของโฟลว์เดสก์ท็อปก่อนหน้าไปยังชนิดที่เก็บข้อมูลบันทึกใหม่