Naplófájlok konfigurálása a helyszíni adatátjáróhoz

A helyszíni adatátjáró szolgáltatásnaplóinak három kategóriája van: információ, hiba és hálózat. Ez a kategorizálás hibaelhárítási felületet biztosít, amely lehetővé teszi, hogy egy hiba vagy probléma adott területére összpontosítson.

A naplózási konfigurációk ellenőrzéséhez hajtsa végre a következő lépéseket:

1. Nyissa meg a Microsoft.PowerBI.EnterpriseGateway.exe.config átjárókonfigurációs fájlt, amelynek alapértelmezés szerint a \Program Files\Helyszíni adatátjáró alatt kell lennie.
2. Mielőtt továbbhalad, készítsen másolatot a fájlról, ha később vissza szeretné állítani.
3. Keresse meg az alatta system.diagnosticslévő figyelőtApplicationFileTraceListener.

A következő szakaszok a konfiguráció részleteit megőrzési típusonként adják meg, amely az átjáró verziójától függ.

Koralapú megőrzés

2023 februárjától bevezették az átjárón belüli új, koralapú adatmegőrzési koncepciót. Ez a fogalom az új átjárótelepítések alapértelmezett adatmegőrzési típusa.

Ebben a megőrzési típusban két fő szempontot kell figyelembe venni (sorrendben):

• Az átjárónaplók (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) által felhasznált lemezterület maximális mérete, alapértelmezett értéke 5 GB.
• Megőrzési időszak napokban, alapértelmezett értéke 30 nap.

Ebben az új logikában biztosítjuk, hogy minden új napra új naplófájl legyen kiépítve. Ez a kiépítés biztosítja, hogy az adott napra vonatkozó információk megtalálhatók a naplófájlokban, ahol a fájlnév megegyezik a naplóbejegyzési dátumokkal. Emellett a fájlpartíciót is végrehajtja a rendszer a napon belül, ha eléri a maximális egyéni fájlméretet (alapértelmezés szerint 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>

Ha módosítani szeretné a megőrzés alapértelmezett paramétereinek értékeit, módosítsa őket az initializeData értékben. Az alábbi lista az egyes paramétereket ismerteti:

• Megőrzési időszak napokban (1 és 365 nap közötti érték).
• Maximális teljes méret MB-ban, amelyet a három naplófájltípus használhat fel.
• Maximális méret MB-ban, amelyben az egyes naplófájlok egyenként is lehetnek. Minden alkalommal, amikor eléri a korlátot, egy új fájl jön létre egy szekvenciális számmal hozzáfűzve.

Megjegyzés:

Az átjárónaplók UTC-alapú időbélyegeket használnak, a naplófájlok napi rotációja pedig 00:00 (UTC) időpontban történik.

Fájlszámalapú megőrzés

Ez volt az átjárón belüli alapértelmezett naplómegőrzési logika a 2022. decemberi és korábbi verziókhoz. Ennek a logikának két fő fogalma van:

• Naplótípusonként megőrzendő fájlok száma (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Naplótípusonként használandó lemezterület maximális száma (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

A fájlok a korábban felsorolt feltételeknek megfelelően vannak particionálva, ezért amikor eléri a fájlok maximális számát, az általában a maximális lemezterület közelében vagy közelében lesz.

A Microsoft.PowerBI.EnterpriseGateway.exe.config átjáró konfigurációs fájljának alábbi részlete a három kategóriát tartalmazza: GatewayInfo.log, GatewayErrors.logés 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>

Alapértelmezés szerint az átjáró konfigurációs fájlja a \Program Files\Helyszíni adatátjáró könyvtárban található. A megőrizni kívánt naplófájlok számának beállításához módosítsa a fájl értékének initializeData első számát. Az egyes naplófájlok méretének konfigurálásához módosítsa a második számot.

Az alábbi példa azt határozza meg, hogy 20 naplófájl, az egyes kategóriákban lévő összes fájl összesen legfeljebb 50 MB méretű lesz: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Az új koralapú adatmegőrzési logika alapértelmezés szerint érvényes lesz a meglévő helyszíni adatátjáró telepítésére?

Nem. Ez a megőrzési logika egyelőre teljesen új átjárótelepítésekre lesz alkalmazva. A meglévő átjáróknak a 2023. februári vagy újabb verziókra való frissítéskor meg kell tartaniuk az aktuális naplómegőrzési logikát (fájlszámalapú megőrzés).

Következő lépések

Az átjárónaplók hibaelhárításhoz való exportálásáról a hibaelhárítási eszközök között talál további információt.