Provision
—— XP

Практика: поиск по журналам

практика~25 минут+500 XP

Строки собираются в Loki с прошлой практики. Теперь ты научишься их находить. Для этого в стенде появится второй источник — фальшивое приложение, которое каждую секунду пишет строку в JSON, как настоящий веб-сервис: метод, адрес, код ответа. Тысячи разных строк — и писать для этого ничего не придётся.

Запросы набираются в Grafana, в разделе Explore с выбранным источником Loki. Окно времени справа вверху поставь «Last 15 minutes».

Шаг 1. Фальшивое приложение

Программа flog генерирует правдоподобные строки журналов: в формате nginx, syslog или JSON. Её часто используют, чтобы проверить сборщик без настоящего трафика. Допиши службу в ~/infra/logs/compose.yaml, в раздел services.

~/infra/logs/compose.yaml, добавить в services
  fakeapp:
    image: mingrammer/flog:0.4.3
    command: -f json -l -d 1s

Флаги flog: -f json — формат строк, -l — писать бесконечно, -d 1s — по строке в секунду. Подними службу; флаг -d у Compose возвращает терминал сразу.

ubuntu@stand:~$
cd ~/infra/logs
docker compose up -d fakeapp
 ✔ Container logs-fakeapp-1  Started

Шаг 2. Alloy заметил новый контейнер

Alloy опрашивает Docker раз в несколько десятков секунд, поэтому новый контейнер появляется в Loki не сразу. Подожди минуту и спроси список. Флаг -s у curl убирает полоску загрузки.

ubuntu@stand:~$
curl -s localhost:3100/loki/api/v1/label/container/values
{"status":"success","data":["logs-alloy-1","logs-fakeapp-1",
"logs-loki-1","logs-web-1","monitoring-grafana-1"]}

logs-fakeapp-1 в списке — строки пошли. Конфиг Alloy при этом не менялся: новый контейнер попал в сбор сам.

Шаг 3. Запросы к nginx

Сделай пару обращений к nginx: одно к главной странице и одно к несуществующей. Флаг -o /dev/null выбрасывает тело ответа.

ubuntu@stand:~$
curl -s -o /dev/null localhost:8085/
curl -s -o /dev/null localhost:8085/nope

Повтори вторую команду ещё пару раз стрелкой вверх — так строк с ошибкой будет больше.

Шаг 4. Все строки одного контейнера

В Explore набери селектор и нажми Run query:

LogQL
{container="logs-web-1"}
результат
172.23.0.1 - - [01/Oct/2026:17:57:39 +0000] "GET /nope HTTP/1.1" 404 153 ...
2026/10/01 17:57:39 [error] open() "/usr/share/nginx/html/nope" failed ...
172.23.0.1 - - [01/Oct/2026:17:57:39 +0000] "GET / HTTP/1.1" 200 896 ...

Здесь строки двух видов: журнал доступа — по строке на запрос, с кодом ответа, — и журнал ошибок nginx, со словом [error]. Над списком Grafana рисует столбики: сколько строк пришло в каждый момент.

Шаг 5. Только ответы 404

Добавь фильтр по тексту. Пробелы вокруг числа нужны, чтобы не поймать 404 внутри размера ответа.

LogQL
{container="logs-web-1"} |= " 404 "

Остались только строки с кодом 404 — по одной на каждый твой запрос к /nope.

Шаг 6. Выбросить шум

Теперь обратная задача: всё, кроме ошибок про /nope. Знак != выбрасывает строки с подстрокой.

LogQL
{container="logs-web-1"} != "nope"

Остались строки про главную страницу. Так в жизни убирают проверки живости, которые иначе забивают журнал балансировщика.

Шаг 7. Ошибки сервера в JSON

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

LogQL
{container="logs-fakeapp-1"} | json | status >= 500
результат
{"host":"163.242.183.135", "method": "HEAD", "request": "/mission-critical/one-to-one/enable",
 "protocol":"HTTP/1.1", "status":503, "bytes":14601, ...}

Раскрой любую строку щелчком — Grafana покажет поля, которые достал | json: method, status, request и остальные. Запиши этот запрос, он понадобится для отчёта.

Шаг 8. График по методам

Теперь не читать, а считать. Набери запрос подсчёта:

LogQL
sum by (method) (
  count_over_time({container="logs-fakeapp-1"} | json [1m])
)

Вместо строк Grafana нарисует график — по линии на каждый метод: GET, POST, PUT, DELETE и другие. Каждая точка — сколько строк с этим методом пришло за минуту до неё. Окна соседних точек перекрываются, поэтому точки не складывают: одна строка попадает в несколько окон. Это та же картинка, что в мониторинге, только посчитанная по журналу.

Шаг 9. Одно число: ошибки за минуту

Убери раскладку по методам и оставь условие на код ответа:

LogQL
sum(count_over_time({container="logs-fakeapp-1"} | json | status >= 500 [1m]))

Получится одна линия около 15–20: примерно столько ошибок сервера за минуту пишет flog. Запиши число — оно пойдёт в отчёт.

Шаг 10. Удалить контейнер

Теперь главное, ради чего журналы собирают отдельно. Удали nginx вместе с его журналом. Флаг -s сначала останавливает контейнер, -f не спрашивает подтверждения.

ubuntu@stand:~$
docker compose rm -sf web
 ✔ Container logs-web-1  Removed

Попробуй посмотреть журнал обычным способом:

ubuntu@stand:~$
docker compose logs web
$

Пусто: журнал удалён вместе с контейнером.

Шаг 11. Журнал в Loki на месте

Вернись в Explore и повтори запрос из шага 5: {container="logs-web-1"} |= " 404 ".

Строки на месте. Контейнера больше нет, а его история хранится в Loki, в его собственном томе, и пролежит там тридцать дней — срок, который мы задали флагом -store.retention=720h в прошлой практике. Удали том Loki командой docker compose down -v — и пропадёт уже всё, поэтому -v на стенде журналов не набирают. Ночью упавший и пересозданный контейнер утром всё расскажет.

Шаг 12. Вернуть nginx и записать отчёт

Подними nginx обратно: на нём держатся запросы из этой практики, и стенд журналов должен остаться целым.

ubuntu@stand:~$
docker compose up -d web
 ✔ Container logs-web-1  Started

Запиши в ~/devops-lab/reports/logs.txt три строки: запрос из шага 7, число ошибок за минуту из шага 9 и одной фразой — что показал шаг 11.

~/devops-lab/reports/logs.txt, пример
запрос: {container="logs-fakeapp-1"} | json | status >= 500
ошибок 5xx в минуту: около 17
после docker compose rm журнал web остался в Loki

Стенд журналов — такое же описание, как стенд мониторинга, и его место в репозитории. Паролей в нём нет, поэтому добавляем каталог целиком.

ubuntu@stand:~$
git -C ~/infra add logs
ubuntu@stand:~$
git -C ~/infra commit -m "logs: loki, alloy и flog"

Если что-то пошло не так

Explore пишет No data — проверь окно времени справа вверху: строки старше выбранного окна не показываются. Если пусто и при окне в час — сравни метку в запросе со списком из шага 2, опечатка в имени контейнера даёт ровно такой результат.

Ошибка parse error — чаще всего прямые кавычки заменились на «ёлочки» при копировании или пропущена фигурная скобка. Ошибка queries require at least one regexp or equality matcher значит, что в селекторе нет ни одной метки со значением.

Что дальше

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

Практика 02+500 XP

Отвечать на вопрос «что случилось» запросом в Loki: метки, фильтр по тексту, разбор полей и подсчёт.

  • Фальшивое приложение пишет в Loki
  • Запросы к несуществующей странице найдены
  • web возвращён
  • Отчёт записан
Команда сдачи — выполни на своей машине
команда
cd ~/infra/logs 2>/dev/null || echo NOLOGS; curl -s localhost:3100/loki/api/v1/label/container/values; echo; echo NOPE=$(curl -s -G localhost:3100/loki/api/v1/query_range --data-urlencode 'query={container="logs-web-1"} |= "GET /nope"' --data-urlencode since=168h | grep -o 'GET /nope' | grep -c nope); echo WEB=$(docker compose ps --format '{{.Service}}' | grep -c '^web$'); echo ---; cat ~/devops-lab/reports/logs.txt

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.