AWatch-rus/docs/windows/troubleshooting.md

Windows troubleshooting

Частые проблемы

Run this script from an elevated PowerShell session

• Откройте PowerShell через Run as administrator.
• Проверьте, что UAC не понизил токен.

Задачи созданы, но watcher'ы не стартуют

• Убедитесь, что пользователь реально вошёл в интерактивную сессию.
• Проверьте задачу ActivityWatch Launch [...] в Task Scheduler.
• Запустите вручную:

Start-ScheduledTask -TaskName 'ActivityWatch Launch [CONTOSO_user01]'

• Если доменный логон ещё ни разу не происходил на хосте, сначала выполните вход этим пользователем.

Collector не видит URL

• Скрипт работает через UI Automation и foreground window.
• Некоторые браузеры/страницы могут скрывать адресную строку или блокировать UIA.
• Проверьте лог C:\ProgramData\AWatch-rus\logs\browser-domains-<user>.log.
• Убедитесь, что активное окно — поддерживаемый браузер: Edge, Chrome, Brave, Vivaldi, Opera, Firefox.

Сервер недоступен

• Проверьте TCP-доступ:

Test-NetConnection aw.example.local -Port 5600

• Проверьте локально API:

Invoke-WebRequest http://aw.example.local:5600/api/0/info

• Если нужен HTTPS reverse proxy, задайте -ServerScheme https.

Неправильная категоризация домена

• Проверьте содержимое C:\ProgramData\AWatch-rus\web-category-rules.json.
• Пользовательские правила должны быть валидным JSON.
• Один и тот же домен лучше определять только в одной категории.
• После изменения правил достаточно перезапустить collector или задачу пользователя:

Stop-Process -Name powershell -ErrorAction SilentlyContinue
Start-ScheduledTask -TaskName 'ActivityWatch Launch [CONTOSO_user01]'

ACL сломаны или пользователи удалили runtime-файлы

• Запустите:

.\windows\hardening-recovery.ps1 -RepairPackage

• Если сервер и пользователи уже есть в deployment-config.json, дополнительные параметры не нужны.

Ошибка InvalidVariableReferenceWithDrive (в строке Server: http://...)

Симптом:

• деплой падает на выводе URL сервера с ошибкой о недопустимой ссылке на переменную.

Решение:

• обновить скрипты до версии, где используется ${ServerScheme} в строке вывода;
• перезалить deploy-single-user.ps1 / deploy-domain-users.ps1 на целевой хост.

Ошибка LogonType InteractiveToken при регистрации задач

Симптом:

• Register-ActivityWatchUserTasks падает с ошибкой преобразования enum для LogonType.

Решение:

• использовать версию ActivityWatch.Windows.Common.psm1, где LogonType задан как Interactive;
• повторно запустить deploy/hardening после обновления модуля.

Диагностика

Standalone service не работает

Проверить сервис:

Get-Service AWatchRusStandaloneAgent
sc.exe query AWatchRusStandaloneAgent

Перезапуск:

Restart-Service AWatchRusStandaloneAgent

Лог service wrapper:

Get-Content C:\ProgramData\AWatch-rus\logs\standalone-agent-service.log -Tail 200

Проверить дочерние collector-процессы:

Get-CimInstance Win32_Process |
  Where-Object { $_.Name -eq 'powershell.exe' -and $_.CommandLine -like '*AWatch-rus*collector*.ps1*' } |
  Select-Object ProcessId, SessionId, CommandLine

Проверить задачи:

Get-ScheduledTask -TaskName 'ActivityWatch*' | Select-Object TaskName, State

Проверить процессы в пользовательской сессии:

Get-Process aw-watcher-afk, aw-watcher-window -ErrorAction SilentlyContinue |
  Select-Object ProcessName, Id, SessionId, StartTime

Проверить collector:

Get-CimInstance Win32_Process |
  Where-Object { $_.Name -in 'powershell.exe', 'pwsh.exe' -and $_.CommandLine -match 'browser-domains-native-collector.ps1' } |
  Select-Object ProcessId, SessionId, CommandLine

Проверить конфиг:

Get-Content C:\ProgramData\AWatch-rus\deployment-config.json -Raw

Когда запускать hardening/recovery

• После ручной чистки задач.
• После неудачного обновления ActivityWatch.
• После переноса сервера на другой host/port.
• После обновления списка пользователей.
• После изменения кастомных правил, если нужен централизованный repair pass.