> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/ai-platforma-oneapa/administrirovanie/monitoring.md).

# Мониторинг

Руководство по мониторингу системы OneAPA.

## Точки мониторинга

| Компонент      | Что мониторить            |
| -------------- | ------------------------- |
| Proxy-сервер   | Доступность, время ответа |
| LLM провайдеры | Ошибки, лимиты            |
| 1С сервер      | Производительность        |
| Агенты         | Использование, ошибки     |

## Мониторинг Proxy

### Health Check

```bash
# Проверка доступности
curl http://proxy:9000/health

# Ожидаемый ответ
{
  "message": "OK",
  "version": "1.0.1"
}
```

### Автоматическая проверка

```bash
#!/bin/bash
# Скрипт мониторинга

PROXY_URL="http://proxy:9000/health"
ALERT_EMAIL="admin@company.ru"

response=$(curl -s -o /dev/null -w "%{http_code}" $PROXY_URL)

if [ "$response" != "200" ]; then
    echo "OneAPA Proxy недоступен" | mail -s "ALERT: OneAPA" $ALERT_EMAIL
fi
```

### Docker мониторинг

```bash
# Статус контейнера
docker ps --filter "name=oneapa"

# Использование ресурсов
docker stats oneapa-proxy

# Логи
docker logs --tail 100 oneapa-proxy
```

## Метрики

### Основные метрики

| Метрика             | Описание                    | Порог               |
| ------------------- | --------------------------- | ------------------- |
| Время ответа        | Среднее время ответа агента | < 30 сек            |
| Ошибки LLM          | Количество ошибок в час     | < 10                |
| Вызовы инструментов | Количество вызовов          | -                   |
| Активные сессии     | Параллельные диалоги        | Зависит от ресурсов |

### Prometheus

```yaml
# prometheus.yml
scrape_configs:
  - job_name: 'oneapa'
    static_configs:
      - targets: ['proxy:9000']
    metrics_path: /metrics
```

## Мониторинг LLM

### OpenAI

* Проверяйте баланс
* Следите за rate limits
* Мониторьте ошибки 429

### Yandex GPT

* Проверяйте IAM токен (истекает через 12ч)
* Следите за квотами

### Ollama

* Мониторьте использование GPU
* Проверяйте загрузку RAM

## Алерты

### Критические

* Proxy недоступен
* 100% ошибок LLM
* Нет места на диске

### Предупреждения

* Время ответа > 60 сек
* Ошибки > 10% запросов
* Низкий баланс LLM провайдера

## Dashboard

### Grafana пример

```
┌─────────────────────────────────────────────────────────────┐
│                    OneAPA Dashboard                          │
├─────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ Status: ✅  │ │ Requests/h  │ │ Avg Response Time       │ │
│ │   ONLINE    │ │    1,234    │ │      12.5 sec           │ │
│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │
│                                                              │
│ [График запросов за сутки]                                  │
│                                                              │
│ [График ошибок]                                             │
└─────────────────────────────────────────────────────────────┘
```