Урок 4 из 10Диагностика

12 мин · теория и практика · Основы

Порты и upstream: куда идёт запрос

Найди слушающий процесс и проверь каждый backend отдельно.

Сможешь связать порт с процессом и локализовать нестабильный backend.

Между пользователем и приложением часто стоит nginx. Ошибка 502 может появляться на этом промежуточном слое. Если часть запросов проходит, проверь, не расходятся ли состояния нескольких backend.

Кто слушает порт

ss -lntp показывает слушающие TCP-сокеты, числовые адреса и процессы. Для сведений о чужих процессах могут потребоваться права root. Сопоставь адрес с конфигурацией upstream.

Команды
sudo ss -lntp
Пример вывода
LISTEN 0 128 127.0.0.1:8081 0.0.0.0:* users:(("python",pid=842,fd=3))

127.0.0.1 доступен в своей сетевой среде. В контейнере это loopback самого контейнера, а не соседнего сервиса.

Обойди прокси для диагностики

Проверь каждый адрес upstream прямым запросом из той же сетевой среды, где работает прокси. Один успешный ответ от общего адреса не проверяет все backend. Повтори запросы и сравни статус с телом.

Команды
curl -sS -i --max-time 3 http://127.0.0.1:8081/health
curl -sS -i --max-time 3 http://127.0.0.1:8082/health

У приложения может быть виртуальный хост. В этом случае передай ожидаемый Host-заголовок, как в настоящем запросе.

Вернись к общему адресу

Исправь подтверждённую причину: адрес, порт, конфигурацию или состояние backend. После изменения проверь и отдельные серверы, и общий вход. Для плавающего сбоя сделай серию запросов.

Команды
for n in 1 2 3 4 5 6; do
  curl -sS --max-time 3 -o /dev/null -w "%{http_code}\n" http://localhost/
done
Пример вывода
200
502
200
502

Чередование кодов — улика, а не доказательство конкретного алгоритма балансировки. Проверь список upstream и логи.

Сопоставь сбои с конкретным backend

В кейсе «Сайт работает через раз» собери небольшой ряд запросов через nginx и отдельно к каждому backend. Разная конфигурация экземпляров может объяснить чередование 200 и 5xx. Смотри не только код, но и идентификатор экземпляра, доступный заголовок или журнал.

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

Команды
sudo nginx -T
sudo ss -lntp

Порты прямой проверки бери из upstream, а не из предположения, что все приложения слушают 8080.

От симптома к проверке

НаблюдениеСледующая проверкаКак читать результат
Connection refusedСлушающий адрес и процессПроверь, есть ли принимающий сокет на нужном порту.
Один backend: 200, другой: 5xxНастройки и логи второго экземпляраПрокси может работать, а приложение экземпляра — нет.
Оба напрямую работают, общий URL нетupstream, Host и маршрут nginxИсследуй различие общей и прямой точки входа.

Типовые ошибки

  • Проверить только localhost:80 и не сравнить upstream.
  • Навсегда удалить сломанный экземпляр из балансировки.
  • Предположить одинаковую конфигурацию по одинаковому имени процесса.

Как доказать восстановление

  1. Проверь каждый backend на его фактическом порту.
  2. Повтори ограниченную серию запросов через nginx.
  3. Убедись, что оба экземпляра участвуют в обработке.
  4. Сохрани ожидаемые ответы и конфигурацию после перезапуска.

МИНИ-ИНЦИДЕНТ

Почему один 200 скрывает поломку?

Через общий адрес приходят 200, 500, 200, 500. Оба процесса запущены, но прямые запросы различаются. Какое сравнение принесёт больше пользы, чем ещё один reload nginx?

Данные для разбора
backend A /health: 200
backend B /health: 500
nginx syntax test: successful
Разобрать ход диагностики

Сопоставь журналы и эффективную конфигурацию backend B с исправным A. Затем проверь исправление напрямую и через общий адрес. Повторный reload не меняет ошибочную настройку приложения, а отключение B не доказывает его восстановление.

ПРАКТИКУМ

Практикум: объясни данные и выбери действие

Два компонента находятся на одном узле, но используют разные порты. Сравни фактическую настройку с наблюдением.

Учебные данные
nginx upstream → 127.0.0.1:8082
ss listener     → 127.0.0.1:8081
GET :8081/health → 200
  1. Где возникло конкретное расхождение?

    Сверить рассуждение

    Прокси обращается к 8082, а подтверждённый listener находится на 8081. Пока неизвестно, какое значение должно быть по контракту: нужен источник конфигурации приложения и релиза.

  2. Почему не стоит сразу менять оба порта?

    Сверить рассуждение

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

  3. Что проверить после применения?

    Сверить рассуждение

    Фактический listener, прямой прикладной ответ и тот же внешний запрос через nginx. Все три должны согласоваться; один успешный обход ещё не подтверждает общий маршрут.

ПРОВЕРЬ СЕБЯ

Первый запрос вернул 200. Можно закрывать плавающий инцидент?

Показать объяснение

Нет. Проверь каждый backend и серию запросов через общий адрес. Один исправный экземпляр может скрывать неисправный.

Документация

Гостевой прогресс хранится отдельно в этом браузере.

ТЕПЕРЬ В КОНСОЛЬ

Закрепи на инциденте

Сначала проверь один backend в вводном кейсе. Позже вернись к балансировке с несколькими экземплярами.

ПОМОГЛО РАЗОБРАТЬСЯ?

Как тебе материал?

Оцени статью или напиши, где не хватило объяснения. Это поможет улучшить обучение.

Полезно 0 Не помогло 0

Войди, чтобы оценить статью и оставить комментарий.

Обсуждение

0

Войти в обсуждение →

Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.