В мире разработки программного обеспечения важное значение имеет способность быстро и эффективно выявлять ошибки, анализировать поведение приложений и отслеживать сетевую активность. Особенную роль в этом процессе играют инструменты для логирования и мониторинга, которые позволяют разработчикам получать подробные данные как клиентской, так и серверной части приложения. Среди такого рода решений особого внимания заслуживает Local Lens – уникальный инструмент, предназначенный для локального мониторинга логов и сетевых запросов, который обеспечивает глубокий аналитический обзор и интеграцию с современными AI-инструментами. Local Lens предлагает широкие возможности по сбору, структурированию и анализу логов из браузера и сервера, что значительно облегчает процесс отладки и диагностики проблем. Local Lens позиционируется как 100% локальное решение, которое не требует подключения к облачным сервисам и полностью работает на машине разработчика.
Это важный аспект, так как гарантируется сохранность данных и безопасность, отсутствует риск утечки конфиденциальной информации, что особенно актуально для проектов с повышенными требованиями к безопасности. Все данные сохраняются локально в базе SQLite и доступны для мгновенного просмотра, поиска и фильтрации, а также для передачи в системы на базе технологии Model Context Protocol (MCP), таких как Claude или Cursor, для дальнейшего AI-анализа. Основная составляющая Local Lens – это два взаимодополняющих пакета: серверный пакет local-lens, который реализует HTTP и MCP сервер, а также CLI-пакет local-lens-cli, предназначенный для захвата серверных логов. Первый отвечает за прием, хранение и выдачу данных, а второй позволяет упаковать любой серверный процесс в обертку «capture», благодаря чему его stdout и stderr становятся частью общей системы логирования. Такая архитектура делает Local Lens универсальным для любого бэкенда: будь то Ruby on Rails, Express.
js, Django или FastAPI. Отсутствие необходимости в специальной настройке в коде приложения выгодно отличает его от многих аналогичных систем. Сторонний компонент Local Lens – это Chrome-расширение, которое работает с браузерной частью и перехватывает консольные логи, а также сетевые запросы. Расширение оборудовано интеллектуальными фильтрами, чтобы исключать лишние данные, например, посвященные аналитике или загрузке ресурсов, и захватывать лишь значимые с точки зрения отладки запросы и логи. Оно позволяет настроить домены, с которых идет сбор данных, включая автоматическое покрытие поддоменов, что удобно для мониторинга нескольких сервисов внутри одного проекта.
Захват сетевых запросов реализован путем перехвата функций fetch и XMLHttpRequest, что обеспечивает детальный просмотр каждого запроса с полным набором данных: HTTP метод, URL, заголовки, тело запроса и ответа, статусы и время выполнения. Особое внимание уделяется различным форматам данных ответов: JSON, HTML, XML, JavaScript, с автоматическим разбором и форматированием для улучшения читаемости и анализа. Размеры захватываемых ответов ограничены 50 килобайтами, чтобы избежать чрезмерного потребления памяти, при этом сохраняется уведомление о возможном усечении. Для серверных логов CLI-инструмент Local Lens служит оберткой, которая запускает нужный серверный процесс и перехватывает его выводы. Все логи автоматически форматируются в структурированный JSON с подробным описанием источника, уровня важности, метаданных и временных меток.
Такое строгое форматирование облегчает последующий поиск и анализ, а также позволяет интегрировать их с MCP-сервером Local Lens. Сигналы завершения и перезапуска процессов корректно обрабатываются, что не нарушает работу и гарантирует надежность. Local Lens предоставляет продвинутые HTTP API, с помощью которых можно получать логи и сетевые запросы, выполнять их поиск и фильтрацию по различным параметрам: уровню важности, URL, времени, статусам HTTP-ответов и другим. Реализовано также потоковое вещание через Server-Sent Events, что позволяет в реальном времени отслеживать состояние и активно реагировать на проблемы. Управление настройками и фильтрами доступно через API также, что делает систему гибкой и настраиваемой без необходимости перезапуска.
Одной из ключевых особенностей Local Lens является интеграция с MCP – Model Context Protocol. Этот протокол обеспечивает доступ AI-инструментам к локально сохраненным логам и данным, что открывает новые горизонты для автоматизированного анализа, поиска корневых причин ошибок и оптимизации приложений. Возможность передавать логи напрямую в AI позволит ускорить процесс отладки, делать качественные выводы и повышать продуктивность разработчиков. Благодаря этому Local Lens становится не просто инструментом сбора данных, а полноценной платформой для AI-поддерживаемой разработки. Важным нюансом в Local Lens является его ориентация на локальное развитие и безопасность.
В отличие от облачных сервисов, здесь полностью отсутствует передача данных по сети. Все операции происходят на локальной машине, а сервер слушает фиксированный порт 27497, доступный только локально, что исключает внешнее вмешательство. Вся информация хранится надежно в SQLite-базе с ограничением по количеству записей (около 10 000) с автоматической очисткой старых данных – это обеспечивает баланс между объемом сохраненной информации и потреблением ресурсов. Отдельного внимания заслуживает удобство использования: установка Local Lens не вызывает сложностей и сводится к нескольким командам npm. Сервер запускается в режиме разработки с автообновлением, расширение легко устанавливается в Chrome с помощью режима разработчика, а CLI-инструмент предоставляет удобные обертки для любых серверных команд.
Интерфейс расширения интуитивно понятен, позволяет быстро добавлять и удалять домены для слежения, управлять включением и отключением мониторинга консольных логов и сетевых запросов. Local Lens активно развивается сообщество вокруг проекта, он распространяется под лицензией MIT, что обеспечивает открытость и возможность внесения собственных улучшений. Кодовая база написана на TypeScript, что повышает надежность и удобство поддержки проекта. Встроенная система тестирования с использованием Jest гарантирует качество и стабильность функционирования. Для разработчиков, которые стремятся создать надежные и хорошо мониторимые решения, Local Lens предоставляет мощный и функциональный инструмент, который позволяет получать полную картину состояния приложения как на клиентской, так и на серверной стороне.
