class

Logit::Event::Attributes

Inherits Reference / Object

Type-safe structured attribute storage for log events.

Attributes provide a way to attach arbitrary structured data to log events. Values are stored as JSON::Any for flexibility while maintaining type safety through the setter methods.

Setting Attributes

Use the type-specific set methods for primitive types:

attrs = Logit::Event::Attributes.new

# Primitive types
attrs.set("user.name", "alice")
attrs.set("user.age", 30_i64)
attrs.set("request.latency", 0.042)
attrs.set("user.active", true)

Use set_object and set_array for complex structures:

attrs.set_object("user", name: "alice", role: "admin")
attrs.set_array("tags", "production", "critical")

Use set_any for any JSON-serializable type:

attrs.set_any("config", my_config_object)

Getting Attributes

if value = attrs.get("user.name")
  puts value.as_s  # => "alice"
end

Constructors

new

Creates a new empty Attributes instance.

Source

Instance methods

get(key : String) : JSON::Any | Nil

Gets an attribute value, returning nil if not found or if the value is null.

Source
get?(key : String) : JSON::Any | Nil

Alias for get.

Source
set(key : String, value : String) : Nil

Sets a string attribute.

Source
set(key : String, value : Int32 | Int64) : Nil

Sets an integer attribute.

Source
set(key : String, value : Float32 | Float64) : Nil

Sets a float attribute.

Source
set(key : String, value : Bool) : Nil

Sets a boolean attribute.

Source
set(key : String, value : Nil) : Nil

Sets a nil attribute.

Source
set(key : String, value : Array(JSON::Any)) : Nil

Sets an array attribute.

Source
set(key : String, value : Hash(String, JSON::Any)) : Nil

Sets a hash attribute.

Source
set_any(key : String, value : _) : Nil

Sets an attribute from any JSON-serializable value.

Use this for custom types that implement to_json.

Source
set_array(key : String, *values) : Nil

Sets an array attribute from variadic arguments.

attrs.set_array("tags", "web", "api", "v2")
# Results in: {"tags": ["web", "api", "v2"]}
Source
set_object(key : String, **values) : Nil

Sets a nested object attribute from named arguments.

attrs.set_object("http", method: "POST", status: 200)
# Results in: {"http": {"method": "POST", "status": 200}}
Source
to_json(json : JSON::Builder) : Nil
Source
to_json
Source
values

The underlying attribute storage.

Source
values=(values : Hash(String, JSON::Any))

The underlying attribute storage.

Source