Sha256: 198f518a2170dc56ce144150a44e7e64e644dd44695610516da71552452d66c1

Contents?: true

Size: 1.42 KB

Versions: 11

Compression:

Stored size: 1.42 KB

Contents

require "timber/context"
require "timber/util"

module Timber
  module Contexts
    # Custom contexts allow you to add application specific context not covered elsewhere.
    # Any data added this way will be included in your logs. A good example is worker job
    # IDs. When processing a job you might add the job ID to the context, allowing you to
    # view *all* logs generated while processing that job, not just the logs that contain
    # the ID.
    #
    # Note in the example below all custom contexts must contain a root key. This is to
    # ensure attribute names and types never clash across your contexts. It gives you
    # much cleaner pallete to organize your data on.
    #
    # @example Adding a custom context
    #   logger.with_context(build: {version: "1.0.0"}) do
    #     # anything logged here will have the custom context above
    #     # when this block exits the context will no longer be included
    #   end
    class Custom < Context
      @keyspace = :custom

      attr_reader :type, :data

      def initialize(attributes)
        @type = attributes[:type] || raise(ArgumentError.new(":type is required"))
        @data = attributes[:data] || raise(ArgumentError.new(":data is required"))
      end

      # Builds a hash representation containing simple objects, suitable for serialization (JSON).
      def as_json(options = {})
        {Timber::Util::Object.try(type, :to_sym) => data}
      end
    end
  end
end

Version data entries

11 entries across 11 versions & 1 rubygems

Version Path
timber-2.1.9 lib/timber/contexts/custom.rb
timber-2.1.8 lib/timber/contexts/custom.rb
timber-2.1.7 lib/timber/contexts/custom.rb
timber-2.1.6 lib/timber/contexts/custom.rb
timber-2.1.5 lib/timber/contexts/custom.rb
timber-2.1.4 lib/timber/contexts/custom.rb
timber-2.1.3 lib/timber/contexts/custom.rb
timber-2.1.2 lib/timber/contexts/custom.rb
timber-2.1.1 lib/timber/contexts/custom.rb
timber-2.1.0 lib/timber/contexts/custom.rb
timber-2.1.0.rc6 lib/timber/contexts/custom.rb