Appearance
Логирование: первый отлов ошибок
У Виты уже есть телефонная книга. Осталось сделать из неё программу: пользователь вводит имя, программа печатает номер. Всё работает — пока кто-нибудь не введёт имя, которого в книге нет:
py
phone_book = {'Серёга': '+7 900 123-45-67', 'Соня': '+7 911 234-56-78'}
name = 'Лена'
print(phone_book[name])
# KeyError: 'Лена'Программа упала. Для пользователя это выглядит как «всё сломалось», хотя достаточно было ответить: «нет такого номера».
Первый отлов ошибки
Конструкция try...except ловит ошибку по дороге: если в try что-то падает, программа не умирает, а переходит в except:
py
phone_book = {'Серёга': '+7 900 123-45-67', 'Соня': '+7 911 234-56-78'}
name = 'Лена'
try:
print(phone_book[name])
except KeyError:
print('нет такого друга')
# будет напечатано: нет такого другаЗаписать можно несколько except подряд — каждый на свой тип ошибки:
py
try:
number = int('abc') # ValueError
print(10 / 0) # ZeroDivisionError — до него не дойдёт
except ValueError:
print('это не число')
except ZeroDivisionError:
print('на ноль делить нельзя')Полный разбор конструкции try...except...else...finally и всех типов исключений — в уроке «Исключения в Python». Здесь важно главное: ошибку можно поймать, и программа продолжает жить.
Но ловить — не всё. Если ошибка случилась, а вы о ней не знаете — завтра она случится снова, и снова вы будете её искать. Нужен журнал.
Почему print не ведёт журнал
Починить всё print-ами не выйдет:
printвыводит на экран. Пользователь видит ваши служебные записи, а при закрытии окна всё исчезает;- у записи
printнет времени: когда это случилось — непонятно; - у записи
printнет важности: где обычное «нажали кнопку», а где «упали с ошибкой» — разглядеть в потоке нельзя; - у оконного приложения и у сервера «экрана» вообще нет.
Модуль logging
Для журналов в Python есть встроенный модуль logging:
py
import logging
logging.error('друзья не нашлись: Лена')
# ERROR:root:друзья не найдены: ЛенаЗапись уже выглядит как журнал: уровень важности и сообщение. Добавьте время и формат — basicConfig():
py
import logging
logging.basicConfig(level=logging.DEBUG, format='%(asctime)s — %(levelname)s: %(message)s')
logging.debug('программа запускается')
logging.info('пользователь ввёл: Лена')
logging.warning('имя не найдено в книге')
logging.error('поиск завершился ошибкой')2026-10-15 15:30:12,012 — DEBUG: программа запускается
2026-10-15 15:30:12,013 — INFO: пользователь ввёл: Лена
2026-10-15 15:30:12,013 — WARNING: имя не найдено в книге
2026-10-15 15:30:12,013 — ERROR: поиск завершился ошибкойПорядок в формате задают поля: %(asctime)s — время, %(levelname)s — уровень, %(message)s — сообщение.
Уровни
У каждой записи есть уровень — степень важности:
| Уровень | Когда использовать |
|---|---|
DEBUG | служебные детали: «вошли в функцию», «значение переменной» |
INFO | обычные события: «пользователь нажал кнопку», «файл сохранён» |
WARNING | нештатно, но программа справилась: «имя не найдено, показали подсказку» |
ERROR | ошибка, которую поймали: «упали при поиске, вернули сообщение об ошибке» |
CRITICAL | программа не может продолжить: «не открылась база данных» |
Аргумент level в basicConfig — порог: записи ниже не пишутся. Для разработки — DEBUG, чтобы видеть всё; для работающего приложения — INFO или WARNING, чтобы не завалить журнал служебным шумом.
Запись в файл
print и logging по умолчанию пишут в консоль. logging умеет писать в файл — одним аргументом:
py
import logging
logging.basicConfig(filename='phone_book.log', level=logging.INFO,
format='%(asctime)s — %(levelname)s: %(message)s')
logging.info('программа запускается')Всё, что ниже INFO, в файл не попадёт; сами записи — в phone_book.log рядом с проектом. Экран и файл можно вести отдельно — настраиваются «руки» логгера, но это уже углубление.
Лог-запись — это словарь
Под капотом каждая запись журнала — словарь: у неё поля message, levelname, name, asctime, module, funcName, lineno. Формат строки в basicConfig просто подставляет эти поля в шаблон. Отсюда вывод: журнал — это таблица событий, где каждое событие — строка с одинаковыми колонками. Такими же строками-записями живут и CSV-файлы — о них будет отдельный курс.
Пример: оконное приложение
Вита делает оконное приложение-телефонную книгу: окно, поле ввода, кнопка «Найти». Нажатия клавиш — события, их удобно фиксировать:
py
import logging
logging.basicConfig(level=logging.INFO,
format='%(asctime)s — %(levelname)s: %(message)s')
phone_book = {'Серёга': '+7 900 123-45-67', 'Соня': '+7 911 234-56-78'}
def handle_key(key):
logging.info('нажата клавиша: %s', key)
if key.isdigit():
logging.debug('клавиша-цифра: %s', key)
def find_phone(name):
try:
phone = phone_book[name]
logging.info('найдено: %s -> %s', name, phone)
return phone
except KeyError:
logging.warning('не найден в книге: %s', name)
return None
handle_key('5')
find_phone('Соня')
find_phone('Лена')2026-10-15 15:35:00,100 — INFO: нажата клавиша: 5
2026-10-15 15:35:00,101 — INFO: найдено: Соня -> +7 911 234-56-78
2026-10-15 15:35:00,101 — WARNING: не найден в книге: ЛенаЕсли ошибка серьёзнее — не «нет ключа», а «программа не разобралась со вводом», — пишут logging.exception(): он запишет и сообщение, и весь след падения (traceback) разом:
py
def parse_user_number(raw):
try:
return int(raw)
except ValueError:
logging.exception('не удалось разобрать номер: %s', raw)
return None
parse_user_number('abc')ERROR:root:не удалось разобрать номер: abc
Traceback (most recent call last):
File "app.py", line 3, in parse_user_number
return int(raw)
ValueError: invalid literal for int() with base 10: 'abc'Правило уровней
- пользовательское действие —
INFO; - мелкое нештатное, с которым программа справилась —
WARNING; - пойманная ошибка —
ERROR, а если нужен след —logging.exception(); - программа не может продолжить —
CRITICAL.
Правило выбора: логировать то, что вы захотите знать, отлаживая это через месяц.
Упражнения
- Программа ищет в телефонной книге номер по введённому имени. Оберните поиск в
try...except KeyErrorтак, чтобы при неизвестном имени программа не падала, а напечатала «нет такого друга».
py
phone_book = {'Серёга': '+7 900 123-45-67', 'Соня': '+7 911 234-56-78'}
name = 'Лена'
# допишите код ниже- Напишите функцию
find_phone(phone_book, name): возвращает номер, а если имени нет — возвращаетNone. В функции используйтеtry...except.
py
def find_phone(phone_book, name):
# допишите код ниже- Напечатайте одно и то же сообщение двумя способами — через
printи черезlogging.error. Сравните, что даёт запись логгера, и объясните в комментарии, зачем это нужно.
py
import logging
# допишите код ниже- Настройте
logging.basicConfigс уровнемDEBUGи форматом%(asctime)s — %(levelname)s: %(message)s. Затем зафиксируйте события запуска телефонной книги: запуск (debug), ввод имени (info), не найдено (warning), ошибка поиска (error).
py
import logging
# допишите код ниже- Сделайте то же самое, что в задании 4, но порог установите на
WARNING. Какие записи перестали печататься? Объясните в комментарии.
py
import logging
# допишите код ниже- Настройте логирование в файл
phone_book.log. Зафиксируйте три события работы программы и напечатайте путь к файлу, куда они ушли.
py
import logging
# допишите код ниже- У Виты мини-тест клавиатуры: список нажатых клавиш
keys. Для каждой клавиши: если это цифра — запишитеINFO«нажата клавиша-цифра», иначе —ERROR«неверная клавиша».
py
import logging
logging.basicConfig(level=logging.INFO)
keys = ['5', 'a', '7', 'b', '3']
# допишите код ниже- Пользователь вводит номер телефона как строку. Напишите функцию, которая возвращает его числом; если строка — не число, зафиксируйте ошибку через
logging.exception()и вернитеNone. Запустите функцию на'12345'и'12-34'.
py
import logging
logging.basicConfig(level=logging.ERROR)
def parse_phone(raw):
# допишите код ниже