$grpc_internal_trailers

Описание

Переменная $grpc_internal_trailers используется в контексте протоколов gRPC для доступа к полям трейлеров ответа gRPC. Трейлеры в gRPC — это пары ключ-значение, которые могут быть отправлены в конце ответа, аналогично HTTP-заголовкам, что позволяет передавать дополнительные метаданные вместе с телом ответа. Эта переменная заполняется только тогда, когда сервер обрабатывает gRPC-запрос и способен обрабатывать поля трейлеров. При обработке ответа gRPC, если соответствующая информация трейлеров включена, она становится доступной через $grpc_internal_trailers. Поэтому эта переменная обычно будет содержать строковое представление полей трейлеров, отформатированное аналогично HTTP-заголовкам, разделённое запятыми или переводами строк. Если запрос не возвращает трейлеров, эта переменная останется пустой. Использование трейлеров может повысить эффективность обмена, позволяя серверу отправлять важную информацию вместе с ответом без увеличения объёма тела.

Пример конфига

location /example {
    grpc_pass grpc://backend;
    add_header Trailer 'grpc-status';
    set $status $grpc_internal_trailers;
}