Как правильно передать и обработать X-Request-ID?

Question

[Nujabes37]

Здравствуйте! В общем искал на просторах интернета информацию по тому как правильно передавать и обработать requestId на сервере. И к моему удивлению не нашел нормального примера, если тут есть те кто этим занимался, просветите меня в следующих вопросах.
1. Как правильно генерировать и передавать requestId через заголовок на сервер ?
2. Как правильно регистрировать переданный requestId. Имеется ввиду, его надо обрабатывать на PHP и где-то хранить или же это все должен делать сервер ( в моем случае nginx) ?
Если я неправильно понял саму суть requestId, тогда можете и в этом просветить)) Спасибо.

Answer 1

[Lynn «Кофеман»]

Смысл requestId в том, что бы оседлать в различных логах для дальнейшего анализа работы приложения.

Обычно он создаётся как можно раньше, если мы говорим про nginx, то там уже есть (начиная с 1.11.0) переменная $request_id, которую нужно а) писать в лог nginx и б) передавать дальше в PHP (с помощью fastcgi_param). Так же можно отдавать её в http-заголовке клиенту.

Дальше, по хорошему, ваше PHP-приложение во всех своих логах тоже должно сохранять это значение, а так же передавать во все другие сервисы с которыми оно общается (базы данных, другие http-сервера и т.п.).

Comments

[Nujabes37]

Тогда такой вопрос, допусти мы записали $requestId в логах nginx. Но ведь при повторном запросе клиента будет генерироваться новый id-шник, правильно? Или же запросы от одного клиента будут приходить с одним requestId ?
Просто не могу понять как реализовать идемпотентный POST запрос, передавая с ним requestId.

[Lynn «Кофеман»]

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

Answer 2

[FanatPHP]

Я не занимался, но прочел ответ на стаковерфлое

Генерировать уникально. UUID подойдет.
Передавать наверное через квери стринг - тогда этот ид попадет в лог веб-сервера, на случай, если пхп совсем уж упадет еще до запуска обработчика ошибок. Ну, или если такая точность не особо критична, то просто дополнительным полем в джейсон.
Плюс в обработчике ошибок РНР учитывать это значение и добавлять к сообщению об ошибке, записанному в лог.