cleaning
This commit is contained in:
169
Docs/DETAILED_LOGGING_GUIDE.md
Normal file
169
Docs/DETAILED_LOGGING_GUIDE.md
Normal file
@@ -0,0 +1,169 @@
|
||||
# VIDEOREADER GLOBAL EDITION - ДЕТАЛЬНОЕ ЛОГГИРОВАНИЕ
|
||||
|
||||
## 🔍 ОБЗОР СИСТЕМЫ ЛОГГИРОВАНИЯ
|
||||
|
||||
VideoReader Global Edition теперь включает продвинутую систему детального логгирования, которая записывает каждый шаг подключения к серверу, все входящие и исходящие пакеты, а также специальные события подключения телефонов.
|
||||
|
||||
## 📊 ВОЗМОЖНОСТИ ЛОГГИРОВАНИЯ
|
||||
|
||||
### ✅ Что логгируется:
|
||||
- **DNS запросы и разрешения** - Все IP адреса сервера
|
||||
- **TCP подключения** - Время установки соединения, таймауты
|
||||
- **Шифрование/дешифрование** - Ключи AES, статус операций
|
||||
- **Пакеты данных** - HEX дамп, ASCII представление, размер
|
||||
- **Подключения телефонов** - Специальные события устройств
|
||||
- **Ошибки и исключения** - Полная трассировка стека
|
||||
- **Статистика сессии** - Объем переданных данных, время работы
|
||||
|
||||
### 📁 Форматы логгирования:
|
||||
|
||||
#### 1. **Пакеты данных** (с HEX дампом):
|
||||
```
|
||||
[PACKET] Direction: INCOMING
|
||||
Size: 64 bytes
|
||||
HEX: 4A B2 C3 D4...
|
||||
ASCII: J...
|
||||
Binary dump:
|
||||
00000000: 4A B2 C3 D4 E5 F6 07 18 29 3A 4B 5C 6D 7E 8F 90 | J.......:K\m~..
|
||||
```
|
||||
|
||||
#### 2. **Подключения:**
|
||||
```
|
||||
[CONNECTION] Starting connection to vidser.top:3033...
|
||||
[CONNECTION] DNS resolved to 4 addresses: 104.21.41.7, 172.67.141.34...
|
||||
[CONNECTION] TCP connection established in 127ms
|
||||
```
|
||||
|
||||
#### 3. **Подключения телефонов:**
|
||||
```
|
||||
[PHONE] Action: Phone connection detected | Phone: Device-ID-12345
|
||||
```
|
||||
|
||||
## 🚀 ИСПОЛЬЗОВАНИЕ
|
||||
|
||||
### Запуск с логгированием:
|
||||
```bash
|
||||
./VideoReader-Global
|
||||
```
|
||||
|
||||
### Интерактивные команды:
|
||||
- `s` - Показать статистику трафика
|
||||
- `d` - Отправить тестовые данные
|
||||
- `q` - Выход из программы
|
||||
|
||||
### Файл лога:
|
||||
- **Имя:** `videoreader_detailed_YYYY-MM-DD_HH-mm-ss.log`
|
||||
- **Расположение:** В папке с исполняемым файлом
|
||||
- **Формат:** Текстовый файл с временными метками
|
||||
|
||||
## 📋 ПРИМЕР РАБОТЫ
|
||||
|
||||
### Консольный вывод:
|
||||
```
|
||||
VideoReader Global Edition v1.0
|
||||
===================================
|
||||
|
||||
Detailed logging initialized: videoreader_detailed_2025-10-09_10-33-45.log
|
||||
Loaded server configuration: vidser.top:3033
|
||||
Channel: 0
|
||||
Server Type: standard
|
||||
|
||||
[CONNECTION] InOutSocket initialized with server: vidser.top:3033
|
||||
[CONNECTION] Starting connection to vidser.top:3033...
|
||||
[CONNECTION] Attempting TCP connection to vidser.top:3033...
|
||||
|
||||
Application running in console mode.
|
||||
Commands:
|
||||
's' - Show statistics
|
||||
'q' - Quit
|
||||
'd' - Send test data
|
||||
```
|
||||
|
||||
### Содержимое лог файла:
|
||||
```
|
||||
=== VideoReader Global Edition Detailed Log ===
|
||||
Session started: 2025-10-09 10:33:45.736
|
||||
Process ID: 213168
|
||||
Machine: trevor-pc
|
||||
User: trevor
|
||||
==============================================
|
||||
|
||||
[2025-10-09 10:33:45.740] [INFO] [Thread-1] Application started
|
||||
[2025-10-09 10:33:45.769] [INFO] [Thread-1] Loaded server configuration: vidser.top:3033
|
||||
[2025-10-09 10:33:45.770] [CONNECTION] [Thread-1] InOutSocket initialized with server: vidser.top:3033
|
||||
[2025-10-09 10:33:45.773] [DEBUG] [Thread-1] Encryption keys initialized - Key: 64-41-E1-74...
|
||||
[2025-10-09 10:33:45.775] [CONNECTION] [Thread-1] Starting connection to vidser.top:3033...
|
||||
[2025-10-09 10:33:45.775] [DEBUG] [Thread-1] Resolving DNS for vidser.top...
|
||||
[2025-10-09 10:33:45.892] [DEBUG] [Thread-1] DNS resolved to 4 addresses: 104.21.41.7, 172.67.141.34...
|
||||
[2025-10-09 10:33:45.903] [CONNECTION] [Thread-1] Attempting TCP connection to vidser.top:3033...
|
||||
```
|
||||
|
||||
## 🔧 ТЕХНИЧЕСКИЕ ДЕТАЛИ
|
||||
|
||||
### Уровни логгирования:
|
||||
- **INFO** - Общая информация о работе приложения
|
||||
- **CONNECTION** - События подключения к серверу
|
||||
- **PACKET** - Детали пакетов данных с HEX дампом
|
||||
- **PHONE** - События подключения устройств
|
||||
- **DEBUG** - Отладочная информация
|
||||
- **ERROR** - Ошибки с полной трассировкой
|
||||
|
||||
### Многопоточность:
|
||||
- Безопасность для многопоточного доступа (thread-safe)
|
||||
- Отдельные потоки для отправки и получения данных
|
||||
- Синхронизация записи в лог файл
|
||||
|
||||
### Производительность:
|
||||
- Асинхронная запись в файл
|
||||
- Буферизация данных
|
||||
- Минимальное влияние на производительность
|
||||
|
||||
## 📝 КОНФИГУРАЦИЯ
|
||||
|
||||
Логгирование автоматически инициализируется при запуске приложения. Никаких дополнительных настроек не требуется.
|
||||
|
||||
Для изменения сервера отредактируйте `server-config.json`:
|
||||
```json
|
||||
{
|
||||
"ServerType": "samsung",
|
||||
"ServerAddress": "s1.cc-vst.online",
|
||||
"Port": 3234,
|
||||
"Channel": 44,
|
||||
"Description": "Samsung VideoReader server"
|
||||
}
|
||||
```
|
||||
|
||||
## 🎯 ПРЕИМУЩЕСТВА
|
||||
|
||||
1. **Полная прозрачность** - Видите каждый байт передаваемых данных
|
||||
2. **Отладка подключений** - Детальная информация о проблемах сети
|
||||
3. **Мониторинг телефонов** - Специальное отслеживание устройств
|
||||
4. **Анализ протокола** - HEX дампы для изучения протокола
|
||||
5. **Архивирование сессий** - Каждая сессия сохраняется в отдельный файл
|
||||
|
||||
## 🔍 АНАЛИЗ ЛОГОВ
|
||||
|
||||
Файлы логов можно анализировать с помощью:
|
||||
- **grep** для поиска определенных событий
|
||||
- **tail -f** для мониторинга в реальном времени
|
||||
- **hexdump** для анализа двоичных данных
|
||||
- Любые текстовые редакторы и IDE
|
||||
|
||||
### Примеры команд:
|
||||
```bash
|
||||
# Отслеживание подключений
|
||||
grep "CONNECTION" videoreader_detailed_*.log
|
||||
|
||||
# Поиск пакетов от телефонов
|
||||
grep "PHONE" videoreader_detailed_*.log
|
||||
|
||||
# Мониторинг ошибок
|
||||
grep "ERROR" videoreader_detailed_*.log
|
||||
|
||||
# Мониторинг в реальном времени
|
||||
tail -f videoreader_detailed_*.log
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**VideoReader Global Edition v1.0 с детальным логгированием готов к использованию!**
|
||||
Reference in New Issue
Block a user