AWatch-rus/docs/1C_GRAFANA_DEPLOYMENT_RU.md

1С-Бухгалтерия: сбор и анализ в Grafana

Документ описывает внедрение контура мониторинга 1С в Grafana через Prometheus и SQL Exporter.

Важно: этот документ относится к сценарию, где 1С удобно читается через SQL/read-only views. Для файловой 1С теперь есть отдельный контур:

• docs/1C_FILE_ANALYTICS_STACK_RU.md
• clickhouse-1c/README.md

1. Целевая схема

1. База 1С (PostgreSQL или MS SQL) содержит KPI views.
2. sql-exporter опрашивает views read-only пользователем.
3. prometheus собирает метрики и считает alert-rules.
4. grafana визуализирует KPI и алерты.

2. Подготовка

Рабочий каталог:

• <PROJECT_ROOT>/grafana-1c

Подготовка env:

cd <PROJECT_ROOT>/grafana-1c
cp <PROJECT_ROOT>/grafana-1c/.env.example \
   <PROJECT_ROOT>/grafana-1c/.env

Обязательно изменить:

• GRAFANA_ADMIN_PASSWORD
• ONEC_DSN

3. SQL-представления KPI

Используйте шаблон под вашу СУБД:

• PostgreSQL: <PROJECT_ROOT>/grafana-1c/sql/postgres_views_template.sql
• MS SQL: <PROJECT_ROOT>/grafana-1c/sql/mssql_views_template.sql

После адаптации шаблона под фактические таблицы 1С создайте views в БД.

Быстрое профилирование схемы 1С (PostgreSQL):

sh <PROJECT_ROOT>/grafana-1c/tools/discover_postgres_1c.sh \
  "postgres://user:pass@db-host:5432/db?sslmode=disable"

Проверка KPI views перед запуском:

sh <PROJECT_ROOT>/grafana-1c/tools/validate_kpi_views.sh \
  "postgres://user:pass@db-host:5432/db?sslmode=disable"

4. Запуск стека

cd <PROJECT_ROOT>/grafana-1c
docker compose up -d

5. Верификация

Проверка метрик sql-exporter:

curl -fsS http://127.0.0.1:9399/metrics | rg "onec_"

Проверка Prometheus:

curl -fsS http://127.0.0.1:9090/-/healthy

Проверка Grafana:

• URL: http://<host>:3000
• Дашборд: 1C Бухгалтерия — Обзор
• Дашборд: 1C Бухгалтерия — SRE

E2E health-check:

sh <PROJECT_ROOT>/grafana-1c/tools/check_pipeline.sh

6. KPI и алерты

Метрики:

• onec_unposted_documents_total
• onec_sales_amount_today
• onec_overdue_receivables_total
• onec_posting_errors_total
• onec_data_freshness_seconds

Алерты:

• OneCUnpostedDocumentsHigh (warning)
• OneCOverdueReceivablesCritical (critical)
• OneCSQLExporterDown (critical)
• OneCDataFreshnessCritical (critical)

Файл правил:

• <PROJECT_ROOT>/grafana-1c/prometheus/alerts.yml

7. Эксплуатационный минимум

• Доступ к БД 1С только read-only.
• Права только на KPI views.
• Ротация пароля read-only пользователя не реже 90 дней.
• Бэкап grafana-data и prometheus-data (docker volumes).