В современных банковских системах логи играют ключевую роль: они фиксируют каждое действие терминала, позволяют быстро находить причины ошибок и помогают службе технической поддержки восстановить работу системы. В статье рассмотрим, что такое архив логов Сбербанка, зачем его выгружать и как выполнить эту операцию правильно, используя терминал, веб‑интерфейс и API.
Содержание
- Что такое архив логов Сбербанка?
- Зачем требуется выгрузка логов?
- Подготовка к выгрузке: требования и ограничения
- Выгрузка через терминал (командная строка)
- Выгрузка через веб‑интерфейс Сбербанк Онлайн
- Автоматическая выгрузка через Sber API
- Как отправить архив оператору технической поддержки
- Типичные проблемы и способы их решения
- Безопасность при работе с логами
- Часто задаваемые вопросы
Что такое архив логов Сбербанка?
Логи – это файлы, в которых фиксируются все события, происходящие в системе:
- Транзакции (платёжные операции, запросы к серверу);
- Ошибки и исключения;
- События аутентификации и авторизации;
- Системные сообщения (обновления, перезапуски сервисов).
Для упрощения передачи и хранения логи часто упаковываются в архивный файл (ZIP, TAR.GZ). Такой архив называют архивом логов.
Зачем требуется выгрузка логов?
Основные причины, по которым клиент или администратор может потребовать выгрузить архив логов:
- Диагностика ошибок терминала. При возникновении сбоя служба поддержки запрашивает логи за конкретный период.
- Аудит и соответствие требованиям. Регуляторы могут потребовать предоставить журналы операций.
- Архивирование. Для долгосрочного хранения данных в соответствии с политикой компании.
- Передача в сторонние системы. Например, в SIEM‑решения или хранилища облачных провайдеров.
Подготовка к выгрузке: требования и ограничения
Перед тем как начать процесс, убедитесь, что выполнены следующие условия:
- Доступ к терминалу. На рабочей станции должен быть установлен клиент Сбербанк (обычно это
sb-terminal). - Права администратора. Для чтения системных логов нужны права
rootили специальные роли в системе СБ. - Свободное место. Архив может занимать от нескольких мегабайт до гигабайт; проверьте наличие свободного места в
/tmpили выбранной папке. - Сетевое соединение. Если планируется отправка логов по HTTPS, убедитесь, что порт 443 открыт.
- Согласие пользователя. При работе с персональными данными необходимо получить согласие в соответствии с GDPR/ФЗ‑152.
Выгрузка через терминал (командная строка)
Самый надёжный способ – использовать встроенные утилиты терминала Сбербанка. Ниже представлена пошаговая инструкция.
Шаг 1. Подключение к терминалу
ssh admin@terminal-hostname
Шаг 2. Определение периода логов
Логи хранятся в каталоге /var/log/sberbank/ с именем log_YYYYMMDD_HHMMSS.log. Чтобы собрать файлы за нужный диапазон, используем find:
START="2025-06-09 00:00:00"
END="2025-06-09 23:59:59"
find /var/log/sberbank/ -type f
-newermt "$START" ! -newermt "$END"
-name "log_*.log" -print > /tmp/log_list.txt
Шаг 3. Создание архива
Для упаковки в ZIP удобно использовать zip:
zip -@ /tmp/sberbank_logs_$(date +%Y%m%d_%H%M%S).zip < /tmp/log_list.txt
Опция -@ читает список файлов из стандартного ввода.
Шаг 4. Проверка целостности архива
unzip -t /tmp/sberbank_logs_.zip
Если проверка прошла без ошибок, архив готов к передаче.
Шаг 5. Перемещение архива в безопасную папку
mv /tmp/sberbank_logs_.zip /home/admin/logs_to_send/
Полный скрипт (для автоматизации)
#!/bin/bash
START=$1 # пример: "2025-06-09 00:00:00"
END=$2 # пример: "2025-06-09 23:59:59"
DEST_DIR="/home/admin/logs_to_send"
TMP_LIST="/tmp/log_list.txt"
find /var/log/sberbank/ -type f -newermt "$START" ! -newermt "$END" -name "log_*;log" > "$TMP_LIST"
ARCHIVE="${DEST_DIR}/sberbank_logs_$(date +%Y%m%d_%H%M%S);zip"
zip -@ "$ARCHIVE" < "$TMP_LIST"
if unzip -t "$ARCHIVE" >/dev/null 2>&1; then
echo "Архив успешно создан: $ARCHIVE"
else
echo "Ошибка при проверке архива!"
exit 1
fi
rm -f "$TMP_LIST"
Запуск скрипта:
chmod +x export_logs.sh
./export_logs.sh "2025-06-09 00:00:00" "2025-06-09 23:59:59"
Выгрузка через веб‑интерфейс Сбербанк Онлайн
Если у вас нет доступа к терминалу, можно воспользоваться функцией «Выгрузить в Excel/CSV», которая экспортирует историю операций, но также позволяет скачать лог‑файлы из раздела Техническая поддержка → Логи терминала.
- Войдите в Сбербанк Онлайн (веб‑версия или мобильное приложение).
- Перейдите в раздел «Настройки» → «Техническая поддержка».
- Нажмите кнопку «Скачать логи терминала». Откроется диалог выбора периода.
- Укажите дату и время возникновения проблемы и нажмите «Выгрузить».
- Файл будет автоматически сохранён в папку
Загрузки вашего браузера (обычно Downloads).
После скачивания проверьте размер файла (не должен быть 0 KB) и откройте его в архиваторе, чтобы убедиться в наличии файлов *.log.
Автоматическая выгрузка через Sber API
Для интеграторов и компаний, которым требуется регулярный экспорт логов, Сбербанк предоставляет Sber API. Ниже – минимальный пример на Python.
Шаг 1. Получить токен доступа
import requests
TOKEN_URL = "https://api.sberbank.ru/auth/token"
CLIENT_ID = "your_client_id"
CLIENT_SECRET = "your_client_secret"
resp = requests.post(TOKEN_URL, data={
"grant_type": "client_credentials",
"client_id": CLIENT_ID,
"client_secret": CLIENT_SECRET
})
access_token = resp.json["access_token"]
Шаг 2. Запросить архив логов
LOGS_URL = "https://api.sberbank.ru/v1/logs/export"
params = {
"start": "2025-06-09T00:00:00Z",
"end": "2025-06-09T23:59:59Z",
"format": "zip"
}
headers = {"Authorization": f"Bearer {access_token}"}
response = requests.get(LOGS_URL, params=params, headers=headers, stream=True)
if response.status_code == 200:
with open("sberbank_logs.zip", "wb") as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
print("Логи успешно скачаны")
else:
print("Ошибка:", response.status_code, response.text)
В результате вы получите файл sberbank_logs.zip, который можно сразу отправлять в техподдержку.
Как отправить архив оператору технической поддержки
После получения архива выполните следующие действия:
- Проверьте конфиденциальность. Удалите из логов любые персональные данные, если это не требуется для диагностики.
- Зашифруйте файл с помощью
gpg или openssl: gpg --symmetric --cipher-algo AES256 sberbank_logs.zip
Вам будет предложено ввести пароль – передайте его оператору отдельным каналом (например, по телефону).
- Отправьте файл через защищённый канал:
- Электронная почта с TLS‑шифрованием (вложение);
- Корпоративный мессенджер (Telegram Business, Microsoft Teams) с включённым сквозным шифрованием;
- Файлообменник с одноразовой ссылкой (Google Drive, Yandex Disk) и ограниченным сроком доступа.
- Сохраните копию отправленного архива и подтверждение получения (скриншот, письмо‑подтверждение).
Типичные проблемы и способы их решения
Проблема Возможные причины Решение Файл архива пустой (0 KB) Неправильно указаны даты; лог‑файлы находятся в другом каталоге. Проверьте путь /var/log/sberbank/ и используйте команду ls -l для подтверждения наличия файлов. Ошибка Permission denied при создании архива Недостаточно прав пользователя. Запустите команду от имени root или добавьте пользователя в группу logreaders. Скачивание через веб‑интерфейс «зависает» Большой объём данных, ограничение браузера. Разделите период на несколько частей (по дням) и скачайте несколько небольших архивов. API возвращает 429 Too Many Requests Превышен лимит запросов. Внедрите экспоненциальную задержку и повторные попытки; обратитесь к менеджеру API за увеличением квоты.
Безопасность при работе с логами
- Шифрование. Всегда шифруйте архив перед передачей (GPG, OpenSSL).
- Контроль доступа. Храните логи в защищённых директориях с правами
600 (только владелец). - Аудит. Ведите журнал всех операций выгрузки: кто, когда, какой период.
- Стирание временных файлов. После отправки удалите оригинальный архив и временные списки (
rm -f /tmp/log_list.txt). - Соблюдение регулятивных требований. При работе с персональными данными учитывайте ФЗ‑152 и GDPR.
Часто задаваемые вопросы
Можно ли выгрузить логи за более чем 30 дней?
Да, если в системе включена периодическая архивация (см. руководство АС Сбербанк Бизнес Руководство администратора). Архивы старше 30 дней хранятся в отдельном хранилище /var/archive/sberbank/.
Какие форматы поддерживает Сбербанк при выгрузке?
Стандартный формат – ZIP. При использовании API можно запросить tar.gz (параметр format=tar.gz).
Нужно ли отключать терминал перед выгрузкой?
Не обязательно. Логи собираются «на лету», но если система сильно нагружена, рекомендуется выполнить выгрузку в часы низкой нагрузки (например, 02:00–04:00).
Как узнать, какие именно логи требуются техподдержке?
Обычно оператор указывает диапазон времени и типы файлов (например, guard_*.log). Если указаний нет – выгрузите все логи за указанный период.
Что делать, если архив не открывается?
Проверьте целостность с помощью zip -T archive.zip. Если ошибка «Corrupt archive», повторите процесс выгрузки, убедившись, что сеть не прерывается.
Выгрузка архива логов Сбербанка – важный процесс, который помогает быстро решать технические проблемы и соблюдать нормативные требования. Следуя описанным выше шагам (через терминал, веб‑интерфейс или API), вы сможете собрать нужные данные, обеспечить их безопасность и передать оператору технической поддержки без лишних задержек.
Помните: всегда проверяйте целостность архива, шифруйте файл перед передачей и сохраняйте журнал всех действий.