O novo O pacote no Go 1.21 traz logging estruturado para a biblioteca padrão. Os logs estruturados usam pares de valores-chave para que eles possam ser analisados, filtrados, pesquisados e analisados de forma rápida e confiável. Para servidores, o logging é uma maneira importante para os desenvolvedores observarem o comportamento detalhado do sistema, e muitas vezes o primeiro lugar que eles vão para debugá-lo. log/slog A biblioteca padrão tinha um pacote de logging, , desde o lançamento inicial do Go há mais de uma década. Ao longo do tempo, aprendemos que o logging estruturado é importante para os programadores do Go. Ele está consistentemente classificado como alto em nossa pesquisa anual, e muitos pacotes no ecossistema do Go o fornecem. , é usado em mais de 100.000 outros pacotes. log Sucesso Com muitos pacotes de registo estruturado para escolher, grandes programas muitas vezes acabam incluindo mais de um através de suas dependências. O programa principal pode ter que configurar cada um desses pacotes de registo para que a saída de registo seja consistente: tudo vai para o mesmo lugar, no mesmo formato. Ao incluir registo estruturado na biblioteca padrão, podemos fornecer um quadro comum que todos os outros pacotes de registo estruturado podem compartilhar. Uma turnê de Sábio Sábio Aqui está o programa mais simples que você usa : slog package main

import "log/slog"

func main() {
    slog.Info("hello, world")
}
 A partir deste texto, ele imprime: 2023/08/04 16:09:19 INFO hello, world
 O A função imprime uma mensagem no nível Info log usando o logger padrão, que neste caso é o logger padrão do pacote – o mesmo logger que você recebe quando você escreve Isso explica por que a saída parece tão semelhante: apenas o “INFO” é novo. E o original O pacote trabalha em conjunto para facilitar o início. Info log log.Printf slog log Além , existem funções para outros três níveis - , em e Além de um mais geral função que leva o nível como um argumento. , os níveis são apenas inteiros, então você não está limitado aos quatro níveis nomeados. É zero e é 4, por isso, se o seu sistema de registo tem um nível entre eles, você pode usar 2 para ele. Info Debug Warn Error Log slog Info Warn Ao contrário da Pacote, podemos facilmente adicionar pares de valores-chave à nossa saída escrevendo-os após a mensagem: log slog.Info("hello, world", "user", os.Getenv("USER"))
 A saída agora parece assim: 2023/08/04 16:27:19 INFO hello, world user=jba
 Como já mencionamos, As funções de nível superior usam o logger padrão. Podemos obter este logger explicitamente, e chamar seus métodos: slog logger := slog.Default()
logger.Info("hello, world", "user", os.Getenv("USER"))
 Cada função de nível superior corresponde a um método em A saída é a mesma que antes. slog.Logger Inicialmente, a saída do slog passa pelo padrão , produzindo a saída que vimos acima. Podemos alterar a saída alterando o usados pelo logger. Vem com dois controladores embutidos. a Emite todas as informações de log no formulário Este programa cria um novo logger usando um Faça o mesmo apelo ao O Método: log.Logger Trata slog TextHandler key=value TextHandler Info logger := slog.New(slog.NewTextHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Agora a saída parece assim: time=2023-08-04T16:56:03.786-04:00 level=INFO msg="hello, world" user=jba
 Tudo foi transformado em um par de valores-chave, com cadeias citadas conforme necessário para preservar a estrutura. Para a saída JSON, instale o built-in Em vez disso: JSONHandler logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("hello, world", "user", os.Getenv("USER"))
 Agora nossa saída é uma sequência de objetos JSON, um por chamada de logging: {"time":"2023-08-04T16:58:02.939245411-04:00","level":"INFO","msg":"hello, world","user":"jba"}
 Você não está limitado aos manipuladores embutidos. Qualquer um pode escrever um manipulador implementando o Um manipulador pode gerar saída em um formato específico, ou ele pode envolver outro manipulador para adicionar funcionalidade. Em O A documentação mostra como escrever um manipulador de embrulho que altera o nível mínimo em que as mensagens de log serão exibidas. slog.Handler Exemplos slog A sintaxe alternada de valor-chave para atributos que usamos até agora é conveniente, mas para declarações de registo executadas com frequência pode ser mais eficiente usar o Tipo e Chame o Estes trabalham em conjunto para minimizar as alocações de memória. s fora de cordas, números e outros tipos comuns. Attr LogAttrs Attr Este chamado para produz a mesma saída como acima, mas o faz mais rápido: LogAttrs slog.LogAttrs(context.Background(), slog.LevelInfo, "hello, world",
    slog.String("user", os.Getenv("USER")))
 Há muito mais para : slog 
 
 
 
 
 Como a chamada para LogAttrs mostra, você pode passar um contexto.Contexto para algumas funções de log para que um manipulador possa extrair informações de contexto, como IDs de rastreamento. (Cancelar o contexto não impede que a entrada de log seja escrita.) Você pode chamar Logger.With para adicionar atributos a um logger que aparecerá em toda a sua saída, efetivamente calculando as partes comuns de várias declarações de log. Isto não é apenas conveniente, mas também pode ajudar o desempenho, como discutido abaixo. Isso pode adicionar mais estrutura à sua saída de log e pode ajudar a desambiguar chaves que de outra forma seriam idênticas. Você pode controlar como um valor aparece nos logs fornecendo seu tipo com um método LogValue. que pode ser usado para registrar os campos de um struct como um grupo ou editar dados sensíveis, entre outras coisas. O melhor lugar para aprender sobre tudo É o . slog Pacote de Documentação Desempenho Queríamos Para grandes ganhos de desempenho, projetamos interfaces para proporcionar oportunidades de otimização. O método é chamado no início de cada evento de log, dando ao manipulador uma chance de baixar eventos de log indesejados rapidamente. e Os métodos permitem que o gestor formate atributos adicionados por Esta pré-formatação pode fornecer uma aceleração significativa quando grandes atributos, como um são adicionados a e depois usado em muitas chamadas de logging. slog O Handler Enabled WithAttrs WithGroup Logger.With http.Request Logger Para informar nosso trabalho de otimização de desempenho, investigamos padrões típicos de logging em projetos de código aberto existentes. Descobrimos que mais de 95% das chamadas para métodos de logging passam cinco ou menos atributos. Em seguida, escrevemos benchmarks que capturaram os casos comuns, e os usamos como um guia para ver onde o tempo foi. O processo de design O O pacote é uma das maiores adições à biblioteca padrão desde que o Go 1 foi lançado em 2012. slog Até abril de 2022, tínhamos coletado dados suficientes para demonstrar a importância do logging estruturado para a comunidade Go. Começamos olhando para como os pacotes de logging estruturados existentes foram projetados.Também aproveitamos a grande coleção de código Go de código aberto armazenado no proxy do módulo Go para aprender como esses pacotes eram realmente usados.Nosso primeiro design foi informado por esta pesquisa, bem como o espírito de simplicidade do Go. Queríamos uma API que seja leve na página e fácil de entender, sem sacrificar o desempenho. Nunca foi um objetivo substituir os pacotes de registo de terceiros existentes. Todos eles são bons no que fazem, e substituir o código existente que funciona bem raramente é um bom uso do tempo de um desenvolvedor. Isso é chamado de backend interface. Desta forma, os pacotes de logging existentes podem falar com um backend comum, de modo que os pacotes que os usam possam interagir sem ter que ser reescritos. , em e . Logger Handler Zap logr hclog Nós compartilhamos nosso projeto inicial dentro da equipe Go e outros desenvolvedores que tinham uma vasta experiência de logging. fizemos alterações com base em seu feedback, e em agosto de 2022 sentimos que tínhamos um design viável. público e começou a para ouvir o que a comunidade tinha a dizer.A resposta foi entusiasmada e em grande parte positiva.Graças aos comentários insights dos designers e usuários de outros pacotes de logging estruturado, fizemos várias mudanças e adicionamos alguns recursos, como grupos e o Nós mudamos o mapeamento de níveis de log para inteiros duas vezes. Implementação Experimental Discussão GitHub LogValuer Depois de dois meses e cerca de 300 comentários, sentimos que estávamos prontos para uma real e acompanhar O item da proposta recebeu mais de 800 comentários e resultou em muitas melhorias na API e na implementação. : Proposta Desenho Doc context.Context 
 
 
 Inicialmente, a API suportou a adição de loggers a um contexto.Muitos acharam que esta era uma maneira conveniente de conduzir um logger facilmente através de níveis de código que não se importavam com isso.Mas outros acharam que era contrabandear em uma dependência implícita, tornando o código mais difícil de entender. Também lutamos com a questão relacionada de passar um contexto para métodos de logging, tentando um número de projetos. inicialmente resistimos ao padrão padrão de passar o contexto como o primeiro argumento porque não queríamos que cada chamada de logging exigisse um contexto, mas eventualmente criamos dois conjuntos de métodos de logging, um com um contexto e um sem. Uma mudança que não preocupamos com a sintaxe alternada de chave e valor para expressar atributos: slog.Info("message", "k1", v1, "k2", v2)
 Muitos sentiram fortemente que esta era uma má idéia. Eles acharam difícil de ler e fácil de errar omitindo uma chave ou valor. Eles preferiram atributos explícitos para expressar estrutura: slog.Info("message", slog.Int("k1", v1), slog.String("k2", v2))
 Mas sentimos que a sintaxe mais leve era importante para manter o Go fácil e divertido de usar, especialmente para novos programadores do Go. , em e (com a sua ) usou com sucesso chaves alternativas e valores. adicionamos um para pegar erros comuns, mas não mudou o design. logr go-kit/log zap SugaredLogger Conheça o Check Em 15 de março de 2023, a proposta foi aceita, mas ainda havia alguns problemas menores não resolvidos. Nas próximas semanas, dez alterações adicionais foram propostas e resolvidas. O pacote foi concluído, juntamente com a pacote para verificação de manipuladores e o controle veterinário para o uso correto de chaves e valores alternativos. log/slog testing/slogtest E em 8 de agosto, o Go 1.21 foi lançado, e Esperamos que você o encontre útil, e tão divertido de usar como era para construir. slog E um grande obrigado a todos que participaram da discussão e do processo de proposta. suas contribuições melhoraram imensuravelmente slog Recursos O Para o O pacote explica como usá-lo e fornece vários exemplos. Documentação log/slog O tem recursos adicionais fornecidos pela comunidade Go, incluindo uma variedade de gestores. Página do Wiki Se você quiser escrever um manipulador, consulte o . Escrever um guia por Jonathan Amsterdam Imagem de Jeff Smith em Unsplash Jeff Smith Unsplash Este artigo está disponível no The Go Blog sob uma licença CC BY 4.0 DEED. O blog do Go O blog do Go

Try and Download Go 

Read My Stories

Este áudio é produzido no idioma original da história!

A Tour of Slog: Tudo o que você precisa saber sobre logging estruturado com Slog

About Author

COMENTARIOS

Rótulos

ESTE ARTIGO FOI APRESENTADO EM

Related Stories

O guia completo para uma migração bem-sucedida para a nuvem: estratégias e práticas recomendadas

Modelo Bitcoin UTXO, alimentando um ecossistema único

Vazamento do prompt do sistema Claude Sonnet 3.5: uma análise forense

De fóruns a feeds: como os algoritmos de mídia social moldam a interação digital

O guia completo para uma migração bem-sucedida para a nuvem: estratégias e práticas recomendadas

Modelo Bitcoin UTXO, alimentando um ecossistema único

Vazamento do prompt do sistema Claude Sonnet 3.5: uma análise forense

De fóruns a feeds: como os algoritmos de mídia social moldam a interação digital

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps