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

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

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

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 หรือเวอร์ชันที่ใหม่กว่าควรเก็บตรรกะการเก็บรักษาไฟล์ปัจจุบัน (นับจํานวนไฟล์ตามการเก็บรักษา)

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

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