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

Paikallisessa tietoyhdyskäytävässä on kolme palvelulokien luokkaa: tiedot, virheet ja verkko. Tämä luokittelu tarjoaa vianmäärityskokemuksen, jossa voit keskittyä virheen tai ongelman tietylle alueelle.

Jos haluat tarkistaa lokimääritykset, toimi seuraavasti:

1. Avaa yhdyskäytävän määritystiedosto Microsoft.PowerBI.EnterpriseGateway.exe.config. Löydät tämän tiedoston oletusarvoisesti kohdasta \Program Files\On-premises data gateway.
2. Luo kopio tästä tiedostosta 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

Helmikuusta 2023 alkaen yhdyskäytävä esittelee uuden ikäpohjaisen säilytyskäsitteen. Tämä on uusien yhdyskäytäväasennuksia varten oletuksena säilytystyyppi.

Tarkastele tämän säilytystyypin osalta kahta keskeistä näkökohtaa (käsittelyjärjestyksessä):

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

Tässä uudessa logiikassa yhdyskäytävä varmistaa, että se luo uuden lokitiedoston jokaista uutta päivää varten. Tämä valmistelu varmistaa, että tietyn päivän tiedot ovat lokitiedostoissa, joissa tiedostonimi vastaa lokin merkintäpäivämäärää. Lisäksi yhdyskäytävä suorittaa tiedoston osioinnin päivän aikana, jos suurin yksittäinen tiedoston koko (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äilytysten oletusparametriarvoja, säädä initializeData arvoa. Seuraavassa luettelossa kuvataan jokainen parametri:

• Säilytysaika päivinä (arvo välillä 1–365 päivää).
• Enimmäiskoko Mt:nä, jota kolme lokitiedostotyyppiä voivat käyttää.
• Kunkin lokitiedoston enimmäiskoko Mt:nä, joka kullakin lokitiedostolla voi olla yksitellen. Aina kun raja saavutetaan, yhdyskäytävä luo uuden tiedoston, 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).
• Levytilan enimmäismäärä lokityyppiä kohti (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

Tiedostot ositetaan näiden ehtojen mukaisesti. Näin ollen aina, kun saavutat tiedostojen enimmäismäärän, saavutat yleensä levytilan enimmäismäärän.

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ä säilytetään 20 lokitiedostoa ja jokaisen luokan kaikkien tiedostojen kokonaismäärä on kooltaan 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ämä säilytyslogiikka koskee tällä hetkellä vain uusia yhdyskäytäväasennuksia. Olemassa olevat yhdyskäytävät, jotka päivittävät helmikuun 2023 tai uudempaan versioon, säilyttävät nykyisen lokin säilytyslogiikan (tiedostojen määrä-pohjainen säilytys).

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

Järjestelmänvalvojan suostumus yhdyskäytävän diagnostiikkaan on ominaisuus, jota järjestelmänvalvojat käyttävät hallitakseen sitä, kerätäänkö ja lähetetäänkö paikallisten tietoyhdyskäytäviä koskevat diagnostiikkatiedot pilveen.

Yhdyskäytävän diagnostiikkaominaisuus esittelee suostumuspohjaisen mallin sen varmistamiseksi, että mahdollisesti arkaluonteiset tiedot, kuten koostelokit, toimitetaan vasta järjestelmänvalvojan hyväksynnän jälkeen. Se mahdollistaa myös tulevat seuranta- ja diagnostiikkamahdollisuudet. Tällä hetkellä tämä ominaisuus koskee vain Dataflows Gen2 -artefakteja. Lisätietoja on kohdassa Yksityiskohtaisten päivityslokien lataaminen.

Näin se toimii

Yhdyskäytävän järjestelmänvalvojat voivat ottaa yhdyskäytävän diagnostiikan käyttöön yhdyskäytävän asetuksissa. Kun otat tämän asetuksen käyttöön, yhdyskäytävä alkaa kerätä ja lähettää diagnostiikkatietoja pilveen.

Vuokraajan järjestelmänvalvojat tarjoavat lisähallintokerroksen valvomalla koko organisaation kattavaa diagnostiikkasuostumusta. Yhdyskäytävän järjestelmänvalvojat voivat oletusarvoisesti ottaa diagnostiikan käyttöön ilman vuokraajatason hyväksyntää. Kuitenkin vuokralaisten ylläpitäjät voivat peruuttaa suostumuksen milloin tahansa lopettaakseen diagnostiikkatietojen keruun kaikissa organisaation porteissa.

Jos vuokralaistason suostumus peruutetaan, kaikki yhdyskäytävät lopettavat välittömästi diagnostisten tietojen lähettämisen, ja kaikki jatkuva tiedonsiirto lopetetaan.

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

Palvelu tallentaa yhdyskäytävän diagnostiikkatiedot 24 tunnin ajan palvelun hallitsemaan Azure Data Lake Storage. 24 tunnin kuluttua tiedot eivät ole enää ladattavissa.

Palvelimeen lataamisen toiminta

Kun otat yhdyskäytävän diagnostiikan käyttöön, yhdyskäytävä lataa diagnostiikkatiedostot säännöllisinä erinä. Lataukset eivät ole jatkuvaa suoratoistoa eivätkä ole reaaliaikaisia. Yhdyskäytävä tarkistaa ladattavat diagnostiikkatiedostot noin 60 sekunnin välein, joten jäljityksen luonnin ja käytettävyyden välillä on yleensä noin 1–2 minuutin viive Microsoft hallitsemassa tallennustilassa.

Jokainen lataus on lyhytikäinen lähtevä HTTPS-pyyntö yhdyskäytäväkoneesta. Kun diagnostiikkatiedosto on ladattu, yhdyskäytävä poistaa paikallisen valmistelukopion välittömästi.

Verkon vaatimukset

Lisää seuraava rivi verkkovaatimukset-taulukkoon:

Diagnostiikan palvelimeen lataamiseen käytettävä tallennustili on Microsoft hallittu, ja se voi vaihdella alueittain. Koska tilin nimi on aluekohtainen, salli lähtevä HTTPS-liikenne *.dfs.core.windows.net tai käytä Azure-tallennus -palvelutunnistetta.

Jos ympäristösi käyttää TLS-tarkistusvälityspalvelinta, varmista, että välityspalvelin säilyttää pyynnön koko URL-osoitteen, mukaan lukien SAS-kyselymerkkijonon. SAS-tunnus vaaditaan, jotta yhdyskäytävä voi ladata diagnostiikkatiedostoja.

Ota yhdyskäytävän diagnostiikka käyttöön

Voit ottaa yhdyskäytävän diagnostiikan käyttöön vain pilvipalvelussa Power BI -palvelu tai Microsoft Fabric kohdasta Yhteyksien ja yhdyskäytäviä. Paikallisen tietoyhdyskäytävän sovelluksella ei ole asetusta tämän ominaisuuden käyttöönottamiseksi.

Ennen kuin otat yhdyskäytävän diagnostiikan käyttöön, tarkista seuraavat edellytykset:

• Yhdyskäytävä suoritetaan vakiotilassa. Henkilökohtaisen tilan yhdyskäytäviä ei tueta.
• ETW-jäljitys on käytössä yhdyskäytävässä.
• Yhdyskäytäväklustereissa jokainen klusterin jäsen lataa diagnostiikan erikseen. Varmista, että lähtevän palomuurin ja välityspalvelimen säännöt on määritetty klusterin jokaiselle yhdyskäytäväsolmulle.

Levytilan ja tallennustilan jälki

Yhdyskäytävän diagnostiikan valmistelutiedot kirjoitetaan yhdyskäytävän palvelutilin LOCALAPPDATA-polkuun, ei yhdyskäytävän asennushakemistoon. MSessions-alikansio sisältää paikalliset valmistelutiedostot, joita käytetään diagnostiikan lataamisessa.

Vakaassa tilassa paikallinen säilytys on yleensä noin 1–2 minuuttia, koska tiedostot poistetaan heti onnistuneen latauksen jälkeen. Paikalliset valmistelutiedot voivat säilyä noin tunnin ajan virhe- tai uudelleenyritysten tilanteessa.

Tämä tallennustilan jalanjälki on eri kuin 5 Gigatavun paikallisen lokin säilytysbudjetti, joka on dokumentoitu yhdyskäytävälokeille. Aloita suunnittelemalla noin 5–10 Gt vapaata levytilan lisäkäyttöä kussakin yhdyskäytäväkoneessa, valvo sitten todellista käyttöä ympäristössäsi ja säädä tarvittaessa.

Diagnostiikan latauksen suojausasennos

Yhdyskäytävän diagnostiikan palvelimeen lataaminen käyttää lyhytikäistä hakemistopohjaista SAS-tunnusta HTTPS:n kautta. SAS-tunnus on voimassa rajoitetun ajan, tällä hetkellä enintään yhdeksän tuntia, ja myöntää vain kirjoitusoikeudet, kuten Lisää, Kirjoita ja Luo.

Yhdyskäytävä voi ladata diagnostiikkatiedostoja palvelimeen, mutta se ei voi lukea uudelleen, luetella tai luetteloida ladattuja diagnostiikkatietoja.

Usein kysyttyjä kysymyksiä paikallisten tietoyhdyskäytäville tarkoitettuun yhdyskäytävädiagnostiikkaan Fabric

Paikallisten tietoyhdyskäytävien diagnostiikka-asetusten avulla voit kerätä yksityiskohtaisia diagnostiikkalokeja tietovuon Gen2 Fabric päivitystoimintojen vianmääritystä varten. Tässä osiossa vastataan yleisiin kysymyksiin siitä, minne ladatut lokit tallennetaan, mitä tietoja kerätään, ketkä voivat käyttää lokeja ja onko tallennustilasta lisäkustannuksia.

Edellyttääkö yhdyskäytävän diagnostiikka lisäkirjausta?

Yhdyskäytävän diagnostiikka ja lisäkirjaaminen ovat erillisiä ominaisuuksia. Diagnostiikan lataaminen ei vaadi lisäkirjausta.

Nämä kaksi ominaisuutta kirjoittavat eri kohteisiin: Lisäkirjaaminen kirjoittaa yksityiskohtaisempia paikallisia lokeja, kun taas yhdyskäytävän diagnostiikkavaiheistaa diagnostiikkatiedot paikallisesti ja lataa ne Microsoft hallittuun tallennustilaan vuokraajan suostumuksen ja yhdyskäytävätason käyttöönoton jälkeen.

Mikä on paikallisten tietoyhdyskäytäviä koskevat diagnostiikka-asetukset ja tietovuot?

Paikallisen tietoyhdyskäytävän diagnostiikka-asetukset koskevat tällä hetkellä vain Fabric Dataflow Gen2-versiota. Kun tietovuon Gen2-päivitys suoritetaan:

• Yhdyskäytävä kerää vianmääritystä varten tarvittavat diagnostiikkatiedot.
• Järjestelmä lataa tarvittavat koostelokit Microsoft hallittuun tallennustilaan.
• Lokit liittyvät päivityksen suorittamiseen.
• Käyttäjät voivat ladata yksityiskohtaisen diagnostiikan Tietovuon Gen2 -päivityshistoriasta.

Tämä ominaisuus voi tukea myös tulevia diagnostiikkaskenaarioita.

Mitä lokeja kerätään ja ladataan?

Tällä hetkellä paikalliset tietoyhdyskäytävän diagnostiikka-asetukset lataavat ensisijaisesti Mashup Engine -lokit, jotka liittyvät Fabric Dataflow Gen2 -päivitystoimintoihin.

Esimerkkejä kerätyistä tiedoista ovat seuraavat:

• Tietovuon Gen2 päivityksen suoritustiedot.

• Koostemoduulin diagnostiikka.

• Kyselyn käsittelyn ja suoritusten jäljitykset.

Mihin ladatut lokit tallennetaan?

Tallennussijainti määräytyy vuokraajan Power BI- tai Fabric -rekisteröintialueen mukaan. Microsoft hallittu tallennustila kyseisellä vuokraaja-alueella tallentaa ladatut lokit.

Mitkä Azure alueet tukevat tätä ominaisuutta?

Kaikki Fabric tukemat alueet, jotka tarjoavat hallitun tallennusinfrastruktuurin tuen paikalliselle tietoyhdyskäytävälle diagnostiikka-asetukset. Tämä ominaisuus ei ole käytettävissä Qatarin alueella.

Sisältävätkö palvelimeen ladatut tiedot luottamuksellisia tietoja?

Kyllä. Ladattu diagnostiikka saattaa sisältää tietoja, joita asiakkaat pitävät arkaluontoisina. Tämä ominaisuus on oletusarvoisesti poistettu käytöstä. Tarkista organisaatiosi tietojenkäsittely- ja tukikäytännöt ennen paikallisten tietoyhdyskäytävien diagnostiikka-asetusten valitsemista.

Kuinka kauan lokeja tallennetaan?

Järjestelmä säilyttää diagnostiikkatietoja 24 tunnin ajan. Voit ladata tietoja Fabric Tietovuo Gen2 -suorituksesta tämän 24 tunnin jakson aikana.

Ketkä voivat käyttää ladattuja lokeja?

Pääsyä hallitaan tiukasti. Microsoft henkilöstöllä ei ole rutiininomaisesti käyttöoikeuksia ladattuihin lokeihin. Käyttöoikeutta rajoitetaan oletusarvoisesti ja myönnetään vain tarvittaessa hyväksyttyjen operatiivisten menettelyjen mukaisesti.

Tuleeko näiden lokien tallentamisesta lisäkustannuksia?

Ei. Paikallisten tietoyhdyskäytävien diagnostiikka-asetuksista ei ole tällä hetkellä saatavilla lisäkustannuksia.

Vianmääritys

Diagnostiikka on käytössä, mutta lokeja ei näy.

Jos diagnostiikka on käytössä, mutta diagnostiikkalokeja ei näy, tarkista seuraavat kohteet:

1. Vahvista lähtevä HTTPS-käyttöoikeus portissa 443 kohteeseen *.dfs.core.windows.net.

2. Varmista, että yhdyskäytävä suoritetaan vakiotilassa. Henkilökohtaisen tilan yhdyskäytäviä ei tueta.

3. Vahvista, että vuokraajan suostumusta yhdyskäytävän diagnostiikkaan ei ole poistettu.

4. Valitse GatewayInfo*.log kohdasta DiagnosticsUploader ja DiagnosticsStorageClient-jäljitysrivit. Hyödyllisiä jäljitysviestejä ovat muun muassa seuraavat: N ladattavaa tiedostoa löytynyt, todentaminen epäonnistui, virheiden enimmäismäärä saavutettu

5. Jos lataus epäonnistuu kolmena peräkkäisenä vuotena, diagnostiikkakokoelma pysäytetään, kunnes käyttö uusitaan. Tämä saattaa saada diagnostiikan näyttämään sammuttaneen odottamattomasti, vaikka pääsyy on toistuva latausvirhe.

Liittyvä sisältö

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