Querylogbestanden verzamelen en analyseren

Querylogbestanden bevatten krachtige diagnostische informatie waarmee beheerders problemen met betrekking tot de prestaties van de query's, foutscenario's en foutieve resultaten kunnen analyseren en oplossen. Wanneer u querylogbestanden in Oracle Analytics activeert, wordt er informatie over ontleden, optimalisatie, uitvoeringsplannen, fysieke query's, overzichtsstatistieken en meer in het querylogbestand geschreven.

Querylogbestanden openen

Querylogbestanden worden serieel in dezelfde volgorde als de uitvoering van query's in het hele systeem geschreven. Elke sessie en aanvraag wordt met een unieke ID geïdentificeerd. Beheerders kunnen deze querylogbestanden vanuit de pagina Sessies en querylogbestanden in de console openen. Als u wilt weten hoe u deze pagina kunt openen, raadpleegt u SQL-zoekvragen en logs analyseren.

Opmerking:

Werkmapauteurs kunnen tevens querygegevens openen zoals querytijd, servertijd en streamingtijd voor visualisatiecomponenten in hun werkmappen. Zie Querylogbestanden voor een werkmap openen aan het einde van dit onderwerp.

Niveaus querylogbestand

  • Het logbestandsniveau stelt de details van gegenereerde logbestanden vast en de hoeveelheid.

  • U kunt het logbestandsniveau instellen op systeem-, sessie- of rapportniveau.
  • U kunt het globale logbestandsniveau voor uw semantische model (RPD) definiëren met behulp van de eigenschap Logbestandsniveau systeem (onder Hulpprogramma's, Optie, Repository) of onder de sessievariabele.

    Beschrijving van GUID-8BF38235-E497-4FC9-B4C3-D5E3B11C2991-default.jpg volgt hierna
    .jpg

  • U kunt het logbestandsniveau voor een rapport omzeilen door de variabele LOGLEVEL toe te voegen aan de eigenschap Voorvoegsel, beschikbaar in het tabblad Geavanceerd van het rapport.

  • Om te garanderen dat u volledige logbestanden krijgt door cachetreffers te voorkomen, kunt u de variabele DISABLE_CACHE_HIT=1 met LOGLEVEL opnemen.

    Beschrijving van GUID-028022F5-7C3F-4EA4-B497-88453DFF4853-default.jpg volgt hierna
    .jpg

  • De waarden van het logbestandsniveau (LOGLEVEL) liggen tussen 0 en 7.
    • LOGLEVEL=0 betekent dat het loggen is gedeactiveerd.
    • LOGLEVEL=7 is het hoogste logbestandsniveau dat met name door het ontwikkelingsteam van Oracle wordt gebruikt.
    • LOGLEVEL=2 is geschikt voor het optimaliseren van prestaties en basiskennis.
    • LOGLEVEL=3 is vereist voor het oplossen van problemen met databeveiligingsfilters op rijniveau.
  • Afhankelijk van het logbestandsniveau bevatten querylogbestanden informatie over de query, waaronder de logische aanvraag, het navigatie- en uitvoeringsplan, de gegenereerde fysieke query, de uitvoeringstijd, rijen en bytes die met verschillende uitvoeringsnoden zijn opgehaald en cachegerelateerde informatie.

Beheerders kunnen querylogbestanden extraheren via de pagina SQL-instructie geven in de console, door de query uit te voeren met de passende instellingen voor het LOGLEVEL en de variabelen.

Beschrijving van GUID-CE500760-79A2-4D2E-83CA-F401163B111F-default.jpg volgt hierna
.jpg

Een querylogbestand lezen

Op de pagina Sessies en querylogbestanden staan alle query's en sessies die momenteel actief zijn. Beheerders kunnen deze pagina vanuit de console openen.

Beschrijving van GUID-E741680B-8E04-4FBA-9173-4D2F1CAA680E-default.jpg volgt hierna
.jpg

Elke invoer op de pagina geeft toegang tot het querylogbestand voor een bepaalde query op het ingestelde niveau (dat wil zeggen, op het semantisch, sessie- of rapportniveau).

Beschrijving van GUID-AF2BE54A-CC5E-44C0-88E2-9ADD91B3962C-default.jpg volgt hierna
.jpg

Elke aanvraag heeft een unieke requestid in Oracle Analytics.

Logische SQL-query

Dit een voorbeeld van een logische SQL-query in Oracle Analytics.

Beschrijving van GUID-ACCBD275-1027-48FB-9183-8EB87EB94078-default.jpg volgt hierna
.jpg

Dit zijn enkele veelgebruikte variabelen die u mogelijk in een logische SQL-aanvraag tegenkomt.

  • QUERY_SRC_CD: de oorsprong van de query, zoals de prompt, de visualisatie van gegevens, het rapport, de SQL-instructie enzovoort.
  • SAW_SRC_PATH: als de query wordt opgeslagen, is dit het pad naar de query in de catalogus.
  • SAW_DASHBOARD: als de query in een dashboard is opgenomen, is dit het pad naar het dashboard in de catalogus.
  • SAW_DASHBOARD_PG: de naam van de dashboardpagina.

Logische aanvraag

De logische aanvraag is de vertaling van een query van de presentatielaag naar het bedrijfsmodel en de toewijzingslaag, nadat er mogelijk beveiligingsfilters zijn toegevoegd.

Beschrijving van GUID-74E1CA85-56BB-412D-B9F1-468E1D143DFD-default.jpg volgt hierna
.jpg

Oracle Analytics besluit op basis van de logische aanvraag of de query een bestaande cache treft of uit de database moet worden opgehaald.

Beschrijving van GUID-AD43A89E-4AC8-4A6A-B30F-167EEA2BAE0F-default.jpg volgt hierna
.jpg

Uitvoeringsplan

Het uitvoeringsplan is de transformatie van de werkelijke logische aanvraag in een geoptimaliseerd plan voor de uitvoering. Hieronder valt een verzendingsplan voor elke bewerking en of het in de database of in Oracle Analytics wordt uitgevoerd. Wanneer een bewerking in Oracle Analytics wordt uitgevoerd, geeft het querylogbestand [for database 0:0,0] aan.

Beschrijving van GUID-41665BED-DD61-4056-BEDD-D54D2292BD58-default.jpg volgt hierna
.jpg

Tijdens de uitvoering doorloopt Oracle Analytics exact deze boomstructuur. In gedetailleerde logbestanden is informatie over de verwerkte rijen op elke node van de uitvoeringsboomstructuur beschikbaar.

Beschrijving van GUID-58CDEF0F-CE9D-41D7-A639-1F68749074B1-default.jpg volgt hierna
.jpg

Fysieke of database-aanvragen

Op basis van het uitvoeringsplan genereert Oracle Analytics een fysieke SQL die op de opgegeven database wordt uitgevoerd. Er kunnen een of meer aanvragen naar een of meer databases worden verzonden.

Beschrijving van GUID-67BA9E19-057C-4918-A583-C127B2D14F32-default.jpg volgt hierna
.jpg

Voor elke fysieke aanvraag die naar de database wordt verzonden, is er een logbestand voor het aantal opgehaalde rijen en bytes.

Beschrijving van GUID-A103C103-084C-4370-BDB6-0D2728A66DAB-default.jpg volgt hierna
.jpg

Wanneer er meerdere query's zijn, kunt u de query-ID (in dit voorbeeld 1914627) gebruiken om de exacte query te gebruiken die is gelogd in de sectie Sending query to the database. Zo kunt u de query toewijzen met opgehaalde rijen wanneer er meerdere database-aanvragen zijn.

Eén rapport kan meerdere query's naar een of meer databases verzenden, afhankelijk van de definitie van de rapportstructuur en het semantische model. In dit querylogbestand werden er bijvoorbeeld 3 fysieke query's naar de database verzonden.

Beschrijving van GUID-6AD88CC1-CED9-4609-BB30-F6B0F94BB105-default.jpg volgt hierna
.jpg

Het logbestand geeft soortgelijke verwerkte informatie over rijen voor alle nodes in het uitvoeringsplan. Tot slot: de rijen die naar de client worden verzonden, worden gelogd.

Beschrijving van GUID-94913767-718C-44B4-AE6C-6081DD12D8B4-default.jpg volgt hierna
.jpg

Het logbestand bevat ook een uiteindelijk overzicht van statistieken, waaronder de totale uitvoeringstijd. U kunt deze tijd correleren om prestatieproblemen te analyseren en onderzoeken.

Beschrijving van GUID-2F47CE96-DFE8-4B4F-940A-3FF9CE336F2A-default.jpg volgt hierna
.jpg

Overzichtsstatistieken

Er verschijnen verschillende tijdstatistieken in het overzicht van het querylogbestand.
  • Verstreken tijd: de totale verstreken tijd vanaf het punt dat de logische query is ontvangen tot de client de cursor sluit. Als de client toestaat dat de gebruiker door het resultaat kan scrollen, net zoals Oracle Analytics, dan kan de cursor lang open blijven, totdat de gebruiker naar een andere pagina navigeert of zich afmeldt.
  • Compilatietijd: de tijd die Oracle Analytics gebruikt om het uitvoeringsplan en de fysieke query's van de logische SQL-query te genereren.
  • Totale tijd in BI-server: de totale hoeveelheid tijd die de client wacht op een respons. Dit omvat de uitvoeringstijd van fysieke query's, wachttijd tijdens het ophalen en in Oracle Analytics gespendeerde tijd voor de interne uitvoering.
  • Uitvoeringstijd: de tijd vanaf het punt dat de logische query door Oracle Analytics wordt ontvangen, totdat de uitvoering van de logische query is voltooid. Hieronder valt niet de tijd die de client na het uitvoeren van de query besteedt aan het ophalen van resultaten.
  • Responstijd: de tijd vanaf het punt dat de logische query door Oracle Analytics wordt ontvangen, totdat de eerste rij naar de client is geretourneerd.

Overwegingen voor querylogbestanden

  • Activiteit met één thread Bij ongunstige omstandigheden kunt u prestatieproblemen ervaren bij logbestandsniveaus van hoger dan 2.

  • De weergegeven en berekende tijden gelden voor wanneer invoer naar het logbestand wordt geschreven en dit is meestal het moment waarop ze plaatsvinden (oftewel de activiteit waarmee de logbestandinvoer is gestart). Tenzij er andere knelpunten zijn die invloed hebben op het loggen.

  • Querylogbestanden zijn bedoeld voor het stellen van een diagnose en niet voor het verzamelen van gebruiksgegevens. Als u meer wilt weten over het bijhouden van gebruik, raadpleegt u Gebruik controleren.

Querylogbestanden voor een werkmap openen

Alleen beheerders kunnen logbestanden vanuit de pagina Sessies en querylogbestanden in de console openen. Inhoudauteurs kunnen echter via het menu Ontwikkelaar logbestandinformatie openen voor visualisatiequery's in hun werkmappen. Dit is een nuttig hulpprogramma voor auteurs die problemen met hun queryprestaties willen oplossen. Gebruikers die het prestatiehulpprogramma voor werkmappen willen openen (de menu-optie Ontwikkelaar), moeten Ontwikkelaarsopties activeren in het menu Geavanceerdonder Mijn profiel inschakelen.

Beschrijving van GUID-1C5E06A4-B442-41CF-9A16-029A8878237B-default.jpg volgt hierna
.jpg

Na de activering wordt de menu-optie Ontwikkelaar in het werkmapmenu weergegeven.

Beschrijving van GUID-72F0DD44-DD0A-47D4-942B-3E014F122B0F-default.jpg volgt hierna
.jpg

Met de optie Ontwikkelaar kunnen gebruikers direct verschillende logbestanden weergeven en analyseren voor visualisatie op een canvas. Onder het canvas verschijnt een nieuw venster met verschillende tabbladen voor elk type informatie. Logbestanden worden niet standaard ingevuld of vernieuwd bij het uitvoeren van de visualisatie.

Beschrijving van GUID-5D339116-5D5F-4AA2-B16B-82096E0B0D3C-default.jpg volgt hierna
.jpg

Selecteer de visualisatie die u wilt analyseren en klik op Vernieuwen om de logbestanden te genereren. Na het vernieuwen worden er verschillende typen informatie over de visualisatiedisplays weergegeven en kunt u de logbestandsinformatie voor de specifieke visualisatie analyseren. Als u meerdere visualisaties wilt analyseren, moet u ze afzonderlijk vernieuwen en beurtelings analyseren.

Beschrijving van GUID-5A53D8E3-0776-44DC-ADD9-214C231E172B-default.jpg volgt hierna
.jpg
Met de optie Developer kunnen inhoudauteurs een reeks informatie analyseren zoals prestatielogbestanden, JSON's, XML's en aan gegevenssets gerelateerde informatie. Dit betekent dat ze logbestanden kunnen analyseren zonder dat ze beheerderstoegang tot de pagina Sessies en querybestanden nodig hebben.

Opmerking:

Het menu Ontwikkelaar is alleen beschikbaar voor werkmappen. Voor klassieke analyses en dashboards kunt u querylogbestanden via de pagina Sessies en querylogbestanden openen.