Sha256: f50f71444ddb0a3474f25ffb49e0e2ff2f37b144704bf2e348a8c086511ecd23

Contents?: true

Size: 1.45 KB

Versions: 10

Compression:

Stored size: 1.45 KB

Contents

# frozen_string_literal: true

# Copyright 2019 OpenTelemetry Authors
#
# SPDX-License-Identifier: Apache-2.0

module OpenTelemetry
  module Trace
    # TraceFlags contain details about the trace. Unlike Tracestate values,
    # TraceFlags are present in all traces. Currently, the only TraceFlag is a
    # boolean {sampled?} {https://www.w3.org/TR/trace-context/#trace-flags flag}.
    class TraceFlags
      class << self
        private :new # rubocop:disable Style/AccessModifierDeclarations

        # Returns a newly created {TraceFlags} with the specified flags.
        #
        # @param [Integer] flags 8-bit byte of bit flags
        # @return [TraceFlags]
        def from_byte(flags)
          flags = 0 unless flags & ~0xFF == 0 # rubocop:disable Style/NumericPredicate

          new(flags)
        end
      end

      # @api private
      # The constructor is private and only for use internally by the class.
      # Users should use the {from_byte} factory method to obtain a {TraceFlags}
      # instance.
      #
      # @param [Integer] flags 8-bit byte of bit flags
      # @return [TraceFlags]
      def initialize(flags)
        @flags = flags
      end

      # Returns whether the caller may have recorded trace data. When false,
      # the caller did not record trace data out-of-band.
      #
      # @return [Boolean]
      def sampled?
        (@flags & 1) != 0
      end

      DEFAULT = from_byte(0)
      SAMPLED = from_byte(1)
    end
  end
end

Version data entries

10 entries across 10 versions & 1 rubygems

Version Path
opentelemetry-api-0.10.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.9.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.8.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.7.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.6.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.5.1 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.5.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.4.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.3.0 lib/opentelemetry/trace/trace_flags.rb
opentelemetry-api-0.2.0 lib/opentelemetry/trace/trace_flags.rb