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

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

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

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 เมกะไบต์)

  <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 วัน)
• ขนาดรวมสูงสุดในเมกะไบต์ซึ่งสามารถใช้ได้โดยไฟล์บันทึกสามประเภท
• ขนาดสูงสุดในเมกะไบต์ซึ่งแต่ละไฟล์บันทึกสามารถมีได้ทีละไฟล์ แต่ละครั้งถึงขีดจํากัด ไฟล์ใหม่จะถูกสร้างขึ้นด้วยตัวเลขตามลําดับต่อท้าย

หมายเหตุ

บันทึกเกตเวย์ใช้การประทับเวลาตาม UTC และการหมุนไฟล์บันทึกประจําวันจะเกิดขึ้นที่ 00:00 UTC

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

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

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

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

ส่วนที่ตัดมาต่อไปนี้จากแฟ้มการกําหนดค่าเกตเวย์ Microsoft.PowerBI.EnterpriseGateway.exe.config มีสามประเภท: GatewayInfo.logและ GatewayErrors.logGatewayNetwork.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 เมกะไบต์ จะถูกเก็บไว้:GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

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

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

ขั้นตอนถัดไป

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