Paikallisen tietoyhdyskäytävän lokitiedostojen määrittäminen

Paikalliselle tietoyhdyskäytävälle on kolme palvelulokiluokkaa: tiedot, virheet ja verkko. Tämä luokitus tarjoaa vianmäärityskokemuksen, jonka avulla voit keskittyä virheen tai ongelman tiettyyn alueeseen.

Voit tarkistaa lokikirjauksen määritykset seuraavasti:

1. Avaa yhdyskäytävän määritystiedosto Microsoft.PowerBI.EnterpriseGateway.exe.config, jonka tulee oletusarvoisesti sijaita kohdassa \Program Files\On-premises data gateway.
2. Ennen kuin jatkat eteenpäin, kopioi tämä tiedosto siltä varalta, että sinun on palautettava se myöhemmin.
3. Etsi kuuntelutoiminto ApplicationFileTraceListener , joka on alla system.diagnostics.

Seuraavissa osissa on määritystiedot säilytystyyppiä kohden, ja ne riippuvat yhdyskäytäväversiostasi.

Ikäpohjainen säilytys

Helmikuussa 2023 otettiin käyttöön uusi ikäpohjainen säilytyskonsepti yhdyskäytävässä. Tämä on uusien yhdyskäytäväasennuksia varten oletuksena säilytystyyppi.

Tämän säilytystyypin osalta on otettava huomioon kaksi keskeistä näkökohtaa (käsittelyjärjestyksessä):

• Yhdyskäytävälokien (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log) käyttämä levytilan enimmäismäärä, oletusarvo on 5 Gt.
• Säilytysaika päivinä, oletusarvo on 30 päivää.

Tässä uudessa logiikassa varmistamme, että jokaista uutta päivää varten valmistellaan uusi lokitiedosto. Tämä valmistelu varmistaa, että tietyn päivän tiedot ovat lokitiedostoissa, joissa tiedostonimi vastaa lokin merkintäpäivämäärää. Myös päivän tiedosto-osio suoritetaan, jos yksittäisen tiedoston enimmäiskoko (oletusarvo on 100 Mt) saavutetaan.

  <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>

Jos haluat muuttaa säilytysasetusten oletusparametriarvoja, säädä niitä arvossa initializeData . Seuraavassa luettelossa kuvataan jokainen parametri:

• Säilytysaika päivinä (arvo välillä 1–365 päivää).
• Suurin kokonaiskoko Mt, joita kolme lokitiedostotyyppiä voi käyttää.
• Kunkin lokitiedoston enimmäiskoko Mt, joka kullakin lokitiedostolla voi olla yksitellen. Aina kun raja saavutetaan, luodaan uusi tiedosto, jonka loppuun liitetään peräkkäinen numero.

Muistiinpano

Yhdyskäytävälokeissa käytetään UTC-pohjaisia aikaleimaa ja lokitiedostojen päivittäinen kierto tapahtuu klo 00.00 UTC.

Tiedostomäärään perustuva säilytys

Tämä oli yhdyskäytävän oletuslokin säilytyslogiikka joulukuun 2022 versioissa ja sitä uudemmissa versioissa. Tällä logiikalla on kaksi pääkäsitteistä:

• Lokityypin mukaan säilytettävien tiedostojen määrä (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Enimmäislevytila lokityyppiä kohti (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Tiedostot ositetaan vastaavasti aiemmin luetelluilla ehdoilla, joten aina, kun saavutat tiedostojen enimmäismäärän, se on yleensä myös levytilan enimmäismäärä tai lähellä sitä.

Seuraava katkelma yhdyskäytävän määritystiedostosta Microsoft.PowerBI.EnterpriseGateway.exe.config sisältää kolme luokkaa: GatewayInfo.log, GatewayErrors.logja 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>

Yhdyskäytävän määritystiedosto sijaitsee oletusarvoisesti hakemistossa \Program Files\On-premises data gateway. Voit määrittää säilytettyjen lokitiedostojen määrän muuttamalla tiedoston initializeData arvon ensimmäistä numeroa. Voit määrittää jokaisen lokitiedoston koon muuttamalla toista lukua.

Seuraavassa esimerkissä määritetään, että säilytetään 20 lokitiedostoa, joiden kokonaismäärä on kussakin luokassa enintään 50 Mt:GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

Sovelletaanko uutta ikäperusteista säilytyslogiikkaa oletusarvoisesti aiemmin luotuun paikallisen tietoyhdyskäytävän asennukseen?

Ei. Tätä tämän ajan säilytyslogiikkaa käytetään täysin uusissa yhdyskäytäväasennuksissa. Nykyisen yhdyskäytävän, kun päivität helmikuun 2023 tai uudemman version, tulisi säilyttää nykyinen lokin säilytyslogiikka (tiedostojen määrä-pohjainen säilytys).

Seuraavat vaiheet

Lisätietoja siitä, miten voit viedä yhdyskäytävälokit vianmääritystä varten, on kohdassa Vianmääritystyökalut.