Blog / Standard Library

Attrs

May 5, 2026

We’ve been talking about key/value pairs. The log/slog package has a name for these: Attr (short for “attribute”). And there’s more than one way to build an attribute:

Attrs and Values

An Attr is a key-value pair. The Logger output methods accept Attrs as well as alternating keys and values. The statement

slog.Info("hello", slog.Int("count", 3))

behaves the same as

slog.Info("hello", "count", 3)

There are convenience constructors for Attr such as Int, String, and Bool for common types, as well as the function Any for constructing Attrs of any type.

You might wonder why there are two ways to do this. I know I do!

I can guess, though: Allowing both convenience, and precision.

Passing raw key/value pairs is generally more convenient:

slog.Info("request served", "url", req.URL.String(), "method", req.Method, ...)

But it’s also error-prone. Particularly with long lists of attributes, it’s easy to miss either a key or a value, which can trigger all sorts of strange behavior!

There may also be times when you want to pass around attributes, and that’s often easier as discrete slog.Attr values than as a slice of key/value pairs.

And finally, there may be a marginal performance gain by using one of the type-specific attribute constructors, since it avoids a type assertion at runtime—not a concern most of us will ever need to worry about, of course.

So should you prever key/value pairs ("key", value), or the explicit attribute constructors (slog.Int("key", value)). Your call. I generally prefer the explicit constructors, because it’s more explicit, and less error prone—particularly if the log ever grows more key/value pairs over time. But: I would never hold up a code review because somebody else chose the other format instead!

Share this

Direct to your inbox, daily. I respect your privacy .

Unsure? Browse the archive .

Related Content

slog.Group

The one Attr constructor not yet covered: func Group func Group(key string, args ...any) Attr Group returns an Attr for a Group Value. The first argument is the key; the remaining arguments are converted to Attrs as in Logger.Log. Use Group to collect several key-value pairs under a single key on a log line, or as the result of LogValue in order to log a single value as multiple Attrs.

The Attr type

Other than logger methods, the slog.Attr type is probably the thing you’ll use the most in your use of the slog package: Types type Attr type Attr struct { Key string Value Value } An Attr is a key-value pair. This type has several type-specific constructors, too, but we’re going to do an abbrevaited look at them, because they’re highly repetitive. func Any func Any(key string, value any) Attr Any returns an Attr for the supplied value.

Backward compatibility

We’ve already discussed when the default log/slog Logger also serves as the default log Logger. But what if you want to send log logs to a log/slog Logger, without using the global defaults? Introducing NewLogLogger! func NewLogLogger func NewLogLogger(h Handler, level Level) *log.Logger NewLogLogger returns a new log.Logger such that each call to its Output method dispatches a Record to the specified handler. The logger acts as a bridge from the older log API to newer structured logging handlers.

Get daily content like this in your inbox!

Subscribe