AWatch-rus: Worktime (AQL templates)

Цель: получить «рабочее время» по данным ActivityWatch с учетом:

активного времени (not-afk);
категоризации (classes) для оконных событий;
отдельного категоризованного веб-потока aw-detmir-web-category_<HOST> для доменов.

Ниже — шаблоны AQL для страницы Query в AW Web UI.

Рабочее время по приложениям (окна)

Подходит для расчета рабочего времени в толстых клиентах (1С, документы, админка).

events = flood(query_bucket("aw-watcher-window_HOST-EXAMPLE"));
not_afk = flood(query_bucket("aw-watcher-afk_HOST-EXAMPLE"));
not_afk = filter_keyvals(not_afk, "status", ["not-afk"]);

events = filter_period_intersect(events, not_afk);
events = categorize(events, __CATEGORIES__);

work = filter_keyvals(events, "$category", [
  ["Работа", "1С"],
  ["Работа", "Документы"],
  ["Работа", "Коммуникации"],
  ["Работа", "Администрирование"]
]);

work = merge_events_by_keys(work, ["$category", "app"]);
RETURN = sort_by_duration(work);

Рабочее время в вебе (по доменам)

Требует, чтобы на клиенте работал browser collector и писал в: aw-detmir-web-category_<HOST> поля categoryGroup, rootDomain.

Для Linux-удалёнщиков это может быть не URL-level collector, а title/class-based web-category logger. Например, работа через Proxmox Web UI https://...:8006 может попадать сюда как rootDomain=proxmox-webui, categoryGroup=work, category=Администрирование.

web = flood(query_bucket("aw-detmir-web-category_HOST-EXAMPLE"));
not_afk = flood(query_bucket("aw-watcher-afk_HOST-EXAMPLE"));
not_afk = filter_keyvals(not_afk, "status", ["not-afk"]);

web = filter_period_intersect(web, not_afk);
web = filter_keyvals(web, "categoryGroup", ["work"]);

web = merge_events_by_keys(web, ["rootDomain", "category"]);
RETURN = sort_by_duration(web);

Sanity-check: «куда уходит время»

events = flood(query_bucket("aw-watcher-window_HOST-EXAMPLE"));
not_afk = flood(query_bucket("aw-watcher-afk_HOST-EXAMPLE"));
not_afk = filter_keyvals(not_afk, "status", ["not-afk"]);

events = filter_period_intersect(events, not_afk);
events = categorize(events, __CATEGORIES__);

events = merge_events_by_keys(events, ["$category"]);
RETURN = sort_by_duration(events);

Замечания

Для других хостов замените суффикс _HOST-EXAMPLE на нужный hostname.
Если web-поток пустой, рабочее время в браузере корректно посчитать по доменам не получится. Тогда либо:
- чинить/запускать browser collector;
- либо временно считать браузер в window как «Интернет/Браузер» без разделения на work/personal.

Presence по удалёнщикам Windows/RDP

Если на Windows-клиенте развернут worktime-session-collector.ps1, то появляется bucket aw-worktime-sessions_<HOST> с heartbeat по quser/RDP session state.

Это не замена afk/window, а отдельный канал для ответа на вопрос: «кто и когда вообще был в активной удалённой сессии».

sessions = flood(query_bucket("aw-worktime-sessions_HOST-EXAMPLE"));
sessions = filter_keyvals(sessions, "active", [true]);
sessions = merge_events_by_keys(sessions, ["username", "sessionName", "state"]);
RETURN = sort_by_duration(sessions);

Практический смысл:

для GUI-удалёнщиков рабочее время лучше считать по пересечению window + not-afk;
для RDP presence и быстрой сверки смены можно использовать aw-worktime-sessions_*;
для SSH-only пользователей нужны aw-console-commands_* и aw-ssh-sessions_*, но это не полный аналог desktop worktime.

4.4 KiB Raw Blame History Unescape Escape