Pular para conteúdo

pipelog: Módulo pipelog do NGINX

Instalação

Você pode instalar este módulo em qualquer distribuição baseada em RHEL, incluindo, mas não se limitando a:

  • RedHat Enterprise Linux 7, 8, 9 e 10
  • CentOS 7, 8, 9
  • AlmaLinux 8, 9
  • Rocky Linux 8, 9
  • Amazon Linux 2 e Amazon Linux 2023
dnf -y install https://extras.getpagespeed.com/release-latest.rpm
dnf -y install nginx-module-pipelog
yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install nginx-module-pipelog

Ative o módulo adicionando o seguinte no topo de /etc/nginx/nginx.conf:

load_module modules/ngx_http_pipelog_module.so;

Este documento descreve o nginx-module-pipelog v1.0.4 lançado em 19 de dezembro de 2022.


Este módulo permite enviar o log de acesso HTTP para um programa externo via pipe.

Diretivas

pipelog_format

pipelog_format name [escape=default|json|none] string ...
  • a sintaxe é a mesma que log_format do HttpLogModule.
  • o valor padrão é combined.

pipelog

pipelog command [format [nonblocking] [if=condition]];

pipelog off;
  • o valor padrão é off.
  • o comando não precisa do símbolo de pipe | como prefixo.

Exemplo

  pipelog_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_x_forwarded_for"';

  pipelog "cat >> /var/log/nginx/access.log" main;

GitHub

Você pode encontrar dicas adicionais de configuração e documentação para este módulo no repositório do GitHub para nginx-module-pipelog.