SLS time-processing plugins - parse and standardize log timestamps - Simple Log Service

Analice, extraiga y estandarice las marcas de tiempo de los registros mediante plugins de procesamiento de tiempo nativos o de extensión.

Ejemplo del efecto del plugin

Comparación de datos de registro sin procesar en SLS con y sin el plugin de análisis de tiempo (nativo).

Registro sin procesar	Sin plugin	Plugin de análisis de tiempo (nativo)
Marca de tiempo con precisión de segundos: `{ "level":"INFO", "timestamp":"2025-09-29T09:56:01+0800", "cluster":"yilu-cluster-0728", "message":"User logged in successfully", "userId":"user-123" }`	Content: "{"level":"INFO","timestamp":"2025-09-29T09:56:01+0800","cluster":"yilu-cluster-0728","message":"User logged in successfully","userId":"user-123"}"
Marca de tiempo con precisión de milisegundos: `{ "time": "2026-01-05T11:58:40,647Z", "filename": "out_data.py", "levelname": "INFO", "threadName": "MainThread" }`	Content: "{"time":"2026-01-05T11:58:40,647Z", "filename":"out_data.py","levelname": "INFO", "threadName":"MainThread"}"
Marca de tiempo con precisión de nanosegundos: `{ "time": "2026-01-05T11:40:22,298837465Z07:00", "filename": "out_data.py", "levelname": "INFO", "threadName": "MainThread" }`	Content: "{"time": "2026-01-05T11:40:22,298837465Z07:00","filename":"out_data.py","levelname":"INFO","threadName": "MainThread"}"

Plugins de procesamiento de tiempo

SLS proporciona los siguientes plugins de procesamiento de tiempo.

Nombre	Tipo	Descripción
time parsing	native	Analiza y estandariza el campo de tiempo en los registros.
extract log time	extension	Analiza el campo de tiempo sin procesar y lo establece como la marca de tiempo del registro.

Punto de entrada

Para usar un plugin de Logtail en el procesamiento de registros, agréguelo al crear o modificar una configuración de Logtail. Para obtener más información, consulte Overview.

Diferencias entre plugins nativos y de extensión

Plugins nativos: Implementados en C++ para ofrecer un mayor rendimiento.

Plugins de extensión: Implementados en Go para proporcionar un ecosistema más amplio y flexible. Utilice plugins de extensión cuando los plugins nativos no puedan manejar su formato de registro.

Límites de rendimiento de los plugins de extensión
- Los plugins de extensión consumen más recursos (principalmente CPU). Ajuste los parámetros de LoongCollector en configuration management si es necesario.
- Si los datos sin procesar superan los 5 MB/s, evite combinaciones complejas de plugins. Use un plugin de extensión simple y delegue el procesamiento adicional a Data Transformation.
Límites de recolección de registros
- Los plugins de extensión procesan registros de texto en modo de línea. Esto significa que los metadatos a nivel de archivo, como __tag__:__path__ y __topic__, se almacenan en cada entrada de registro.
- Agregar un plugin de extensión afecta las funciones relacionadas con etiquetas:
  - La consulta de contexto y LiveTail dejan de estar disponibles a menos que agregue una configuración de aggregators.
  - El campo __topic__ se renombra a __log_topic__. Al agregar la configuración de aggregators, el registro contiene tanto los campos __topic__ como __log_topic__. Si no necesita el campo __log_topic__, puede usar drop field plugin para eliminarlo.
  - Campos como __tag__:__path__ pierden su índice de campo nativo. Debe create an index para ellos.

Plugin de análisis de tiempo (nativo)

Analiza el campo de tiempo en un registro y asigna el resultado al campo __time__.

Configuración

Parámetro	Descripción
Original Field	El campo que contiene el contenido del registro a analizar. Valor predeterminado: content. Nota Al usar el plugin de análisis regex, establezca el campo de origen en time e incluya time como un campo extraído en su configuración de regex.
Time Format	El formato de la marca de tiempo en el registro. Por ejemplo, si la marca de tiempo es 10/Sep/2023:12:36:49, el formato de tiempo correspondiente es %d/%b/%Y:%H:%M:%S.
Time Zone	La zona horaria de la marca de tiempo en el registro. Si se deja vacío, el plugin usa la zona horaria de la máquina donde se ejecuta Logtail.

De forma predeterminada, Simple Log Service procesa las marcas de tiempo con precisión de segundos. Solo necesita configurar el formato de tiempo hasta los segundos y puede omitir unidades menores como milisegundos o microsegundos. Para conservar la precisión de milisegundos, microsegundos o nanosegundos, habilite la precisión de nanosegundos como se muestra a continuación. Log collection that supports nanosecond timestamps.

Registro sin procesar

Configuración del plugin de análisis de tiempo

Formato de tiempo

{
  "time": "2026-01-05T11:40:22,298837465Z07:00",
  "filename": "out_data.py",
  "levelname": "INFO",
  "threadName": "MainThread"
}

En el cuadro de diálogo de configuración de Processing Plugin, establezca Processing Plugin Type en Time Parsing, configure Source Field como time, defina Time Format en %Y-%m-%dT%H:%M:%S,%f y seleccione Time Zone como Machine Time Zone.

%Y-%m-%dT%H:%M:%S,%f

Para habilitar la precisión de nanosegundos:

En la página de configuración de Logtail, vaya a Global Configurations > Other Global Configurations, habilite Advanced Parameters e introduzca:

{
  "EnableTimestampNanosecond": true
}

Habilite también EnableTimestampNanosecond cuando utilice plugins de extensión para analizar marcas de tiempo con precisión de nanosegundos o milisegundos.

Plugin extractor de tiempo de registro

Use processor_gotime o processor_strptime para analizar el campo de tiempo en registros sin procesar.

Nota

Para conservar la precisión inferior a un segundo, consulte Log collection that supports nanosecond timestamps.

Formato de tiempo Go (`processor_gotime`)

El plugin processor_gotime analiza campos de tiempo mediante el formato de tiempo de Go y puede establecer el resultado como la hora del registro en SLS.

Importante

Logtail 0.16.28 y versiones posteriores admiten el plugin processor_gotime.
Configuración basada en formularios: Disponible cuando recolecta registros de texto y salida estándar de contenedores.
Configuración JSON: No disponible cuando recolecta registros de texto.

Configuración mediante formulario

Parámetros

Establezca Processor Type en Extract Log Time (Go Time Format).

Parámetros:

Parámetro	Descripción
Original Time Field	El nombre del campo que contiene el tiempo a analizar.
Original Time Format	La cadena de formato de tiempo de Go para el campo de origen.
Original Time Zone	La zona horaria del tiempo de origen. Si selecciona System Time Zone, Logtail usa la zona horaria de su host o contenedor.
New Time Field	El nombre del campo para almacenar el tiempo analizado y formateado. No puede establecer este parámetro en `__time__`.
New Time Format	La cadena de formato de tiempo de Go para el campo de destino.
Custom New Time Zone	La zona horaria para el campo de tiempo de destino. Si selecciona System Time Zone, Logtail usa la zona horaria de su host o contenedor.
Advanced parameters > Use as Log Time	Especifica si se debe usar el tiempo analizado como la hora del registro.
Advanced parameters > Retain Original Field	Especifica si se debe conservar el campo de origen en el registro procesado.
Advanced parameters > Report error when source field is missing	Especifica si se debe notificar un error cuando falta el campo de origen en el registro sin procesar.
Advanced parameters > Report error on extraction failure	Especifica si se debe notificar un error cuando falla la extracción de tiempo.

Ejemplo
Analiza el campo s_key en formato 2006-01-02 15:04:05 (UTC+8), lo convierte a 2006/01/02 15:04:05 (UTC+9), almacena el resultado en d_key y lo establece como la hora del registro.
- Registro sin procesar
```
"s_key":"2022-07-05 19:28:01"
```
- Configuración del plugin de Logtail
  
  Configure el procesador Extract Log Time (Go Time Format) con los siguientes parámetros:
  - Source Time Field: s_key
  - Source Time Format: 2006-01-02 15:04:05
  - Source Time Zone: GMT+08:00
  - Destination Time Field: d_key
  - Destination Time Format: 2006/01/02 15:04:05
  - Custom Destination Time Zone: GMT+09:00
  - Parámetros avanzados: Seleccione Set as Log Time, Keep Source Field, Error on Missing Source Field y Error on Extraction Failure.
- Resultado
```
"s_key":"2022-07-05 19:28:01"
"d_key":"2022/07/05 20:28:01"
```

Configuración JSON

Parámetros

Establezca type en processor_gotime. Parámetros en el objeto detail:

Parámetro	Tipo	Obligatorio	Descripción
SourceKey	String	Sí	El nombre del campo que contiene el tiempo a analizar.
SourceFormat	String	Sí	La cadena de formato de tiempo de Go para el campo de origen.
SourceLocation	Int	Sí	El desplazamiento UTC en horas para la zona horaria de origen. Por ejemplo, use 8 para UTC+8. Si deja este parámetro vacío, Logtail usa la zona horaria de su host o contenedor.
DestKey	String	Sí	El nombre del campo para almacenar el tiempo analizado y formateado. No puede establecer este parámetro en `__time__`.
DestFormat	String	Sí	La cadena de formato de tiempo de Go para el campo de destino.
DestLocation	Int	No	El desplazamiento UTC en horas para la zona horaria de destino. Si deja este parámetro vacío, Logtail usa la zona horaria de su host o contenedor.
SetTime	Boolean	No	Especifica si se debe usar el tiempo analizado como la hora del registro. `true` (predeterminado): Usa el tiempo analizado como la hora del registro. `false`: No usa el tiempo analizado como la hora del registro.
KeepSource	Boolean	No	Especifica si se debe conservar el campo de origen en el registro procesado. `true` (predeterminado): Conserva el campo de origen. `false`: Descarta el campo de origen.
NoKeyError	Boolean	No	Especifica si se debe notificar un error cuando falta el campo de origen en el registro sin procesar. `true` (predeterminado): Notifica un error. `false`: No notifica un error.
AlarmIfFail	Boolean	No	Especifica si se debe notificar un error cuando falla la extracción de tiempo. `true` (predeterminado): Notifica un error. `false`: No notifica un error.

Ejemplo

Analiza el campo s_key en formato 2006-01-02 15:04:05 (UTC+8), lo convierte a 2006/01/02 15:04:05 (UTC+9), almacena el resultado en d_key y lo establece como la hora del registro.

Registro sin procesar
```
"s_key":"2019-07-05 19:28:01"
```

Configuración del plugin de Logtail

{
  "processors":[
    {
      "type":"processor_gotime",
      "detail": {
        "SourceKey": "s_key",
        "SourceFormat":"2006-01-02 15:04:05",
        "SourceLocation":8,
        "DestKey":"d_key",
        "DestFormat":"2006/01/02 15:04:05",
        "DestLocation":9,
        "SetTime": true,
        "KeepSource": true,
        "NoKeyError": true,
        "AlarmIfFail": true
      }
    }
  ]
}

Resultado

"s_key":"2019-07-05 19:28:01"
"d_key":"2019/07/05 20:28:01"

Formato de tiempo Strptime (`processor_strptime`)

El plugin processor_strptime analiza campos de tiempo mediante el formato strptime de Linux y puede establecer el resultado como la hora del registro.

Importante

El plugin processor_strptime está disponible en Logtail 0.16.28 y versiones posteriores.

Formulario

Parámetros

Establezca processor type en Extract Log Time (strptime Time Format).

Parámetro	Descripción
Original Field	El nombre del campo de origen.
Original Time Format	El formato del tiempo de origen.
Retain Original Field	Conserva el campo de origen en el registro procesado.
Report Extraction Failure Error	Genera una alarma si falla la extracción de tiempo.
Use Time Offset	Permite establecer un desplazamiento de tiempo personalizado en segundos.
Time Offset (Unit: Seconds)	El desplazamiento de tiempo en segundos. Por ejemplo, 28800 indica UTC+8 y -3600 indica UTC-1.

Ejemplo de configuración
Analiza un tiempo en formato %Y/%m/%d %H:%M:%S del campo log_time y lo establece como la hora del registro. Asume que la zona horaria del host es UTC+8.
- Registro sin procesar
```
"log_time":"2016/01/02 12:59:59"
```
- Configuración del plugin de Logtail
  
  Establezca Extract High-precision Time en High-precision Time Field Name, configure High-precision Time Field Name como log_time y defina Time Unit en %Y/%m/%d %H:%M:%S. En los parámetros avanzados, seleccione Processing Plugin Type y Extract Log Time (strptime Time Format), active Source Field, establezca Source Time Format en 0 y haga clic en Keep Source Field.
- Resultado del procesamiento
```
"log_time":"2016/01/02 12:59:59"
Log.Time = 1451710799
```

Expresiones de tiempo comunes

Nota

El plugin processor_strptime admite el especificador de formato %f, que representa la parte fraccionaria de un segundo con precisión de hasta nanosegundos.

Ejemplo	Expresión de tiempo
2016/01/02 12:59:59	%Y/%m/%d %H:%M:%S
2016/01/02 12:59:59.1	%Y/%m/%d %H:%M:%S.%f
2016/01/02 12:59:59.987654321 +0700 (UTC)	%Y/%m/%d %H:%M:%S.%f %z (%Z)
2016/Jan/02 12:59:59,123456	%Y/%b/%d %H:%M:%S,%f
2019-07-15T04:16:47.123Z	%Y-%m-%dT%H:%M:%S.%f

JSON

Parámetros

Establezca type en processor_strptime. Parámetros en el objeto detail:

Parámetro	Tipo	Obligatorio	Descripción
SourceKey	String	Sí	El nombre del campo de origen.
Format	String	Sí	El formato del tiempo de origen.
AdjustUTCOffset	Boolean	No	Especifica si se debe ajustar la zona horaria. true: Ajusta la zona horaria. false (predeterminado): No ajusta la zona horaria.
UTCOffset	Int	No	El desplazamiento de zona horaria en segundos. Esta configuración solo aplica cuando AdjustUTCOffset es true.
AlarmIfFail	Boolean	No	Especifica si se debe generar una alarma cuando el plugin no logra extraer la hora del registro. true (predeterminado): Genera una alarma. false: No genera una alarma.
KeepSource	Boolean	No	Especifica si se debe conservar el campo de origen en el registro procesado. true (predeterminado): Conserva el campo de origen. false: Descarta el campo de origen.

Ejemplos

Analiza un tiempo en formato %Y/%m/%d %H:%M:%S del campo log_time y lo establece como la hora del registro. Logtail usa la zona horaria de la máquina host.

Ejemplo 1: Asuma que la zona horaria es UTC+8.

Registro sin procesar
```
"log_time":"2016/01/02 12:59:59"
```

Configuración del plugin de Logtail

{
  "processors":[
    {
      "type":"processor_strptime",
      "detail": {
        "SourceKey": "log_time",
        "Format": "%Y/%m/%d %H:%M:%S"
      }
    }
  ]
}

Resultado del procesamiento

"log_time":"2016/01/02 12:59:59"
Log.Time = 1451710799

Ejemplo 2: Asuma que la zona horaria es UTC+7.

Registro sin procesar
```
"log_time":"2016/01/02 12:59:59"
```

Configuración del plugin de Logtail

{
  "processors":[
    {
      "type":"processor_strptime",
      "detail": {
        "SourceKey": "log_time",
        "Format": "%Y/%m/%d %H:%M:%S",
        "AdjustUTCOffset": true,
        "UTCOffset": 25200
      }
    }
  ]
}

Resultado del procesamiento

"log_time":"2016/01/02 12:59:59"
Log.Time = 1451714399

Ejemplo 3: Asuma que la zona horaria es UTC+7.

Registro sin procesar
```
"log_time":"2016/01/02 12:59:59.123"
```

Configuración del plugin de Logtail

{
  "processors":[
    {
      "type":"processor_strptime",
      "detail": {
        "SourceKey": "log_time",
        "Format": "%Y/%m/%d %H:%M:%S.%f"
      }
    }
  ]
}

Resultado del procesamiento

"log_time":"2016/01/02 12:59:59.123"
Log.Time = 1451714399

Expresiones de tiempo comunes

Nota

El plugin processor_strptime admite el especificador de formato %f, que representa la parte fraccionaria de un segundo con precisión de hasta nanosegundos.

Ejemplo	Expresión de tiempo
2016/01/02 12:59:59	%Y/%m/%d %H:%M:%S
2016/01/02 12:59:59.1	%Y/%m/%d %H:%M:%S.%f
2016/01/02 12:59:59.987654321 +0700 (UTC)	%Y/%m/%d %H:%M:%S.%f %z (%Z)
2016/Jan/02 12:59:59,123456	%Y/%b/%d %H:%M:%S,%f
2019-07-15T04:16:47.123Z	%Y-%m-%dT%H:%M:%S.%f

Formatos de tiempo de registros

Para los formatos de tiempo de processor_gotime, consulte Constantes en el paquete de tiempo de Go. El plugin nativo processor_parse_timestamp_native y el plugin de extensión processor_strptime admiten los formatos que se enumeran a continuación.

Nota

En un servidor Linux, Logtail admite todos los formatos de tiempo proporcionados por la función strftime.

Formato	Descripción	Ejemplo
%a	Nombre abreviado del día de la semana.	Fri
%A	Nombre completo del día de la semana.	Friday
%b	Nombre abreviado del mes.	Jan
%B	Nombre completo del mes.	January
%d	Día del mes como número decimal con relleno de ceros (01-31).	07, 31
%f	Segundos fraccionarios, como milisegundos, microsegundos o nanosegundos.	123
%h	Nombre abreviado del mes. Equivalente a %b.	Jan
%H	Hora (formato de 24 horas) como número decimal con relleno de ceros (00-23).	22
%I	Hora (formato de 12 horas) como número decimal con relleno de ceros (01-12).	11
%m	Mes como número decimal con relleno de ceros (01-12).	08
%M	Minuto como número decimal con relleno de ceros (00-59).	59
%n	Un salto de línea.	salto de línea
%p	AM o PM.	AM, PM
%r	Hora en formato de 12 horas. Equivalente a %I:%M:%S %p.	11:59:59 AM
%R	Hora y minuto en formato de 24 horas. Equivalente a %H:%M.	23:59
%S	Segundo como número decimal con relleno de ceros (00-59).	59
%t	Un carácter de tabulación.	Ninguna
%y	Año sin siglo como número decimal con relleno de ceros (00-99).	04, 98
%Y	Año con siglo como número decimal.	2004, 1998
%C	Siglo como número decimal (00-99).	16
%e	Día del mes como número decimal con relleno de espacios (1-31).	7, 31
%j	Día del año como número decimal con relleno de ceros (001-366).	365
%u	Día de la semana como número decimal, donde el lunes es 1 (1-7).	2
%U	Número de semana del año, con el domingo como primer día de la semana (00-53).	23
%V	Número de semana del año según ISO 8601, con el lunes como primer día de la semana (01-53). La semana 1 es la primera semana del año que contiene como mínimo cuatro días.	24
%w	Día de la semana como número decimal, donde el domingo es 0 (0-6).	5
%W	Número de semana del año, con el lunes como primer día de la semana (00-53).	23
%c	Representación de fecha y hora específica de la configuración regional.	Tue Nov 20 14:12:58 2020
%x	Representación de fecha específica de la configuración regional.	Tue Nov 20 2020
%X	Representación de hora específica de la configuración regional.	11:59:59
%s	Marca de tiempo Unix.	1476187251

Ejemplos

Estándares de tiempo comunes y sus expresiones correspondientes:

Ejemplo	Expresión	Estándar
2017-12-11 15:05:07	%Y-%m-%d %H:%M:%S	Personalizado
[2017-12-11 15:05:07.012]	[%Y-%m-%d %H:%M:%S.%f]	Personalizado
2017-12-11 15:05:07.123	%Y-%m-%d %H:%M:%S.%f	Personalizado
02 Jan 06 15:04 MST	%d %b %y %H:%M %Z	RFC822
02 Jan 06 15:04 -0700	%d %b %y %H:%M %z	RFC822Z
Monday, 02-Jan-06 15:04:05 MST	%A, %d-%b-%y %H:%M:%S %Z	RFC850
Mon, 02 Jan 2006 15:04:05 MST	%a, %d %b %Y %H:%M:%S %Z	RFC1123
2006-01-02T15:04:05Z07:00	%Y-%m-%dT%H:%M:%S%z	RFC3339
2006-01-02T15:04:05.999999999Z07:00	%Y-%m-%dT%H:%M:%S.%f%z	RFC3339Nano
1637843406	%s	Personalizado
1637843406123	%s	Personalizado (Simple Log Service trunca las marcas de tiempo a precisión de segundos)

Documentos relacionados

API de configuración de pipeline de Logtail:
Configuración de plugins desde la consola:
- Collect text logs from hosts
- Collect container logs from a cluster using the console (standard output/file)
Collect container logs from a cluster using Kubernetes CRDs (standard output/file)

Ejemplo del efecto del plugin

Plugins de procesamiento de tiempo

Punto de entrada

Diferencias entre plugins nativos y de extensión

Plugin de análisis de tiempo (nativo)

Configuración

Plugin extractor de tiempo de registro

Formato de tiempo Go (**processor_gotime**)

Configuración mediante formulario

Configuración JSON

Formato de tiempo Strptime (**processor_strptime**)

Formulario

JSON

Formatos de tiempo de registros

Ejemplos

Documentos relacionados

Formato de tiempo Go (`processor_gotime`)

Formato de tiempo Strptime (`processor_strptime`)