NGINX Access Logs and Error Logs (Español)

Los registros son muy útiles para monitorear las actividades de cualquier aplicación, además de proporcionarle información valiosa mientras lo soluciona.

al igual que cualquier otra aplicación, NGINX también registra eventos como visitantes a su sitio, problemas encontrados y más a los archivos de registro. Esta información le permite tomar medidas preventivas en caso de que note algunas discrepancias graves en los eventos de registro.,

Este artículo lo guiará en detalles sobre cómo configurar el registro de NGINX para que tenga una mejor visión de sus actividades.

prerrequisito

• ya ha instalado NGINX siguiendo nuestro tutorial desde aquí.

Logs in NGINX

de forma predeterminada, NGINX escribe sus eventos en dos tipos de Registros: el registro de errores y el registro de acceso., En la mayoría de las distribuciones populares de Linux como Ubuntu, CentOS o Debian, tanto el acceso como el registro de errores se pueden encontrar en /var/log/nginx, suponiendo que ya haya habilitado los registros de acceso y error en el archivo de configuración de NGINX.

averigüemos más sobre el registro de acceso NGINX, el registro de errores y cómo habilitarlos si no lo ha hecho antes.

¿Qué es NGINX registro de acceso?

El NGINX registra las actividades de todos los visitantes de su sitio en los registros de acceso., Aquí puede encontrar a qué archivos se accede, cómo NGINX respondió a una solicitud, qué navegador está utilizando un cliente, la dirección IP de los clientes y más. Es posible utilizar la información del registro de acceso para analizar el tráfico para encontrar los usos de los sitios a lo largo del tiempo. Además, al monitorear los registros de acceso correctamente, uno puede averiguar si un usuario está enviando alguna solicitud inusual para encontrar fallas en la aplicación web implementada.

¿qué es NGINX error log?

por otro lado, si NGINX se enfrenta a algún problema técnico, registrará el evento en el registro de errores., Esto puede suceder si hay algún error en el archivo de configuración. Por lo tanto, si NGINX no puede iniciar o abruptamente dejó de ejecutarse, debe revisar los registros de errores para encontrar más detalles. También puede encontrar algunas advertencias en el registro de errores, pero no indica que se haya producido un problema, pero el evento puede plantear un problema grave en un futuro cercano.

¿cómo habilitar el registro de acceso NGINX?

en general, el registro de acceso se puede habilitar con la directiva access_log en http o en la sección Servidor., El primer argumento log_file es obligatorio, mientras que el segundo argumento log_format es opcional. Si no especifica ningún formato, los registros se escribirán en el formato combinado predeterminado.

access_log log_file log_format;

el registro de acceso está habilitado de forma predeterminada en el contexto http del archivo de configuración de Core NGINX. Eso significa que el registro de acceso de todo el host virtual se registrará en el mismo archivo.

http { ... ... access_log /var/log/nginx/access.log; ... ...}

siempre es mejor separar los registros de acceso de todos los hosts virtuales grabándolos en un archivo separado., Para ello, debe anular la directiva access_log que se define en la sección http con otra directiva access_log en el contexto del servidor.

recargue NGINX para aplicar la nueva configuración. Para ver los registros de acceso del dominio domain1.com en el archivo /var/log/nginx/domain1.access.log, utilice el siguiente comando tail en el terminal.

# tail -f /var/log/nginx/domain1.access.log

Aplicar formato personalizado en el registro de acceso

El formato de registro predeterminado utilizado para registrar un evento en el registro de acceso es el formato de registro combinado., Puede anular el comportamiento predeterminado creando su propio formato de registro personalizado y, a continuación, especificar el nombre del formato personalizado en la directiva access_log.

el siguiente ejemplo define un formato de registro personalizado extendiendo el formato combinado predefinido con el valor de la relación de compresión gzip de la respuesta. El formato se aplica indicando el formato de registro con la directiva access_log.

una vez que haya aplicado el formato de registro anterior en su entorno, vuelva a cargar NGINX. Ahora siga el registro de acceso para encontrar la relación gzip al final del evento de registro.,

¿cómo habilitar el registro de errores de NGINX?

la directiva error_log configura el registro de errores en file o stderr, o syslog especificando el nivel mínimo de gravedad de los mensajes de error que se registrarán. La sintaxis de la directiva error_log es:

error_log log_file log_level;

el primer argumento log_file define la ruta del archivo de registro y el segundo argumento log_level define el nivel de gravedad del evento de registro a grabar. Si no especifica el log_level, de forma predeterminada, solo se registran los eventos de registro con un nivel de gravedad de error.,

por ejemplo, el siguiente ejemplo establece el nivel de gravedad de los mensajes de error que se registrarán en crit. Además, la directiva error_log en el contexto http implica que el registro de errores para todo el host virtual estará disponible en un solo archivo.

http { ... error_log /var/log/nginx/error_log crit; ...}

también es posible registrar los registros de errores de todo el host virtual por separado anulando la directiva error_log en el contexto del servidor. El siguiente ejemplo lo hace exactamente sobreescribiendo la directiva error_log en el contexto del servidor.,

todos los ejemplos descritos anteriormente registran los eventos de registro en un archivo. También puede configurar la directiva error_log para enviar los eventos de registro a un servidor syslog. La siguiente directiva error_log envía los registros de errores al servidor syslog con una dirección IP de 192.168.10.11 en formato de depuración.

error_log syslog:server=192.168.10.11 debug;

en alguna situación, es posible que desee desactivar el registro de errores. Para ello, establezca el nombre del archivo de registro en /dev/null.,

error_log /dev/null;

Nginx Error Log Severity Levels

hay muchos tipos de niveles de registro que están asociados con un evento de registro y con una prioridad diferente. Todos los niveles de registro se enumeran a continuación. En los siguientes niveles de registro, debug tiene la máxima prioridad e incluye el resto de los niveles también. Por ejemplo, si especifica error como nivel de registro, también capturará los eventos de registro etiquetados como crit, alert y emergency.

1. emerg: mensajes de emergencia cuando su sistema puede ser inestable.
2. alerta: mensajes de alerta de problemas graves.,
3. crit: problemas críticos que necesitan ser atendidos inmediatamente.error: se ha producido un error. Algo salió mal mientras procesaba una página.
4. warn: un mensaje de advertencia que debe investigar.
5. Aviso: un aviso de registro simple que puede ignorar.
6. info: solo un mensaje de información que usted podría querer saber.
7. debug: información de depuración utilizada para identificar la ubicación del error.,

resumen

los registros de acceso y error en NGINX no solo mantendrán una pestaña sobre la actividad de los usuarios, sino que también ahorrarán tiempo y esfuerzo en el proceso de depuración. Además, también puede personalizar el registro de acceso si necesita más información a su disposición. Siempre es mejor habilitar los registros de acceso y errores porque estos dos archivos contienen todas las pistas para un mejor mantenimiento del Servidor NGINX.