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 konfiguraatiotiedosto Microsoft.PowerBI.EnterpriseGateway.exe.config, joka oletuksena tulisi sijaita \Program Files\On-premises data gateway -alta.
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 mahdollinen kokonaiskoko Mt:nä, jota kolme lokitiedostotyyppiä voi käyttää.
• Kunkin lokitiedoston enimmäiskoko Mt:nä, joka kullakin lokitiedostolla voi olla yksitellen. Aina kun raja saavutetaan, luodaan uusi tiedosto, jonka loppuun liitetään peräkkäinen numero.

Tiedostomäärään perustuva säilytys

Tämä tyyli oli yhdyskäytävän oletuslokin säilytyslogiikka joulukuun 2022 ja aiempien versioiden osalta. Tällä logiikalla on kaksi pääkäsitteistä:

• Lokityypin mukaan säilytettävien tiedostojen määrä (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Lokityyppiä kohden käytettävä levytilan enimmäismäärä (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

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

Seuraava ote yhdyskäytävän konfiguraatiotiedostosta Microsoft.PowerBI.EnterpriseGateway.exe.config sisältää kolme kategoriaa: GatewayInfo.log, GatewayErrors.log ja 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ä 20 lokitiedostoa, joiden koko on enintään 50 Mt kunkin luokan kaikkien tiedostojen kokonaismäärä, säilytetään: 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).

Ylläpitäjän suostumus gateway-diagnostiikkaan (esikatselu)

Ylläpitäjän suostumus yhdyskäytävän diagnostiikkaan on ominaisuus, jonka avulla ylläpitäjät voivat nimenomaisesti hallita, kerätäänkö ja lähetetäänkö diagnostiikkatietoja paikallisista dataporteista pilveen.

Tämä ominaisuus esittelee suostumuspohjaisen mallin, joka varmistaa, että mahdollisesti arkaluonteiset tiedot—kuten Mashup-lokit—lähetetään vasta hallinnollisen hyväksynnän jälkeen. Se mahdollistaa myös tulevat seuranta- ja diagnostiikkamahdollisuudet.

Kun käytössä:

• Diagnostiset tiedot voidaan kerätä ja käsitellä turvallisesti
• Fabric-työtila liittyy porttiin
• Työtila on varattu tuleville seuranta- ja diagnostiikkakokemuksille

Näin se toimii

Gateway-ylläpitäjät mahdollistavat diagnostiikan gateway-asetuksissa ja yhdistävät työtilan. Vuokralaishallinnonpitäjät voivat peruuttaa suostumuksen milloin tahansa, mikä estää kaikkia vuokralaisen gatewayjä osallistumasta diagnostiikkaan

Diagnostiikkatiedon kulku on tiukasti valvottu:

• Ei suostumusta → ei tiedonsiirtoa

• Suostumus peruutetaan → pääsy on lopetettu

  

  

  

Välittömän valvonnan vuoksi paikallisen datayhdyskäytävän uudelleenkäynnistys lopettaa kaikki käynnissä olevat diagnostiikkalataukset.

Liittyvä sisältö

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