176 lines
4.5 KiB
Markdown
Executable File
176 lines
4.5 KiB
Markdown
Executable File
# Установка и запуск системы мониторинга
|
||
|
||
## Требования
|
||
|
||
- PHP 8.3 или выше
|
||
- Composer
|
||
- MySQL 8+ или MariaDB 10.5+
|
||
- Apache или Nginx
|
||
|
||
## Установка
|
||
|
||
### 1. Клонирование проекта
|
||
|
||
```bash
|
||
git clone <repository-url>
|
||
cd mon
|
||
```
|
||
|
||
### 2. Установка зависимостей
|
||
|
||
```bash
|
||
composer install
|
||
```
|
||
|
||
### 3. Настройка базы данных
|
||
|
||
1. Создайте базу данных:
|
||
|
||
```sql
|
||
CREATE DATABASE monitoring_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||
```
|
||
|
||
2. Импортируйте схему:
|
||
|
||
```bash
|
||
mysql -u root -p monitoring_system < schema.sql
|
||
```
|
||
|
||
### 4. Настройка веб-сервера
|
||
|
||
#### Apache
|
||
|
||
Создайте виртуальный хост:
|
||
|
||
```apache
|
||
<VirtualHost *:80>
|
||
ServerName mon.mirv.top
|
||
DocumentRoot /path/to/monitoring-system/public
|
||
|
||
<Directory /path/to/monitoring-system/public>
|
||
AllowOverride All
|
||
Require all granted
|
||
</Directory>
|
||
|
||
ErrorLog ${APACHE_LOG_DIR}/mon_error.log
|
||
CustomLog ${APACHE_LOG_DIR}/mon_access.log combined
|
||
</VirtualHost>
|
||
```
|
||
|
||
#### Nginx
|
||
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name mon.mirv.top;
|
||
root /path/to/monitoring-system/public;
|
||
index index.php;
|
||
|
||
location / {
|
||
try_files $uri $uri/ /index.php?$query_string;
|
||
}
|
||
|
||
location ~ \.php$ {
|
||
include snippets/fastcgi-php.conf;
|
||
fastcgi_pass unix:/var/run/php/php8.3-fpm.sock;
|
||
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
|
||
}
|
||
}
|
||
```
|
||
|
||
### 5. Настройка окружения
|
||
|
||
Скопируйте `.env.example` в `.env` и укажите параметры подключения к базе данных:
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
```
|
||
|
||
Ключевые переменные:
|
||
|
||
```dotenv
|
||
DB_HOST=localhost
|
||
DB_NAME=monitoring_system
|
||
DB_USERNAME=mon_user
|
||
DB_PASSWORD=your_db_password
|
||
APP_PORT=8082
|
||
```
|
||
|
||
## Использование
|
||
|
||
### 1. Вход в систему
|
||
|
||
Перейдите на `http://mon.mirv.top/login` и войдите в систему.
|
||
|
||
По умолчанию миграция `007_seed_admin_user.sql` создаёт пользователя:
|
||
|
||
- логин: `admin`
|
||
- пароль: `mirvmon2026`
|
||
|
||
### 2. Добавление серверов
|
||
|
||
1. Перейдите в раздел "Серверы"
|
||
2. Нажмите "Добавить сервер"
|
||
3. Заполните форму и сохраните
|
||
4. На странице подтверждения скопируйте токен и скачайте скрипт установки
|
||
|
||
### 3. Установка агента на мониторимый сервер
|
||
|
||
1. Скачайте скрипт установки с сервера мониторинга
|
||
2. Загрузите его на сервер, который нужно мониторить
|
||
3. Выполните:
|
||
|
||
```bash
|
||
chmod +x install.sh
|
||
./install.sh
|
||
```
|
||
|
||
Агент будет установлен как systemd-сервис и начнет отправлять метрики на сервер мониторинга.
|
||
|
||
## Trends и длинные периоды
|
||
|
||
Для графиков за периоды больше 24 часов используются агрегированные данные из `server_metrics_trends`.
|
||
Если после установки или миграции нужно дозаполнить историю:
|
||
|
||
```bash
|
||
php /var/www/mon/cron/backfill_trends.php 30
|
||
```
|
||
|
||
## API
|
||
|
||
### Отправка метрик
|
||
|
||
Агенты отправляют метрики на эндпоинт `/api/v1/metrics` методом POST:
|
||
|
||
```json
|
||
{
|
||
"token": "токен_сервера",
|
||
"metrics": {
|
||
"cpu_load": 45.2,
|
||
"ram_used": 89.1,
|
||
"ram_total_gb": 16.0,
|
||
"disk_used_root": 65.5,
|
||
"net_in_ens3": 12.3,
|
||
"net_out_ens3": 5.6
|
||
},
|
||
"services": [
|
||
{"name": "nginx", "status": "running"}
|
||
]
|
||
}
|
||
```
|
||
|
||
### Скачивание агента
|
||
|
||
```
|
||
GET /get-agent?token=<server_token>
|
||
GET /agent/install.sh?token=<server_token>
|
||
GET /agent/install.bat?token=<server_token>
|
||
```
|
||
|
||
## Безопасность
|
||
|
||
- Все пароли хешируются с помощью `password_hash()`
|
||
- Токены агентов хранятся в виде SHA-256 хешей
|
||
- Все SQL-запросы используют подготовленные выражения
|
||
- Вход на все страницы требует аутентификации (кроме API и страницы входа)
|