Консоль на Mac: сузьте журнал до одной попытки VPN

VPN не срабатывает, кто-то говорит проверить Консоль, и вы открываете окно, которое изливает тысячи строк в секунду. Большая часть из них не имеет отношения к туннелю. Полезный навык — сузить вид до одной попытки и одного процесса, прежде чем что-либо читать.

Трёх шагов достаточно для большинства разбирательств с VPN на Mac.

Сделайте одну попытку, которую сможете узнать

Запишите местное время и часовой пояс, затем подключитесь один раз. Запишите точный текст ошибки, которую показал клиент, потому что она обычно конкретнее любой строки журнала. Теперь у вас есть окно в несколько секунд и поисковый запрос. Всё, что было до этого окна, — история, которая вам не нужна.

Попытка, которой нельзя поставить метку времени, — это попытка, которую нельзя отфильтровать.

Сначала фильтруйте по процессу, потом по тексту

Поле поиска Консоли принимает предикаты процесса и сообщения, а эквивалент в командной строке воспроизводится легче. log show --last 5m --predicate 'process == "NEIKEv2Provider"' сужает до одного поставщика. Точное имя процесса зависит от типа подключения, поэтому найдите его во время первой нефильтрованной попытки.

Если сначала фильтровать по тексту, вернутся все подсистемы, которые случайно записали слово VPN.

Предикат может фильтровать и по подсистеме и категории, что часто точнее имени процесса. Единое журналирование позволяет библиотеке объявить подсистему, и сетевые компоненты Apple используют несколько из них. Начните с процесса, затем добавьте --info, если уровень по умолчанию скрывает ожидаемое событие. Сообщения уровня отладки обычно требуют профиля конфигурации, который не стоит устанавливать только ради чтения одного журнала.

Читайте последовательность, а не последнюю строку

Последнее сообщение об отключении — самая неинформативная строка в файле. Ищите раньше первую ошибку адаптера, сбой проверки или отказ конфигурации. Они называют этап, который не сработал, тогда как отключение лишь говорит, что этап не был восстановлен. Сохраняйте порядок событий при копировании, потому что последовательность и есть диагноз.

Запуск локальной службы — не успешное удалённое рукопожатие, и журнал не будет делать вид, что это не так.

Что скрывает редактирование и почему

Единое журналирование по умолчанию скрывает некоторые значения за приватным маркером, поэтому полезное поле может выглядеть пустым. Это проектное решение о том, что можно собирать, а не ошибка. Не переключайте широкие настройки конфиденциальности только для того, чтобы получить больше текста.

Если нужное значение скрыто, ищите его в собственном журнале или конфигурации приложения.

Экспортируйте просмотренный фрагмент

Экспортируйте только то окно, которое просмотрели. Пути, имена пользователей, внутренние имена хостов и адреса конечных точек появляются в обычных строках журнала, и экспорт всей системы уносит их все тому, кто его получит.

Сохраняйте и нетронутую запись, и фрагмент. Если кто-то позже оспорит хронологию, решить это сможет только оригинал. Фрагмент — для заявки, а оригинал — для спора.

Назовите этап явно в заявке: адаптер, проверка или маршрутизация. Это сохраняет доказательства интерпретируемыми, а не превращает их в набор, который никто не может прочитать. Руководство пользователя Консоли от Apple описывает упомянутые здесь средства сбора и поиска.