Nedávno navštívené

V "Nedávno navštívené" umožňuje vidět historii prokliků.

V tabulce vidíme:

• Datum
• Čas
• Diagram/element/package/atribute/operace - řádek lze prokliknout na artefakt
• GUID 

Statistika návštěv - přímé čtení z databáze (pro administrátory)

Každé úspěšné otevření detailu (diagram, element, balíček, atribut, operace, kořenový balíček modelu) se zapisuje do tabulky infoport."VisitedDetails" v databázi Infoportu. Tato tabulka je zdrojem funkce "Nedávno navštívené". Pro administrátora nemá aplikace žádnou obrazovku ani statistiky nad touto tabulkou, data lze číst pouze přímo SQL dotazem do databáze.

Struktura tabulky infoport."VisitedDetails"

Indexy jsou pouze na sloupcích UserId a RepositoryId, na VisitTimestamp žádný index není.

Kdy záznam vzniká

• Jeden řádek vzniká při každém úspěšném otevření detailu.
• Nic se neslučuje: obnovení stránky, vynucené obnovení nebo opakované otevření vytvoří další řádek.
• Při přístupu přes veřejný klíč se návštěva zapíše pod uživatele, kterému klíč patří.
• Nezapisuje se odmítnutý přístup (403/404), procházení stromu, vyhledávání, IP adresa ani session.

Retence - důležité pro statistiky

Noční úloha údržby maže záznamy starší než hodnota CleanAfterXDays. Výchozí hodnota je 30 dní a nastavuje se v Configuration Manageru. Úloha běží ve výchozím plánu v 01:00 a spustí se i při startu aplikace. Pro dlouhodobé statistiky je proto nutné tuto hodnotu zvýšit, nebo data každý den archivovat (např. do agregační tabulky).

Příklady dotazů (PostgreSQL)

-- aktivita uživatelů
select u."UserName", count(*) as zobrazeni, count(distinct v."Guid") as unikatni,
       count(distinct v."VisitTimestamp"::date) as aktivni_dny, max(v."VisitTimestamp") as posledni
from infoport."VisitedDetails" v
join infoport."AspNetUsers" u on u."Id" = v."UserId"
group by u."UserName"
order by zobrazeni desc;

-- nejnavštěvovanější položky
select "RepositoryId", "DetailKind", "Guid", count(*) as n, count(distinct "UserId") as uzivatelu
from infoport."VisitedDetails"
group by 1, 2, 3
order by n desc
limit 50;

-- denní průběh
select date_trunc('day', "VisitTimestamp") as den, count(*) as zobrazeni, count(distinct "UserId") as uzivatelu
from infoport."VisitedDetails"
group by 1
order by 1;

-- hodinový průběh
select extract(hour from "VisitTimestamp") as h, count(*) as zobrazeni
from infoport."VisitedDetails"
group by 1
order by 1;

-- poměr typů položek
select "DetailKind", count(*) as zobrazeni
from infoport."VisitedDetails"
group by 1
order by 1;

-- "sezení": mezera delší než 30 minut = nové sezení
select t.*, sum(novy) over (partition by "UserId" order by "VisitTimestamp") as sezeni
from (
  select v.*, case when "VisitTimestamp" - lag("VisitTimestamp") over w > interval '30 min'
                     or lag("VisitTimestamp") over w is null then 1 else 0 end as novy
  from infoport."VisitedDetails" v
  window w as (partition by "UserId" order by "VisitTimestamp")
) t;

Pomocí funkce lag("Guid") lze sledovat i přechody z položky na položku, tedy jak uživatelé procházejí model.

Omezení

• Chybí názvy položek. Tabulka obsahuje jen GUID. Název a typ je nutné dohledat v databázi Enterprise Architect příslušného repozitáře (t_object, t_diagram, t_package, t_attribute, t_operation podle ea_guid). Jde o jinou databázi, proto je nutné propojení (dblink/FDW) nebo export.
• Smazané položky v EA nedohledáte. Aplikace je v historii uživatele tiše vynechává.
• Opakovaná otevření nafukují počty, proto rozlišujte count(*) a count(distinct ...).
• Návštěvy přes veřejný klíč nelze odlišit od běžných návštěv vlastníka klíče.
• Pomalé dotazy u velkých dat: chybí index na VisitTimestamp. Vyplatil by se index (UserId, VisitTimestamp).

Další zdroj dat - Insights log

Pokud potřebujete záznam všech HTTP požadavků (nejen otevření detailu), zapněte v Configuration Manageru (App Logs) volbu Insights a nastavte Log Type na Debug. Každý požadavek se zapíše do souboru insights.log ve složce logů (LogPath) ve tvaru: [doba] [stavový kód] [uživatel nebo no user] [adresa včetně dotazu a těla požadavku, u přihlášení bez hesla]. Soubor se rotuje podle nastavení RollingInterval. Upozornění: Debug zapisuje obsah požadavků, používejte jej jen dočasně a v interním prostředí.