กําหนดค่าไฟล์บันทึกสําหรับเกตเวย์ข้อมูลภายในองค์กร

เกตเวย์ข้อมูลภายในองค์กรมีบันทึกบริการสามประเภท: ข้อมูล ข้อผิดพลาด และเครือข่าย การจัดประเภทนี้ให้ประสบการณ์การแก้ไขปัญหาที่คุณสามารถเน้นไปยังพื้นที่เฉพาะสําหรับข้อผิดพลาดหรือปัญหาได้

เมื่อต้องการตรวจสอบการกําหนดค่าการบันทึกของคุณ ให้ทําตามขั้นตอนเหล่านี้:

1. เปิดไฟล์ Microsoft.PowerBI.EnterpriseGateway.exe.configการกําหนดค่าเกตเวย์ ตามค่าเริ่มต้น คุณสามารถค้นหาไฟล์นี้ภายใต้\Program Files\On-premises data gateway
2. ทําสําเนาของไฟล์นี้ในกรณีที่คุณต้องการกู้คืนข้อมูลในภายหลัง
3. ค้นหาตัวApplicationFileTraceListenerรอรับการฟัง ซึ่งอยู่ภายใต้system.diagnostics

ส่วนต่อไปนี้แสดงรายละเอียดการกําหนดค่าตามชนิดการเก็บรักษา ซึ่งขึ้นอยู่กับเวอร์ชันเกตเวย์ของคุณ

การเก็บรักษาตามอายุ

เริ่มตั้งแต่เดือนกุมภาพันธ์ 2023 เกตเวย์แนะนําแนวคิดการเก็บรักษาตามอายุใหม่ แนวคิดนี้เป็นชนิดการเก็บข้อมูลเริ่มต้นสําหรับการติดตั้งเกตเวย์ใหม่

สําหรับชนิดการเก็บข้อมูลนี้ ให้พิจารณาสองประเด็นหลัก (ตามลําดับความสําคัญ):

• เนื้อที่ดิสก์สูงสุดสําหรับบันทึกเกตเวย์ (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) โดยใช้ค่าเริ่มต้นคือ 5 GB
• ระยะเวลาการเก็บข้อมูลเป็นวัน โดยใช้ค่าเริ่มต้นของ 30 วัน

ในตรรกะใหม่นี้ เกตเวย์ทําให้แน่ใจว่าสําหรับทุกๆ วันใหม่จะสร้างไฟล์บันทึกใหม่ การเตรียมใช้งานนี้ช่วยให้แน่ใจว่าข้อมูลสําหรับวันที่ระบุจะปรากฏในไฟล์บันทึกที่ชื่อไฟล์ตรงกับวันที่ในรายการบันทึก นอกจากนี้ เกตเวย์จะดําเนินการแบ่งพาร์ติชันไฟล์ภายในวันถ้าถึงขนาดไฟล์แต่ละไฟล์สูงสุด (ค่าเริ่มต้นของ 100 MB)

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener" type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.AgeBasedRetentionRotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common" initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,30,5120,100" />
      </listeners>
    </trace>
  </system.diagnostics>

หากต้องการเปลี่ยนค่าพารามิเตอร์ค่าเริ่มต้นการเก็บข้อมูล ให้ปรับ initializeData ค่า รายการต่อไปนี้อธิบายแต่ละพารามิเตอร์:

• ระยะเวลาการเก็บรักษาเป็นวัน (ค่าระหว่าง 1 ถึง 365 วัน)
• ขนาดรวมสูงสุดในหน่วย MB ที่แฟ้มบันทึกสามชนิดสามารถใช้ได้
• ขนาดสูงสุดเป็นเมกะไบต์ที่แต่ละไฟล์บันทึกสามารถมีได้ทีละไฟล์ ในแต่ละครั้งถึงขีดจํากัด เกตเวย์จะสร้างไฟล์ใหม่ด้วยหมายเลขลําดับต่อท้าย

การเก็บข้อมูลตามจํานวนไฟล์

ลักษณะนี้เป็นตรรกะการเก็บรักษาข้อมูลบันทึกค่าเริ่มต้นภายในเกตเวย์สําหรับเวอร์ชันเดือนธันวาคม 2022 และเวอร์ชันก่อนหน้า ตรรกะนี้มีแนวคิดหลักสองข้อ:

• จํานวนไฟล์ที่จะเก็บรักษาต่อชนิดของแฟ้มบันทึก (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log)
• เนื้อที่ดิสก์สูงสุดที่จะใช้ต่อชนิดของบันทึก (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log)

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

ข้อความที่ตัดตอนมาจากไฟล์การกําหนดค่าเกตเวย์ Microsoft.PowerBI.EnterpriseGateway.exe.config ประกอบด้วยสามประเภท: GatewayInfo.log, GatewayErrors.log และ GatewayNetwork.log

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener"
             type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.RotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common"
             initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50" />
      </listeners>
    </trace>
  </system.diagnostics>

ตามค่าเริ่มต้น ไฟล์การกําหนดค่าเกตเวย์จะอยู่ในไดเรกทอรี \Program Files\On-premises data gateway เมื่อต้องการตั้งค่าจํานวนไฟล์บันทึกที่จะเก็บรักษาไว้ ให้เปลี่ยนตัวเลขแรกในค่าของ initializeData ไฟล์ ในการกําหนดค่าขนาดของไฟล์บันทึกแต่ละไฟล์ ให้เปลี่ยนตัวเลขที่สอง

ตัวอย่างต่อไปนี้ระบุว่า แฟ้มบันทึก 20 แฟ้มถูกเก็บรักษาไว้ และผลรวมของแฟ้มทั้งหมดในแต่ละประเภทมีขนาดไม่เกิน 50 MB: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

ตรรกะการเก็บข้อมูลตามอายุใหม่นําไปใช้ตามค่าเริ่มต้นกับการติดตั้งเกตเวย์ข้อมูลภายในองค์กรที่มีอยู่ของฉันหรือไม่

ไม่ ตรรกะการเก็บข้อมูลนี้นําไปใช้กับการติดตั้งเกตเวย์ใหม่เท่านั้นในขณะนี้ เกตเวย์ที่มีอยู่ที่อัปเกรดเป็นเดือนกุมภาพันธ์ 2023 หรือเวอร์ชันที่ใหม่กว่าจะเก็บตรรกะการเก็บรักษาไฟล์ปัจจุบันไว้ (การเก็บข้อมูลตามจํานวนไฟล์)

ความยินยอมของผู้ดูแลระบบสําหรับการวินิจฉัยเกตเวย์ (พรีวิว)

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

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

วิธีการทำงาน

ผู้ดูแลระบบเกตเวย์สามารถเปิดใช้งานการวินิจฉัยเกตเวย์ในการตั้งค่าเกตเวย์ เมื่อคุณเปิดใช้งานการตั้งค่านี้ เกตเวย์จะเริ่มรวบรวม และส่งข้อมูลการวินิจฉัยไปยังระบบคลาวด์

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

หากความยินยอมระดับผู้เช่าถูกเพิกถอน เกตเวย์ทั้งหมดจะหยุดส่งข้อมูลการวินิจฉัยทันที และการถ่ายโอนข้อมูลที่กําลังดําเนินอยู่จะถูกยกเลิก

สําหรับการบังคับใช้ทันที การรีสตาร์ทเกตเวย์ข้อมูลภายในองค์กรจะยุติการอัปโหลดการวินิจฉัยที่กําลังดําเนินอยู่

บริการจัดเก็บข้อมูลการวินิจฉัยเกตเวย์เป็นเวลา 24 ชั่วโมงใน Azure Data Lake Storage ที่จัดการโดยบริการ หลังจาก 24 ชั่วโมง ข้อมูลจะไม่พร้อมใช้งานสําหรับการดาวน์โหลดอีกต่อไป

พฤติกรรมการอัปโหลด

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

การอัปโหลดแต่ละครั้งคือคําขอ HTTPS ขาออกสั้นๆ จากเครื่องเกตเวย์ หลังจากอัปโหลดไฟล์การวินิจฉัยเสร็จเรียบร้อยแล้ว เกตเวย์จะลบสําเนาการกําหนดระยะภายในเครื่องทันที

ข้อกำหนดของเครือข่าย

เพิ่มแถวต่อไปนี้ลงในตารางข้อกําหนดเครือข่าย:

บัญชีเก็บข้อมูลที่ใช้สําหรับการอัปโหลดการวินิจฉัยได้รับการจัดการ Microsoft และสามารถแตกต่างกันไปตามภูมิภาค เนื่องจากชื่อบัญชีผู้ใช้จะขึ้นอยู่กับภูมิภาค ดังนั้นจึงอนุญาตให้มีการรับส่งข้อมูล HTTPS ขาออกไปยัง *.dfs.core.windows.net หรือใช้แท็กบริการ Azure Storage

ถ้าสภาพแวดล้อมของคุณใช้พร็อกซีตรวจสอบ TLS ตรวจสอบให้แน่ใจว่าพร็อกซีเก็บรักษา URL คําขอแบบเต็ม รวมถึงสตริงคิวรี SAS โทเค็น SAS จําเป็นสําหรับเกตเวย์เพื่ออัปโหลดไฟล์การวินิจฉัย

เปิดใช้งานการวินิจฉัยเกตเวย์

คุณสามารถเปิดใช้งานการวินิจฉัยเกตเวย์ได้เฉพาะในระบบคลาวด์จาก จัดการการเชื่อมต่อและเกตเวย์ ใน บริการของ Power BI หรือ Microsoft Fabric เท่านั้น แอปพลิเคชันเกตเวย์ข้อมูลภายในองค์กรไม่มีการตั้งค่าเพื่อเปิดใช้งานคุณลักษณะนี้

ก่อนที่จะเปิดใช้งานการวินิจฉัยเกตเวย์ ให้ตรวจสอบข้อกําหนดเบื้องต้นต่อไปนี้:

• เกตเวย์ทํางานในโหมดมาตรฐาน ไม่รองรับเกตเวย์โหมดส่วนบุคคล
• เปิดใช้งานการติดตาม ETW บนเกตเวย์แล้ว
• สําหรับคลัสเตอร์เกตเวย์ สมาชิกคลัสเตอร์แต่ละคนอัปโหลดการวินิจฉัยอิสระ ตรวจสอบให้แน่ใจว่ามีการกําหนดค่าไฟร์วอลล์ขาออกและกฎพร็อกซีสําหรับทุกโหนดเกตเวย์ในคลัสเตอร์

พื้นที่ดิสก์และฟุตพริ้นท์ของพื้นที่เก็บข้อมูล

ข้อมูลการจัดเตรียมการวินิจฉัยเกตเวย์ถูกเขียนภายใต้เส้นทาง LOCALAPPDATA ของบัญชีบริการเกตเวย์ ไม่ใช่ไดเรกทอรีการติดตั้งเกตเวย์ โฟลเดอร์ย่อย MSessions ประกอบด้วยไฟล์สเตจจิ้งภายในเครื่องที่ใช้สําหรับการอัปโหลดการวินิจฉัย

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

ฟุตปริ้นท์ที่เก็บข้อมูลนี้แยกจากกันและบวกเพิ่มงบประมาณการเก็บรักษาบันทึกภายในเครื่อง 5 GB ที่ระบุไว้สําหรับบันทึกเกตเวย์ เป็นจุดเริ่มต้น วางแผนประมาณ 5 ถึง 10 GB ของห้องใหญ่ของดิสก์ฟรีบนเครื่องเกตเวย์แต่ละเครื่อง จากนั้นตรวจสอบการใช้งานจริงในสภาพแวดล้อมของคุณและปรับตามความจําเป็น

ท่าทางด้านความปลอดภัยของการอัปโหลดการวินิจฉัย

การอัปโหลดการวินิจฉัยเกตเวย์ใช้โทเค็น SAS แบบสั้นและกําหนดขอบเขตไดเรกทอรีผ่าน HTTPS โทเค็น SAS จะใช้ได้ในช่วงเวลาที่จํากัด ในขณะนี้ถึงเก้าชั่วโมง และให้สิทธิ์การเขียนเท่านั้น เช่น เพิ่ม เขียน และสร้าง

เกตเวย์สามารถอัปโหลดไฟล์การวินิจฉัย แต่ไม่สามารถอ่านย้อนกลับ ทํารายการ หรือระบุข้อมูลการวินิจฉัยที่อัปโหลดได้

คําถามที่ถามบ่อยเกี่ยวกับการวินิจฉัยเกตเวย์สําหรับเกตเวย์ข้อมูลภายในองค์กรใน Fabric

การตั้งค่าการวินิจฉัยเกตเวย์ข้อมูลภายในองค์กรช่วยรวบรวมบันทึกการวินิจฉัยโดยละเอียดสําหรับการแก้ไขปัญหา Fabric การดําเนินการรีเฟรชกระแสข้อมูล Gen2 ส่วนนี้ตอบคําถามทั่วไปเกี่ยวกับตําแหน่งที่เก็บบันทึกที่อัปโหลด ข้อมูลใดบ้างที่ถูกเก็บรวบรวม ใครสามารถเข้าถึงบันทึก และที่เก็บข้อมูลมีค่าใช้จ่ายเพิ่มเติมหรือไม่

จําเป็นต้องมีการบันทึกเพิ่มเติมสําหรับการวินิจฉัยเกตเวย์หรือไม่

การวินิจฉัยเกตเวย์และการบันทึกเพิ่มเติมเป็นคุณลักษณะที่แยกต่างหาก บันทึกเพิ่มเติมไม่จําเป็นสําหรับการอัปโหลดการวินิจฉัย

สองคุณลักษณะที่เขียนไปยังปลายทางที่แตกต่างกัน: การบันทึกเพิ่มเติมเขียนบันทึกภายในเครื่องอย่างละเอียดมากขึ้น ในขณะที่ขั้นตอนการวินิจฉัยเกตเวย์ข้อมูลการวินิจฉัยภายในเครื่องและอัปโหลดไปยังที่เก็บข้อมูล Microsoft จัดการหลังจากการยินยอมของผู้เช่าและการเปิดใช้งานระดับเกตเวย์

ความสัมพันธ์ระหว่างเกตเวย์ข้อมูลภายในองค์กรการตั้งค่าการวินิจฉัยและกระแสข้อมูลคืออะไร

ในขณะนี้ การตั้งค่าการวินิจฉัยเกตเวย์ข้อมูลภายในองค์กรใช้ได้กับ Fabric Dataflow Gen2 เท่านั้น เมื่อเรียกใช้การรีเฟรชกระแสข้อมูล Gen2:

• เกตเวย์รวบรวมข้อมูลการวินิจฉัยที่จําเป็นสําหรับการแก้ไขปัญหา
• ระบบอัปโหลดบันทึก Mashup ที่เกี่ยวข้องไปยังที่เก็บข้อมูล Microsoft จัดการ
• บันทึกที่เกี่ยวข้องกับการดําเนินการรีเฟรช
• ผู้ใช้สามารถดาวน์โหลดการวินิจฉัยโดยละเอียดจากประวัติการรีเฟรช Dataflow Gen2 ได้

ความสามารถนี้อาจสนับสนุนสถานการณ์การวินิจฉัยในอนาคต

บันทึกอะไรบ้างที่รวบรวมและอัปโหลด

ในปัจจุบัน การตั้งค่าการวินิจฉัยเกตเวย์ข้อมูลภายในองค์กรส่วนใหญ่อัปโหลดบันทึกกลไกจัดการ Mashup ที่เชื่อมโยงกับการดําเนินการรีเฟรช Fabric Dataflow Gen2

ตัวอย่างของข้อมูลที่รวบรวมได้แก่:

• รายละเอียดการดําเนินการรีเฟรชกระแสข้อมูล Gen2

• การวินิจฉัยกลไกจัดการ Mashup

• การประมวลผลคิวรีและการติดตามการดําเนินการ

บันทึกที่อัปโหลดถูกจัดเก็บไว้ที่ไหน

ภูมิภาค Power BI หรือ Fabric การลงทะเบียนของผู้เช่าจะกําหนดตําแหน่งที่เก็บข้อมูล พื้นที่เก็บข้อมูล Microsoft จัดการในภูมิภาคผู้เช่าที่เกี่ยวข้องจะจัดเก็บบันทึกที่อัปโหลด

ภูมิภาค Azure ใดที่รองรับฟีเจอร์นี้?

ภูมิภาคที่รองรับ Fabric ทั้งหมดที่ให้บริการโครงสร้างพื้นฐานของหน่วยเก็บข้อมูลที่มีการจัดการ รองรับการตั้งค่าการวินิจฉัยเกตเวย์ข้อมูลภายในองค์กร คุณลักษณะนี้ไม่พร้อมใช้งานในภูมิภาคกาตาร์

ข้อมูลที่อัปโหลดมีข้อมูลที่ละเอียดอ่อนหรือไม่

ใช่ การวินิจฉัยที่อัปโหลดอาจประกอบด้วยข้อมูลที่ลูกค้าพิจารณาว่าละเอียดอ่อน คุณลักษณะนี้ถูกปิดใช้งานตามค่าเริ่มต้น ตรวจสอบนโยบายการจัดการข้อมูลและการสนับสนุนขององค์กรของคุณก่อนที่จะเลือกใช้การตั้งค่าการวินิจฉัยเกตเวย์ข้อมูลภายในองค์กร

บันทึกจะถูกจัดเก็บไว้นานเท่าใด

ระบบจะเก็บข้อมูลการวินิจฉัยเป็นเวลา 24 ชั่วโมง คุณสามารถดาวน์โหลดข้อมูลจาก Fabric Dataflow Gen2 ทํางานในช่วงเวลา 24 ชั่วโมงนี้

ใครสามารถเข้าถึงไฟล์บันทึกที่อัปโหลดได้บ้าง

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

มีค่าใช้จ่ายเพิ่มเติมสําหรับการจัดเก็บบันทึกเหล่านี้หรือไม่

ไม่ ณ วันนี้ การตั้งค่าการวินิจฉัยเกตเวย์ข้อมูลภายในองค์กรไม่มีค่าใช้จ่ายเพิ่มเติม

การแก้ไขปัญหา

การวินิจฉัยถูกเปิดใช้งาน แต่ไม่มีแฟ้มบันทึกปรากฏขึ้น

ถ้ามีการเปิดใช้งานการวินิจฉัย แต่บันทึกการวินิจฉัยไม่ปรากฏขึ้น ให้ตรวจสอบรายการต่อไปนี้:

1. ยืนยันการเข้าถึง HTTPS ขาออกบนพอร์ต 443 เป็น *.dfs.core.windows.net

2. ยืนยันว่าเกตเวย์ทํางานในโหมดมาตรฐาน ไม่รองรับเกตเวย์โหมดส่วนบุคคล

3. ยืนยันการยินยอมของผู้เช่าสําหรับการวินิจฉัยเกตเวย์ที่ไม่ได้ถูกเพิกถอน

4. ตรวจสอบ GatewayInfo*.log สําหรับบรรทัดการติดตาม DiagnosticsUploader และ DiagnosticsStorageClient ข้อความติดตามที่มีประโยชน์รวมถึง: พบไฟล์ที่สามารถอัปโหลดได้ N ไฟล์, การรับรองความถูกต้องล้มเหลวสูงสุดถึงจํานวนความล้มเหลวสูงสุด

5. ถ้าเกิดความล้มเหลวในการอัปโหลดติดต่อกันสามรายการ คอลเลกชันการวินิจฉัยจะหยุดจนกว่าจะมีการต่ออายุการเข้าถึง ลักษณะการทํางานนี้อาจทําให้การวินิจฉัยดูเหมือนถูกปิดโดยไม่คาดคิด แม้ว่าสาเหตุที่แท้จริงจะไม่สามารถอัปโหลดซ้ําได้

เนื้อหาที่เกี่ยวข้อง

สําหรับข้อมูลเกี่ยวกับวิธีการส่งออกบันทึกเกตเวย์สําหรับการแก้ไขปัญหา ดูเครื่องมือการแก้ไขปัญหา