El Nuevo El paquete en Go 1.21 aporta el logging estructurado a la biblioteca estándar. Los logs estructurados utilizan pares de valores clave para que puedan ser analizados, filtrados, buscados y analizados de forma rápida y fiable. Para los servidores, el logging es una forma importante para que los desarrolladores observen el comportamiento detallado del sistema, y a menudo el primer lugar para debugarlo. Los logs, por lo tanto, tienden a ser voluminosos, y la capacidad de buscar y filtrarlos rápidamente es esencial. log/slog La biblioteca estándar tenía un paquete de logging, , desde el lanzamiento inicial de Go hace más de una década. A lo largo del tiempo, hemos aprendido que el logging estructurado es importante para los programadores de Go. Se ha clasificado constantemente en alto en nuestra encuesta anual, y muchos paquetes en el ecosistema de Go lo proporcionan. Algunos de estos son bastante populares: uno de los primeros paquetes de logging estructurado para Go, , se utiliza en más de 100.000 otros paquetes. log logros Con muchos paquetes de registro estructurados para elegir, los grandes programas a menudo terminan incluyendo más de uno a través de sus dependencias.El programa principal puede tener que configurar cada uno de estos paquetes de registro para que la salida de registro sea consistente: todo va al mismo lugar, en el mismo formato.Al incluir registro estructurado en la biblioteca estándar, podemos proporcionar un marco común que todos los otros paquetes de registro estructurado pueden compartir. Una gira de slog Estallido Este es el programa más sencillo que : slog package main

import "log/slog"

func main() {
    slog.Info("hello, world")
}
 A partir de este texto, se imprime: 2023/08/04 16:09:19 INFO hello, world
 El La función imprime un mensaje en el nivel de registro de información usando el logger predeterminado, que en este caso es el logger predeterminado de la paquete – el mismo logger que obtienes cuando escribes Eso explica por qué la salida se ve tan parecida: sólo el "INFO" es nuevo. Y el original Los paquetes trabajan juntos para que sea fácil comenzar. Info log log.Printf slog log Además , hay funciones para otros tres niveles - , de , y Además de una más general función que toma el nivel como un argumento. , los niveles son sólo números enteros, por lo que no está limitado a los cuatro niveles nombrados. Es cero y es 4, por lo que si su sistema de registro tiene un nivel entre ellos, puede usar 2 para ello. Info Debug Warn Error Log slog Info Warn A diferencia de la En el paquete, podemos agregar fácilmente pares de valores clave a nuestra salida escribiéndolos después del mensaje: log slog.Info("hello, world", "user", os.Getenv("USER"))
 El resultado ahora se ve así: 2023/08/04 16:27:19 INFO hello, world user=jba
 Como hemos mencionado, Las funciones de nivel superior utilizan el logger predeterminado.Podemos obtener este logger explícitamente, y llamar sus métodos: slog logger := slog.Default()
logger.Info("hello, world", "user", os.Getenv("USER"))
 Cada función de nivel superior corresponde a un método en La salida es la misma que antes. slog.Logger Inicialmente, la salida de slog pasa por el estándar , produciendo la salida que hemos visto anteriormente.Podemos cambiar la salida cambiando la utilizados por el logaritmo. Dispone de dos manejadores integrados. a Emite toda la información de registro en el formulario Este programa crea un nuevo logger utilizando un Y hace el mismo llamado a la El método: log.Logger Trabaja slog TextHandler key=value TextHandler Info logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Ahora la salida se ve así: time=2023-08-04T16:56:03.786-04:00 level=INFO msg="hello, world" user=jba
 Todo se ha convertido en un par de valores clave, con cuerdas citadas según sea necesario para preservar la estructura. Para la salida de JSON, instale el En lugar de: JSONHandler logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Ahora nuestra salida es una secuencia de objetos JSON, uno por llamada de registro: {"time":"2023-08-04T16:58:02.939245411-04:00","level":"INFO","msg":"hello, world","user":"jba"}
 Usted no está limitado a los manejadores incorporados. Cualquiera puede escribir un manejador implementando el Un manipulador puede generar salida en un formato particular, o puede envolver a otro manipulador para agregar funcionalidad. En la La documentación muestra cómo escribir un manipulador de envasado que cambia el nivel mínimo en el que se mostrarán los mensajes de registro. slog.Handler Ejemplos slog La sintaxis de valor clave alternante para los atributos que hemos utilizado hasta ahora es conveniente, pero para las declaraciones de registro que se ejecutan con frecuencia puede ser más eficiente usar el Tipo y llame Estos trabajan juntos para minimizar las asignaciones de memoria. de cuerdas, números y otros tipos comunes. Attr LogAttrs Attr Esta llamada a produce la misma salida que arriba, pero lo hace más rápido: LogAttrs slog.LogAttrs(context.Background(), slog.LevelInfo, "hello, world",
    slog.String("user", os.Getenv("USER")))
 Hay mucho más para : slog 
 
 
 
 
 Como muestra la llamada a LogAttrs, puede pasar un contexto.Contexto a algunas funciones de registro para que un manipulador pueda extraer información de contexto como identificadores de rastro. (Cancelar el contexto no impide que se escriba la entrada de registro.) Puede llamar a Logger.With para agregar atributos a un logger que aparecerá en toda su salida, calculando eficazmente las partes comunes de varias declaraciones de log. Esto no solo es conveniente, sino que también puede ayudar al rendimiento, como se discute a continuación. Esto puede agregar más estructura a su salida de log y puede ayudar a desambiguar las claves que de otro modo serían idénticas. Puede controlar cómo aparece un valor en los registros proporcionando su tipo con un método LogValue. que puede usarse para registrar los campos de una estructura como un grupo o editar datos sensibles, entre otras cosas. El mejor lugar para aprender de todos Es el . slog Documentación del paquete El desempeño Queríamos para obtener ganancias de rendimiento a gran escala, hemos diseñado interfaz para proporcionar oportunidades de optimización. El método se llama al comienzo de cada evento de registro, dándole al manipulador la oportunidad de descargar rápidamente los eventos de registro no deseados. y Los métodos permiten al manipulador formatar atributos añadidos por una vez, en lugar de cada llamada de registro.Esta pre-formatación puede proporcionar una aceleración significativa cuando los atributos grandes, como un Se añade a y luego utilizado en muchas llamadas de logging. slog El Handler Enabled WithAttrs WithGroup Logger.With http.Request Logger Para informar nuestro trabajo de optimización del rendimiento, investigamos patrones típicos de logging en proyectos de código abierto existentes. encontramos que más del 95% de las llamadas a métodos de logging pasan cinco o menos atributos. Luego escribimos los índices de referencia que capturaron los casos comunes, y los usamos como una guía para ver dónde pasó el tiempo. El proceso de diseño El El paquete es una de las mayores adiciones a la biblioteca estándar desde que Go 1 fue lanzado en 2012.Queríamos dedicar nuestro tiempo a diseñarlo, y sabíamos que el feedback de la comunidad sería esencial. slog Para abril de 2022, habíamos recopilado suficientes datos para demostrar la importancia del registro estructurado para la comunidad de Go. El equipo de Go decidió explorar agregarlo a la biblioteca estándar. Comenzamos mirando cómo se diseñaron los paquetes de registro estructurados existentes.También aprovechamos la gran colección de código Go de código abierto almacenado en el proxy del módulo Go para aprender cómo estos paquetes se utilizaban realmente.Nuestro primer diseño fue informado por esta investigación, así como por el espíritu de simplicidad de Go. Queríamos una API que sea ligera en la página y fácil de entender, sin sacrificar el rendimiento. Nunca ha sido un objetivo reemplazar los paquetes de registro existentes de terceros. Todos ellos son buenos en lo que hacen, y reemplazar el código existente que funciona bien rara vez es un buen uso del tiempo de un desarrollador. , que llama una interfaz de backend, De esta manera, los paquetes de registro existentes pueden hablar con un backend común, por lo que los paquetes que los utilizan pueden interactuar sin tener que ser reescritos. , de y . Logger Handler Zap de logr hclog Compartimos nuestro diseño inicial dentro del equipo de Go y otros desarrolladores que tenían una amplia experiencia en el logging. Hicimos modificaciones basadas en su feedback, y en agosto de 2022 sentimos que teníamos un diseño viable. público y comenzó a para escuchar lo que la comunidad tenía que decir.La respuesta fue entusiasta y en gran medida positiva.Gracias a los comentarios perspicaces de los diseñadores y usuarios de otros paquetes de logging estructurado, hicimos varios cambios y añadimos algunas características, como grupos y el Hemos cambiado el mapeo de los niveles de registro a los integers dos veces. Implementación experimental Discusión de GitHub LogValuer Después de dos meses y unos 300 comentarios, sentimos que estábamos listos para una realidad. y acompañado El tema de la propuesta obtuvo más de 800 comentarios y resultó en muchas mejoras en la API y la implementación. : Propuesta Diseño Doc context.Context 
 
 
 Originalmente, la API soportaba la adición de loggers a un contexto.Muchos pensaron que esto era una forma conveniente de conducir un logger fácilmente a través de niveles de código que no le importaban.Pero otros pensaron que estaba contrayendo en una dependencia implícita, haciendo que el código fuera más difícil de entender. Inicialmente nos opusimos al patrón estándar de pasar el contexto como el primer argumento porque no queríamos que cada llamada de registro requeriera un contexto, pero finalmente creamos dos conjuntos de métodos de registro, uno con un contexto y uno sin. Uno de los cambios que no nos preocupamos es la sintaxis alternante de clave y valor para expresar atributos: slog.Info("message", "k1", v1, "k2", v2)
 Muchos sentían fuertemente que esta era una mala idea. encontraron que era difícil de leer y fácil de equivocarse omitiendo una clave o valor. slog.Info("message", slog.Int("k1", v1), slog.String("k2", v2))
 Pero pensamos que la sintaxis más ligera era importante para mantener Go fácil y divertido de usar, especialmente para los nuevos programadores de Go. , de y (Con su ) usó con éxito claves y valores alternativos. agregamos un para capturar errores comunes, pero no cambió el diseño. logr go-kit/log zap SugaredLogger Conoce el Check El 15 de marzo de 2023, la propuesta fue aceptada, pero todavía había algunos problemas menores no resueltos. En las próximas semanas, se propusieron y resolvieron diez cambios adicionales. El proyecto fue completado, junto con la paquete para la verificación de los manipuladores y el control veterinario para el uso correcto de las claves y valores alternativos. log/slog testing/slogtest Y el 8 de agosto, Go 1.21 fue lanzado, y Esperamos que lo encuentres útil, y tan divertido de usar como era de construir. slog Y un gran agradecimiento a todos los que participaron en la discusión y el proceso de propuesta. Inmensamente muy slog Recursos El Para el El paquete explica cómo usarlo y proporciona varios ejemplos. Documentación log/slog El tiene recursos adicionales proporcionados por la comunidad de Go, incluyendo una variedad de manejadores. Página wiki Si desea escribir un manipulador, consulte el . Escribe el guía por Jonathan Amsterdam Fotografía de Jeff Smith en Unsplash Jeff Smith Unosplash Este artículo está disponible en The Go Blog bajo una licencia CC BY 4.0 DEED. El blog de Go El blog de Go

Try and Download Go 

Read My Stories

Este audio es producido en el idioma original de la historia!

Demasiado Largo; Para Leer

Make resilience your competitive advantage

Un Tour de Slog: Todo lo que necesita saber sobre el logging estructurado con Slog

About Author

COMENTARIOS

ETIQUETAS

ESTE ARTÍCULO FUE PRESENTADO EN

Related Stories

La fuga rápida del sistema Claude Sonnet 3.5: un análisis forense

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

El modelo Bitcoin UTXO, impulsando un ecosistema único

Cómo mejorar su flujo de trabajo 10 veces: 17 aplicaciones esenciales

La fuga rápida del sistema Claude Sonnet 3.5: un análisis forense

¿Quieres ganar un concurso de redacción de HackerNoon? Esto es lo que recomiendan los ganadores del concurso #crypto-api

El modelo Bitcoin UTXO, impulsando un ecosistema único

Cómo mejorar su flujo de trabajo 10 veces: 17 aplicaciones esenciales

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps