Nginx logs via SSH
==================

Introducción 
------------

Un fichero log es un archivo que contiene todos los acontecimientos que afectan a un proceso en particular. Es un registro de eventos que contiene evidencias del comportamiento del sistema, 
el cual nos aporta información muy valiosa sobre errores, estadísticas y demás.

Conectar al servidor remoto
---------------------------

Primero, debemos establecer conexión con el servidor remoto vía SSH. Puede visitar la siguiente entrada para mas información sobre como Acceder a
ISPConfig via SSH: `crear un usuario shell <https://docs.planisys.net/ispconfig/useshel.html#crear-un-usuario-shell>`_.


Una vez conectados tenemos que ir al siguiente directorio para ver los logs. Podemos usar la siguiente imagen com ilustracion:


.. image:: log-1.png

Logs Nginx via FTP
------------------

Del mismo modo que nos conectamos al servidor remoto via ssh podemos hacerlo via ftp. Puede visitar la siguiente entrada para mas informacion sobre: `creacion de usuarios FTP <https://docs.planisys.net/ispconfig/ispconfig.html#configurar-una-cuenta-ftp>`_.

El siguiente print muestra donde se ven los archivos:

.. image:: log-2.png


En ISPConfig, los logs relacionados con Nginx suelen dividirse en dos categorías principales:

**Access Logs**: Estos registros contienen información sobre las solicitudes realizadas al servidor web, como la dirección IP del
visitante, el recurso solicitado, la fecha y hora del acceso, el navegador utilizado y más.

Ubicación típica: 

.. code-block:: bash

   /log/nginx/access.log

**Error Logs**: Los registros de error incluyen información sobre problemas o incidencias relacionadas con el funcionamiento del servidor web. Aquí encontrarás detalles sobre errores 404, problemas de permisos, configuraciones
incorrectas, entre otros.

Ubicación típica: 

.. code-block:: bash

   /log/nginx/error.log

Comandos Útiles para Gestionar Logs
-----------------------------------

Una vez que estés conectado al servidor vía SSH, puedes usar los siguientes comandos para interactuar con los logs:

Ver los últimos registros en tiempo real: 

.. code-block:: bash

   tail -f /log/nginx/access.log  

Buscar errores específicos en los logs: 

.. code-block:: bash

   grep "error" /log/nginx/error.log  

Filtrar por fecha o rango de tiempo: 

.. code-block:: bash

   grep "2024-12-01" /log/nginx/access.log  

Visualizar un archivo de log completo: 

.. code-block:: bash
 
   less /log/nginx/error.log