> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/es/troubleshooting/configuring-remote-log-forwarding.md).

# Configurar el reenvío remoto de registros (Syslog)

Cómo configurar VergeOS para reenviar los registros del sistema a un servidor syslog remoto para la administración centralizada de registros, el archivado y el cumplimiento.

VergeOS puede configurarse para reenviar registros a un servidor Syslog remoto, una capacidad importante para las organizaciones que aprovechan la agregación de registros para la gestión centralizada, el archivado de registros y el cumplimiento normativo.

{% hint style="success" %}
**Retención de registros**

La actividad registrada suele estar disponible dentro de la interfaz de usuario de VergeOS durante un máximo de **45 días**. Configure el reenvío remoto de registros para conservarlos durante períodos más largos.
{% endhint %}

## Requisitos previos

* Conectividad de red entre VergeOS y el servidor syslog remoto
* Reglas de firewall adecuadas para permitir el tráfico syslog (normalmente el puerto 514)
* Acceso a la configuración del sistema de VergeOS

## Pasos de configuración

Para configurar el reenvío de registros a un servidor syslog remoto:

### 1. Vaya a Configuración avanzada

Vaya a **Sistema > Configuración > Configuración avanzada**.

### 2. Configure el servidor syslog remoto

1. En el encabezado de la columna "Setting", escriba `syslog` y presione **Intro** para buscar
2. Seleccione y edite **Servidor syslog remoto (tcp: @@name/ip:port, udp: @name/ip:port)**
3. Configure este ajuste según la sintaxis esperada por su servidor remoto:

{% hint style="info" %}
**Ejemplos de configuración del servidor**

* **Para TCP:** `@@10.10.10.10:514`
* **Para UDP:** `@10.10.10.10:514`
  {% endhint %}

{% hint style="info" %}
**Elegir TCP o UDP**

* **TCP (`@@`)** proporciona entrega garantizada; úselo para registros de auditoría y cumplimiento.
* **UDP (`@`)** es de enviar y olvidar: menor sobrecarga, pero los mensajes pueden perderse bajo carga.
  {% endhint %}

{% hint style="info" %}
**Puerto del recolector**

Escuchar en el puerto 514 requiere privilegios de root en el recolector. Muchos recolectores se ejecutan sin privilegios (por ejemplo, en contenedores) y escuchan en el puerto **1514** en su lugar. Introduzca el puerto en el que escucha su recolector.
{% endhint %}

4. Haga clic **Enviar** en la parte inferior de la página para guardar

### 3. Configure la plantilla de formato

1. Busque `syslog` de nuevo en la configuración
2. Seleccione y edite **Plantilla a definir para el servidor syslog (consulte rsyslog para el formato)**
3. Introduzca un formato de plantilla syslog compatible con su servidor syslog remoto

{% hint style="info" %}
**Ejemplo de plantilla**

```plaintext
   RFC5424,"<%PRI%>1 %TIMESTAMP:::date-rfc3339% %HOSTNAME%.your-hostname-here %APP-NAME% %PROCID% %MSGID% %STRUCTURED-DATA% %msg%\n"
```

{% endhint %}

{% hint style="warning" %}
Use el literal `1` después de `<%PRI%>` — es el campo de versión RFC 5424. No use `%PROTOCOL-VERSION%`: se representa como `0` en la red, y los recolectores estrictos RFC 5424 (Promtail/Loki, Fluent Bit, Graylog moderno) rechazan la versión 0 con errores de análisis.
{% endhint %}

{% hint style="info" %}
Reemplace `your-hostname-here` por el nombre de host real, o deje `.HOSTNAME_HERE` para usar el nombre de host predeterminado del sistema.
{% endhint %}

{% hint style="info" %}
**Reenvío desde varios sistemas VergeOS**

`%HOSTNAME%` se resuelve al nombre de nodo simple (`node1`, `node2`), lo que es ambiguo cuando varios sistemas VergeOS reenvían al mismo recolector. Patrones comunes de nombre de host:

| Patrón                             | Salida de ejemplo             | Uso                                                      |
| ---------------------------------- | ----------------------------- | -------------------------------------------------------- |
| `%HOSTNAME%`                       | `node1`                       | Un solo sistema                                          |
| `mycluster-%HOSTNAME%`             | `mycluster-node1`             | Un prefijo por sistema; recomendado para varios sistemas |
| `%HOSTNAME%.mycluster.example.com` | `node1.mycluster.example.com` | Estilo FQDN                                              |
| {% endhint %}                      |                               |                                                          |

4. Haga clic **Enviar** en la parte inferior de la página para guardar el formato

## Notas del recolector

La plantilla RFC 5424 anterior funciona con recolectores comunes:

| Recolector    | Notas de configuración                                                                                        |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| Graylog       | Use un **Syslog TCP** o **Syslog UDP** entrada.                                                               |
| Loki          | Use un trabajo de Promtail `syslog` de captura; Promtail requiere RFC 5424 estricto (la literal `1` versión). |
| Splunk        | Use una entrada de datos TCP o UDP, o Splunk Connect for Syslog.                                              |
| Elasticsearch | Ingiéralo a través de Logstash con el `syslog` complemento de entrada.                                        |
| relé rsyslog  | Use un `imtcp` o `imudp` oyente.                                                                              |

## Recursos adicionales

Para obtener más información sobre plantillas syslog y opciones de formato, visite la [Documentación de Rsyslog](https://www.rsyslog.com/doc/configuration/examples.html).

## Verificación

Después de guardar la configuración, VergeOS comienza a reenviar registros al servidor especificado. Compruebe el recolector para confirmar que llegan los registros de VergeOS.

Si los registros no llegan:

1. En el host del recolector, capture el tráfico en el puerto syslog configurado para confirmar que llegan paquetes (reemplace `514` con el puerto que configuró):

   ```bash
   tcpdump -i any -A port 514
   ```
2. Inspeccione los mensajes capturados para verificar el formato en la red. Un mensaje RFC 5424 comienza con `<PRI>1` (por ejemplo, `<30>1 2026-04-15T...`); una versión de `0` significa que la plantilla todavía usa `%PROTOCOL-VERSION%` — consulte la advertencia de plantilla anterior.
3. Asegúrese de que las reglas de firewall entre VergeOS y el recolector permitan el puerto y el protocolo configurados.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/knowledge-base/es/troubleshooting/configuring-remote-log-forwarding.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
