डेस्कटॉप प्रवाह क्रिया लॉग कॉन्फ़िगरेशन (पूर्वावलोकन)

[यह विषय पूर्व-रिलीज़ दस्तावेज़ है और इसमें परिवर्तन हो सकता है।]

यह पृष्ठ डेस्कटॉप प्रवाह लॉग के लिए कॉन्फ़िगरेशन मार्गदर्शन प्रदान करता है, जो व्यवस्थापन केंद्र में पर्यावरण के सुविधा अनुभाग के अंतर्गत स्थित है। Power Platform

महत्त्वपूर्ण

• यह एक पूर्वावलोकन सुविधा है.
• पूर्वावलोकन सुविधाएँ उत्पादन में उपयोग के लिए नहीं हैं और इनकी कार्यक्षमता सीमित हो सकती है।
• यह सुविधा अभी डेस्कटॉप से ​​स्थानीय रूप से आयोजित रन के लिए उपलब्ध नहीं है। Power Automate
• यह सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध होती हैं ताकि ग्राहक शीघ्र पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें.

रन एक्शन लॉग की सक्रियण स्थिति सेटिंग यह परिभाषित करती है कि डेस्कटॉप फ्लो रन एक्शन लॉग कब कैप्चर किए जाने चाहिए और यहां तक ​​कि आपको उन्हें पूरी तरह से बंद करने की भी अनुमति देती है।

सक्रियण की स्थिति	Details
सक्षम (डिफ़ॉल्ट)	यह विकल्प मौजूदा और नए दोनों वातावरणों के लिए डिफ़ॉल्ट है, जहां लॉग सामान्य रूप से कैप्चर किए जाते हैं।
रन विफलता पर	यह विकल्प केवल तभी डेस्कटॉप प्रवाह क्रिया लॉग कैप्चर करता है जब कोई रनटाइम त्रुटि होती है. इसका अर्थ यह है कि लॉग प्रत्येक रन के लिए उपलब्ध नहीं होते, बल्कि केवल तभी उपलब्ध होते हैं जब कोई त्रुटि घटित होती है। हालाँकि, यदि कोई त्रुटि घटित होती है, तो उस विशेष रन के सभी लॉग उपलब्ध होते हैं, जिनमें सफल और असफल दोनों क्रियाएं शामिल होती हैं।
अक्षम	यह विकल्प डेस्कटॉप फ्लो रन एक्शन लॉग को पूरी तरह से अक्षम कर देता है।

सावधानी

इनमें से किसी भी सेटिंग को बदलने से रन विफलता समस्या निवारण और ऑडिटिंग जैसी सुविधाओं पर महत्वपूर्ण प्रभाव पड़ सकता है। आगे बढ़ने से पहले इन सेटिंग्स को बदलने के प्रभावों पर विचार करें।

डेस्कटॉप प्रवाह क्रिया लॉग संस्करण कॉन्फ़िगर करें (पूर्वावलोकन)

एक्शन लॉग संस्करण आपको V1, V2, या दोनों चुनने की अनुमति देता है।

लॉग्स संस्करण	स्पष्टीकरण
V1 - FlowSession इकाई के AdditionalContext फ़ील्ड में संग्रहीत	यह विकल्प डिफ़ॉल्ट है. लॉग को फ्लो सत्र तालिका के AdditionalContext फ़ील्ड में संग्रहीत किया जाता है, जो एक फ़ाइल विशेषता है जिसे Microsoft Dataverse में ब्लॉब के रूप में संग्रहीत किया जाता है। लॉग V1 फ़ाइल क्षमता का उपभोग करता है. Dataverse
V2 - FlowLogs इकाई में संग्रहीत (पूर्वावलोकन)	यह नया विकल्प आपको लॉग को फ़्लो लॉग तालिका में संग्रहीत करने की अनुमति देता है, जिसे इलास्टिक टेबल्स में संग्रहीत किया जाता है। लॉग V2 Dataverse डेटाबेस क्षमता का उपभोग करता है।
दोनों (पूर्वावलोकन)	यह सेटिंग लॉग को प्रवाह सत्र तालिका के पारंपरिक अतिरिक्त संदर्भ फ़ील्ड और प्रवाह लॉग तालिका दोनों में संग्रहीत करने की अनुमति देती है। यह सुविधा पूर्वावलोकन में है और फ़ाइल और डेटाबेस दोनों क्षमता का उपभोग करती है। Dataverse यह डिबगिंग या परीक्षण उद्देश्यों के लिए है क्योंकि यह Dataverse डेटाबेस और फ़ाइल क्षमता दोनों का उपभोग करता है।

FlowLogs इकाई का जीवित रहने का समय (पूर्वावलोकन) मान यह निर्धारित करता है कि Flow Logs लोचदार तालिका में क्रिया लॉग को कितने समय तक बनाए रखा जाना चाहिए। 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 डेटाबेस क्षमता है जो डेटा अवधारण सेटिंग्स का समर्थन करेगी और आपकी क्षमता नियोजन, पात्रता के साथ संरेखित होगी और आवश्यकतानुसार समायोजित होगी। कुछ आकार उदाहरणों के लिए निम्न अनुभाग में लॉग V2 के लिए नमूना क्षमता मांग गणना देखें। Dataverse

डेस्कटॉप फ्लो लॉग V1 और V2 के मुख्य अंतर

निम्न तालिका डेस्कटॉप प्रवाह लॉग V1 और V2 के बीच अंतर का वर्णन करती है:

लक्षण	लॉग्स V1	लॉग्स V2	Details
स्वचालित डेटा अवधारण	उपलब्ध नहीं	उपलब्ध	V2 इलास्टिक टेबल्स का उपयोग करता है, जो Azure द्वारा संचालित होते हैं और स्वचालित डेटा अवधारण के लिए अंतर्निहित टाइम-टू-लाइव सुविधा के साथ आते हैं। Cosmos DB
बड़े लॉग आकारों के लिए समर्थन	मोटे तौर पर 50,000 से 80,000 तक एक्शन लॉग (अधिकतम)	V1 एक्शन लॉग की संख्या लगभग दोगुनी (आरंभिक)	भविष्य में V2 सैद्धांतिक रूप से प्रति रन एक्शन लॉग के गीगाबाइट्स तक स्केल कर सकता है, जबकि V1 केवल इस तालिका में निर्दिष्ट मात्रा तक ही स्केल कर सकता है।
उन्नत रिपोर्टिंग और प्रशासन के लिए समर्थन	उपलब्ध नहीं	उपलब्ध	V1 में, AdditionalContext विशेषता एक फ़ाइल प्रकार है, जिसे Dataverse में ब्लॉब के रूप में संग्रहीत किया जाता है, जिससे रिपोर्टिंग और शासन नियंत्रण के लिए इसे पार्स करना चुनौतीपूर्ण हो जाता है। V2 में लॉग्स अधिक सुलभ हैं।
एकीकरण के लिए समर्थन Azure Synapse Link for Dataverse	उपलब्ध नहीं	नियोजित	V1 में, AdditionalContext विशेषता एक फ़ाइल प्रकार है, जिसे Dataverse में ब्लॉब के रूप में संग्रहीत किया जाता है, जो सिंक्रनाइज़ेशन के लिए समर्थित नहीं है। Azure Synapse
Dataverse ऑडिटिंग के लिए समर्थन	उपलब्ध नहीं	नियोजित	V1 में, AdditionalContext विशेषता एक फ़ाइल प्रकार है, जिसे Dataverse में ब्लॉब के रूप में संग्रहीत किया जाता है, जो Dataverse ऑडिटिंग में समर्थित नहीं है।
दीर्घावधि प्रतिधारण के लिए समर्थन Dataverse	उपलब्ध नहीं	नियोजित	V1 में, AdditionalContext विशेषता एक फ़ाइल प्रकार है, जिसे Dataverse में ब्लॉब के रूप में संग्रहीत किया जाता है, जो Dataverse दीर्घकालिक अवधारण में समर्थित नहीं है।
Dataverse भूमिका-आधारित अभिगम नियंत्रण (RBAC) पर आधारित	उपलब्ध	उपलब्ध	दोनों संस्करण RBAC का उपयोग करते हैं, तथा अपने मूल प्रवाह सत्र रिकॉर्ड से क्रिया लॉग अनुमतियाँ प्राप्त करते हैं। Dataverse

लॉग्स V2 पिछले संस्करण, V1 की तुलना में महत्वपूर्ण संवर्द्धन प्रदान करता है। V2 इलास्टिक टेबल सुविधा का उपयोग करता है, जो एक्शन लॉग परिदृश्यों जैसे बड़े डेटा वॉल्यूम को संभालने के लिए बहुत अच्छा है, और इसमें अंतर्निहित डेटा प्रतिधारण (TTL) है। यह उन संगठनों के लिए आदर्श है जिन्हें रिपोर्टिंग, प्रशासन और स्वचालित डेटा अवधारण नियंत्रण के साथ एकीकरण के लिए महत्वपूर्ण मात्रा में डेटा तक पहुंच की आवश्यकता होती है।

नोट

फ्लो लॉग तालिका के उन्नत गुणों के अंतर्गत इसके डेटा में ऑडिट परिवर्तन गुण को तब तक अचयनित किया जाना चाहिए जब तक कि लॉग V2 के लिए ऑडिटिंग समर्थित न हो जाए। इस और अन्य उन्नत तालिका सेटिंग्स के बारे में अधिक जानें यहां.

Dataverse लॉग V2 के लिए क्षमता मांग गणना

निम्न तालिका लॉग V2 का उपयोग करते समय प्रति डेस्कटॉप प्रवाह रन नमूना Dataverse डेटाबेस संग्रहण खपत अनुमान दिखाती है। यह विभिन्न कार्यों के लिए अनुमानित भंडारण मांग को रेखांकित करता है, जिसमें प्रति कार्य औसतन 3 KB भंडारण की आवश्यकता मानी गई है।

कार्यों की संख्या	प्रति कार्य संग्रहण मांग (KB)	कुल संग्रहण खपत (एमबी)
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 डेटा क्वेरी करना

डेस्कटॉप प्रवाह क्रिया लॉग डेटा तक पहुंच Dataverse बैकएंड पर API कॉल करके प्राप्त की जा सकती है, या तो पारंपरिक API कॉल सिंटैक्स का उपयोग करके या नई ExecuteCosmosSqlQuery विधि का उपयोग करके। यह विधि आपको Dataverse के विरुद्ध SQL क्वेरी निष्पादित करने की अनुमति देती है, जिससे डेटा की पुनर्प्राप्ति और फ़िल्टरिंग सक्षम होती है।

लॉग V2 का डेटा मॉडल फ्लो सत्र और फ्लो लॉग तालिकाओं के बीच पैरेंट-चाइल्ड संबंध पर आधारित है। प्रत्येक रिकॉर्ड को अपने पैरेंट फ्लो सत्र रिकॉर्ड से अनुमतियाँ विरासत में मिलती हैं। किसी विशिष्ट डेस्कटॉप फ्लो रन के एक्शन लॉग को क्वेरी करने के लिए, आप निम्नलिखित क्वेरी सिंटैक्स का उपयोग कर सकते हैं।

पारंपरिक Dataverse API कॉल सिंटैक्स

निम्नलिखित API कॉल एक विशिष्ट प्रवाह सत्र को उसकी ID (9d51aa1f-315e-43ab-894f-bc445dfb049b) द्वारा पुनर्प्राप्त करता है और फिर flowsession_flowlog_parentobjectid संबंध का उपयोग करके संबद्ध क्रिया लॉग तक पहुँचता है।

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

FlowLogs तालिका का उपयोग करके नया ExecuteCosmosSqlQuery API कॉल सिंटैक्स

    [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  

इलास्टिक टेबल में JSON कॉलम क्वेरी करने के बारे में अधिक जानें.

कॉल को अलग-अलग भागों में तोड़ना

• आधार URL (https://[मेरा संगठन].api.crm[मेरा क्षेत्र].dynamics.com/api/data/v9.2/) Dataverse वेब API के लिए एंडपॉइंट है।
• ExecuteCosmosSqlQuery वह विधि है जिसे बुलाया जा रहा है। यह विधि Dataverse के विरुद्ध SQL क्वेरी के निष्पादन की अनुमति देती है।
• ExecuteCosmosSqlQuery विधि के लिए पैरामीटर विधि नाम के बाद कोष्ठक में दिए गए हैं। ये हैं:
  • QueryText=@p1: निष्पादित की जाने वाली SQL क्वेरी. इस स्थिति में, क्वेरी तालिका से विभिन्न गुणों का चयन करती है, जहां प्रकार 100000001 (डेस्कटॉप प्रवाह क्रिया लॉग प्रकार) है और परिणामों को अवरोही क्रम में startTime गुण द्वारा क्रमबद्ध करता है।
  • EntityLogicalName=@p2: यह तालिका (flowlog) का तार्किक नाम है जो क्रिया लॉग संग्रहीत करता है।
  • PartitionId=@p3: इस पैरामीटर का उपयोग Azure Cosmos DB के भीतर उस विभाजन की पहचान करने के लिए किया जाता है, जहां क्वेरी निष्पादित की जानी है। इसे flowsession_[flowsessionid] पर सेट किया गया है.
  • QueryParameters=@p4: यह क्वेरी के लिए पैरामीटर निर्दिष्ट करने वाला एक JSON ऑब्जेक्ट है। पिछले उदाहरण में, यह कुंजीमान जोड़ी निर्दिष्ट कर रहा है जहाँ कुंजी @referencingParentId है और मान flowsessionid (GUID) है।

ज्ञात सीमाएँ

• लॉग V2 केवल डेस्कटॉप फ्लो रन के लिए उपलब्ध हैं जो डेस्कटॉप फ्लो कनेक्टर क्रिया के माध्यम से क्लाउड फ्लो से लॉन्च किए जाते हैं।
• क्रिया लॉग संस्करण बदलने से पिछले डेस्कटॉप प्रवाह क्रिया लॉग नए लॉग संग्रहण प्रकार में माइग्रेट नहीं होते हैं।
• कैस्केड डिलीट वर्तमान में समर्थित नहीं है. जब आप कोई प्रवाह सत्र रिकॉर्ड हटाते हैं, तो अंतर्निहित लॉग स्वचालित रूप से नहीं हटाए जाते हैं.