Skip to content

Логирование: первый отлов ошибок ​

У Виты уже есть телефонная книга. Осталось сделать из неё программу: пользователь вводит имя, программа печатает номер. Всё работает — пока кто-нибудь не введёт имя, которого в книге нет:

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.

Правило выбора: логировать то, что вы захотите знать, отлаживая это через месяц.


Упражнения ​

  1. Программа ищет в телефонной книге номер по введённому имени. Оберните поиск в try...except KeyError так, чтобы при неизвестном имени программа не падала, а напечатала «нет такого друга».
py
phone_book = {'Серёга': '+7 900 123-45-67', 'Соня': '+7 911 234-56-78'}
name = 'Лена'
# допишите код ниже
  1. Напишите функцию find_phone(phone_book, name): возвращает номер, а если имени нет — возвращает None. В функции используйте try...except.
py
def find_phone(phone_book, name):
    # допишите код ниже
  1. Напечатайте одно и то же сообщение двумя способами — через print и через logging.error. Сравните, что даёт запись логгера, и объясните в комментарии, зачем это нужно.
py
import logging
# допишите код ниже
  1. Настройте logging.basicConfig с уровнем DEBUG и форматом %(asctime)s — %(levelname)s: %(message)s. Затем зафиксируйте события запуска телефонной книги: запуск (debug), ввод имени (info), не найдено (warning), ошибка поиска (error).
py
import logging
# допишите код ниже
  1. Сделайте то же самое, что в задании 4, но порог установите на WARNING. Какие записи перестали печататься? Объясните в комментарии.
py
import logging
# допишите код ниже
  1. Настройте логирование в файл phone_book.log. Зафиксируйте три события работы программы и напечатайте путь к файлу, куда они ушли.
py
import logging
# допишите код ниже
  1. У Виты мини-тест клавиатуры: список нажатых клавиш keys. Для каждой клавиши: если это цифра — запишите INFO «нажата клавиша-цифра», иначе — ERROR «неверная клавиша».
py
import logging
logging.basicConfig(level=logging.INFO)
keys = ['5', 'a', '7', 'b', '3']
# допишите код ниже
  1. Пользователь вводит номер телефона как строку. Напишите функцию, которая возвращает его числом; если строка — не число, зафиксируйте ошибку через logging.exception() и верните None. Запустите функцию на '12345' и '12-34'.
py
import logging
logging.basicConfig(level=logging.ERROR)

def parse_phone(raw):
    # допишите код ниже