ddtrace 1.7.0 → 1.9.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +100 -1
- data/README.md +2 -2
- data/ext/ddtrace_profiling_loader/extconf.rb +4 -1
- data/ext/ddtrace_profiling_native_extension/NativeExtensionDesign.md +1 -1
- data/ext/ddtrace_profiling_native_extension/clock_id_from_pthread.c +3 -2
- data/ext/ddtrace_profiling_native_extension/collectors_cpu_and_wall_time.c +24 -50
- data/ext/ddtrace_profiling_native_extension/collectors_cpu_and_wall_time.h +1 -1
- data/ext/ddtrace_profiling_native_extension/collectors_cpu_and_wall_time_worker.c +284 -74
- data/ext/ddtrace_profiling_native_extension/collectors_dynamic_sampling_rate.c +142 -0
- data/ext/ddtrace_profiling_native_extension/collectors_dynamic_sampling_rate.h +14 -0
- data/ext/ddtrace_profiling_native_extension/collectors_idle_sampling_helper.c +241 -0
- data/ext/ddtrace_profiling_native_extension/collectors_idle_sampling_helper.h +3 -0
- data/ext/ddtrace_profiling_native_extension/collectors_stack.c +32 -32
- data/ext/ddtrace_profiling_native_extension/collectors_stack.h +2 -2
- data/ext/ddtrace_profiling_native_extension/extconf.rb +21 -7
- data/ext/ddtrace_profiling_native_extension/helpers.h +5 -0
- data/ext/ddtrace_profiling_native_extension/http_transport.c +50 -49
- data/ext/ddtrace_profiling_native_extension/libdatadog_helpers.h +5 -1
- data/ext/ddtrace_profiling_native_extension/native_extension_helpers.rb +42 -12
- data/ext/ddtrace_profiling_native_extension/private_vm_api_access.c +116 -22
- data/ext/ddtrace_profiling_native_extension/private_vm_api_access.h +9 -0
- data/ext/ddtrace_profiling_native_extension/profiling.c +205 -0
- data/ext/ddtrace_profiling_native_extension/ruby_helpers.c +86 -0
- data/ext/ddtrace_profiling_native_extension/ruby_helpers.h +28 -6
- data/ext/ddtrace_profiling_native_extension/setup_signal_handler.c +23 -4
- data/ext/ddtrace_profiling_native_extension/setup_signal_handler.h +4 -0
- data/ext/ddtrace_profiling_native_extension/stack_recorder.c +47 -50
- data/ext/ddtrace_profiling_native_extension/stack_recorder.h +4 -4
- data/ext/ddtrace_profiling_native_extension/time_helpers.c +17 -0
- data/ext/ddtrace_profiling_native_extension/time_helpers.h +10 -0
- data/lib/datadog/appsec/assets/waf_rules/recommended.json +75 -8
- data/lib/datadog/appsec/assets/waf_rules/risky.json +1 -1
- data/lib/datadog/appsec/assets/waf_rules/strict.json +1 -1
- data/lib/datadog/appsec/assets.rb +1 -1
- data/lib/datadog/appsec/configuration/settings.rb +35 -22
- data/lib/datadog/appsec/configuration.rb +4 -2
- data/lib/datadog/appsec/contrib/auto_instrument.rb +1 -1
- data/lib/datadog/appsec/contrib/configuration/settings.rb +1 -1
- data/lib/datadog/appsec/contrib/integration.rb +1 -1
- data/lib/datadog/appsec/contrib/patcher.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/configuration/settings.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/ext.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/gateway/watcher.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/reactive/request.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/reactive/request_body.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/reactive/response.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/request.rb +1 -1
- data/lib/datadog/appsec/contrib/rack/response.rb +1 -1
- data/lib/datadog/appsec/contrib/rails/configuration/settings.rb +1 -1
- data/lib/datadog/appsec/contrib/rails/ext.rb +1 -1
- data/lib/datadog/appsec/contrib/rails/framework.rb +1 -1
- data/lib/datadog/appsec/contrib/rails/gateway/watcher.rb +1 -1
- data/lib/datadog/appsec/contrib/rails/reactive/action.rb +1 -1
- data/lib/datadog/appsec/contrib/rails/request.rb +1 -1
- data/lib/datadog/appsec/contrib/rails/request_middleware.rb +1 -1
- data/lib/datadog/appsec/contrib/sinatra/configuration/settings.rb +1 -1
- data/lib/datadog/appsec/contrib/sinatra/ext.rb +1 -1
- data/lib/datadog/appsec/contrib/sinatra/framework.rb +1 -1
- data/lib/datadog/appsec/contrib/sinatra/gateway/watcher.rb +1 -1
- data/lib/datadog/appsec/contrib/sinatra/reactive/routed.rb +1 -1
- data/lib/datadog/appsec/contrib/sinatra/request_middleware.rb +1 -1
- data/lib/datadog/appsec/event.rb +1 -1
- data/lib/datadog/appsec/extensions.rb +36 -26
- data/lib/datadog/appsec/instrumentation/gateway.rb +3 -3
- data/lib/datadog/appsec/processor.rb +15 -19
- data/lib/datadog/appsec/rate_limiter.rb +1 -1
- data/lib/datadog/appsec/reactive/address_hash.rb +1 -1
- data/lib/datadog/appsec/reactive/engine.rb +1 -1
- data/lib/datadog/appsec/reactive/operation.rb +2 -2
- data/lib/datadog/appsec/reactive/subscriber.rb +1 -1
- data/lib/datadog/appsec/response.rb +18 -9
- data/lib/datadog/appsec/utils/http/media_range.rb +201 -0
- data/lib/datadog/appsec/utils/http/media_type.rb +87 -0
- data/lib/datadog/appsec/utils/http.rb +9 -0
- data/lib/datadog/appsec/utils.rb +7 -0
- data/lib/datadog/appsec.rb +1 -1
- data/lib/datadog/ci/ext/environment.rb +57 -13
- data/lib/datadog/core/configuration/agent_settings_resolver.rb +2 -2
- data/lib/datadog/core/configuration/base.rb +3 -0
- data/lib/datadog/core/configuration/components.rb +27 -6
- data/lib/datadog/core/configuration/ext.rb +26 -0
- data/lib/datadog/core/configuration/option_definition.rb +11 -2
- data/lib/datadog/core/configuration/settings.rb +16 -341
- data/lib/datadog/core/diagnostics/environment_logger.rb +4 -3
- data/lib/datadog/core/diagnostics/health.rb +4 -22
- data/lib/datadog/core/environment/variable_helpers.rb +58 -10
- data/lib/datadog/core/metrics/client.rb +3 -2
- data/lib/datadog/core/metrics/ext.rb +0 -2
- data/lib/datadog/core/telemetry/collector.rb +1 -0
- data/lib/datadog/core/utils.rb +0 -21
- data/lib/datadog/core.rb +21 -1
- data/lib/datadog/kit/appsec/events.rb +75 -0
- data/lib/datadog/kit/enable_core_dumps.rb +1 -0
- data/lib/datadog/kit/identity.rb +8 -7
- data/lib/datadog/opentelemetry/api/context.rb +187 -0
- data/lib/datadog/opentelemetry/api/trace/span.rb +15 -0
- data/lib/datadog/opentelemetry/sdk/configurator.rb +38 -0
- data/lib/datadog/opentelemetry/sdk/id_generator.rb +27 -0
- data/lib/datadog/opentelemetry/sdk/propagator.rb +91 -0
- data/lib/datadog/opentelemetry/sdk/span_processor.rb +92 -0
- data/lib/datadog/opentelemetry.rb +48 -0
- data/lib/datadog/opentracer/distributed_headers.rb +2 -2
- data/lib/datadog/profiling/collectors/cpu_and_wall_time_worker.rb +16 -5
- data/lib/datadog/profiling/collectors/dynamic_sampling_rate.rb +14 -0
- data/lib/datadog/profiling/collectors/idle_sampling_helper.rb +68 -0
- data/lib/datadog/profiling/stack_recorder.rb +14 -0
- data/lib/datadog/profiling.rb +2 -0
- data/lib/datadog/tracing/configuration/ext.rb +33 -4
- data/lib/datadog/tracing/configuration/settings.rb +433 -0
- data/lib/datadog/tracing/contrib/aws/configuration/settings.rb +4 -1
- data/lib/datadog/tracing/contrib/aws/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/dalli/configuration/settings.rb +4 -1
- data/lib/datadog/tracing/contrib/dalli/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/elasticsearch/configuration/settings.rb +5 -1
- data/lib/datadog/tracing/contrib/elasticsearch/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/ethon/configuration/settings.rb +6 -1
- data/lib/datadog/tracing/contrib/ethon/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/excon/configuration/settings.rb +5 -1
- data/lib/datadog/tracing/contrib/excon/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/faraday/configuration/settings.rb +5 -1
- data/lib/datadog/tracing/contrib/faraday/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/grpc/configuration/settings.rb +6 -1
- data/lib/datadog/tracing/contrib/grpc/distributed/propagation.rb +9 -4
- data/lib/datadog/tracing/contrib/grpc/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/http/configuration/settings.rb +11 -1
- data/lib/datadog/tracing/contrib/http/distributed/fetcher.rb +10 -3
- data/lib/datadog/tracing/contrib/http/distributed/propagation.rb +9 -4
- data/lib/datadog/tracing/contrib/http/ext.rb +2 -0
- data/lib/datadog/tracing/contrib/http/instrumentation.rb +3 -6
- data/lib/datadog/tracing/contrib/httpclient/configuration/settings.rb +11 -1
- data/lib/datadog/tracing/contrib/httpclient/ext.rb +2 -0
- data/lib/datadog/tracing/contrib/httpclient/instrumentation.rb +3 -4
- data/lib/datadog/tracing/contrib/httprb/configuration/settings.rb +11 -1
- data/lib/datadog/tracing/contrib/httprb/ext.rb +2 -0
- data/lib/datadog/tracing/contrib/httprb/instrumentation.rb +3 -4
- data/lib/datadog/tracing/contrib/mongodb/configuration/settings.rb +5 -1
- data/lib/datadog/tracing/contrib/mongodb/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/mysql2/configuration/settings.rb +4 -1
- data/lib/datadog/tracing/contrib/mysql2/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/mysql2/instrumentation.rb +2 -2
- data/lib/datadog/tracing/contrib/patcher.rb +3 -2
- data/lib/datadog/tracing/contrib/pg/configuration/settings.rb +4 -1
- data/lib/datadog/tracing/contrib/pg/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/pg/instrumentation.rb +56 -33
- data/lib/datadog/tracing/contrib/presto/configuration/settings.rb +4 -1
- data/lib/datadog/tracing/contrib/presto/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/propagation/sql_comment/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/propagation/sql_comment.rb +10 -12
- data/lib/datadog/tracing/contrib/redis/configuration/settings.rb +4 -1
- data/lib/datadog/tracing/contrib/redis/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/redis/instrumentation.rb +30 -23
- data/lib/datadog/tracing/contrib/redis/integration.rb +34 -2
- data/lib/datadog/tracing/contrib/redis/patcher.rb +18 -14
- data/lib/datadog/tracing/contrib/redis/quantize.rb +12 -9
- data/lib/datadog/tracing/contrib/redis/tags.rb +4 -6
- data/lib/datadog/tracing/contrib/redis/trace_middleware.rb +72 -0
- data/lib/datadog/tracing/contrib/rest_client/configuration/settings.rb +6 -1
- data/lib/datadog/tracing/contrib/rest_client/ext.rb +1 -0
- data/lib/datadog/tracing/contrib/stripe/configuration/settings.rb +33 -0
- data/lib/datadog/tracing/contrib/stripe/ext.rb +26 -0
- data/lib/datadog/tracing/contrib/stripe/integration.rb +43 -0
- data/lib/datadog/tracing/contrib/stripe/patcher.rb +29 -0
- data/lib/datadog/tracing/contrib/stripe/request.rb +67 -0
- data/lib/datadog/tracing/contrib.rb +1 -0
- data/lib/datadog/{core → tracing}/diagnostics/ext.rb +1 -6
- data/lib/datadog/tracing/diagnostics/health.rb +40 -0
- data/lib/datadog/tracing/distributed/{b3.rb → b3_multi.rb} +2 -2
- data/lib/datadog/tracing/distributed/helpers.rb +2 -1
- data/lib/datadog/tracing/distributed/none.rb +19 -0
- data/lib/datadog/tracing/distributed/trace_context.rb +378 -0
- data/lib/datadog/tracing/metadata/ext.rb +1 -1
- data/lib/datadog/tracing/metadata/tagging.rb +6 -0
- data/lib/datadog/tracing/sampling/priority_sampler.rb +11 -0
- data/lib/datadog/tracing/sampling/rate_sampler.rb +3 -3
- data/lib/datadog/tracing/span.rb +3 -19
- data/lib/datadog/tracing/span_operation.rb +5 -4
- data/lib/datadog/tracing/trace_digest.rb +85 -2
- data/lib/datadog/tracing/trace_operation.rb +13 -4
- data/lib/datadog/tracing/utils.rb +50 -0
- data/lib/ddtrace/version.rb +1 -1
- metadata +41 -9
@@ -3,19 +3,20 @@
|
|
3
3
|
require 'logger'
|
4
4
|
|
5
5
|
require_relative 'base'
|
6
|
+
require_relative 'ext'
|
6
7
|
require_relative '../environment/ext'
|
7
8
|
require_relative '../runtime/ext'
|
8
9
|
require_relative '../telemetry/ext'
|
9
10
|
require_relative '../../profiling/ext'
|
10
|
-
|
11
|
+
|
12
|
+
require_relative '../../tracing/configuration/settings'
|
11
13
|
|
12
14
|
module Datadog
|
13
15
|
module Core
|
14
16
|
module Configuration
|
15
|
-
# Global configuration settings for the
|
17
|
+
# Global configuration settings for the Datadog library.
|
16
18
|
# @public_api
|
17
19
|
# rubocop:disable Metrics/BlockLength
|
18
|
-
# rubocop:disable Layout/LineLength
|
19
20
|
class Settings
|
20
21
|
include Base
|
21
22
|
|
@@ -99,7 +100,7 @@ module Datadog
|
|
99
100
|
# @default `DD_TRACE_DEBUG` environment variable, otherwise `false`
|
100
101
|
# @return [Boolean]
|
101
102
|
option :debug do |o|
|
102
|
-
o.default { env_to_bool(Datadog::Core::
|
103
|
+
o.default { env_to_bool(Datadog::Core::Configuration::Ext::Diagnostics::ENV_DEBUG_ENABLED, false) }
|
103
104
|
o.lazy
|
104
105
|
o.on_set do |enabled|
|
105
106
|
# Enable rich debug print statements.
|
@@ -110,7 +111,6 @@ module Datadog
|
|
110
111
|
|
111
112
|
# Internal {Datadog::Statsd} metrics collection.
|
112
113
|
#
|
113
|
-
# The list of metrics collected can be found in {Datadog::Core::Diagnostics::Ext::Health::Metrics}.
|
114
114
|
# @public_api
|
115
115
|
settings :health_metrics do
|
116
116
|
# Enable health metrics collection.
|
@@ -118,7 +118,7 @@ module Datadog
|
|
118
118
|
# @default `DD_HEALTH_METRICS_ENABLED` environment variable, otherwise `false`
|
119
119
|
# @return [Boolean]
|
120
120
|
option :enabled do |o|
|
121
|
-
o.default { env_to_bool(Datadog::Core::
|
121
|
+
o.default { env_to_bool(Datadog::Core::Configuration::Ext::Diagnostics::ENV_HEALTH_METRICS_ENABLED, false) }
|
122
122
|
o.lazy
|
123
123
|
end
|
124
124
|
|
@@ -144,7 +144,7 @@ module Datadog
|
|
144
144
|
# @return [Boolean,nil]
|
145
145
|
option :enabled do |o|
|
146
146
|
# Defaults to nil as we want to know when the default value is being used
|
147
|
-
o.default { env_to_bool(Datadog::Core::
|
147
|
+
o.default { env_to_bool(Datadog::Core::Configuration::Ext::Diagnostics::ENV_STARTUP_LOGS_ENABLED, nil) }
|
148
148
|
o.lazy
|
149
149
|
end
|
150
150
|
end
|
@@ -210,6 +210,8 @@ module Datadog
|
|
210
210
|
|
211
211
|
# Controls the maximum number of frames for each thread sampled. Can be tuned to avoid omitted frames in the
|
212
212
|
# produced profiles. Increasing this may increase the overhead of profiling.
|
213
|
+
#
|
214
|
+
# @default `DD_PROFILING_MAX_FRAMES` environment variable, otherwise 400
|
213
215
|
option :max_frames do |o|
|
214
216
|
o.default { env_to_int(Profiling::Ext::ENV_MAX_FRAMES, 400) }
|
215
217
|
o.lazy
|
@@ -269,7 +271,9 @@ module Datadog
|
|
269
271
|
# If you use Ruby 3.x and your application does not use Ractors (or if your Ruby has been patched), the
|
270
272
|
# feature is fully safe to enable and this toggle can be used to do so.
|
271
273
|
#
|
272
|
-
#
|
274
|
+
# Furthermore, currently this feature can add a lot of overhead for GC-heavy workloads.
|
275
|
+
#
|
276
|
+
# We expect the once the above issues are overcome, we'll automatically enable the feature on fixed Ruby
|
273
277
|
# versions.
|
274
278
|
option :force_enable_gc_profiling do |o|
|
275
279
|
o.default { env_to_bool('DD_PROFILING_FORCE_ENABLE_GC', false) }
|
@@ -408,338 +412,6 @@ module Datadog
|
|
408
412
|
end
|
409
413
|
end
|
410
414
|
|
411
|
-
# Tracer specific configurations.
|
412
|
-
# @public_api
|
413
|
-
settings :tracing do
|
414
|
-
# Legacy [App Analytics](https://docs.datadoghq.com/tracing/legacy_app_analytics/) configuration.
|
415
|
-
#
|
416
|
-
# @configure_with {Datadog::Tracing}
|
417
|
-
# @deprecated Use [Trace Retention and Ingestion](https://docs.datadoghq.com/tracing/trace_retention_and_ingestion/)
|
418
|
-
# controls.
|
419
|
-
# @public_api
|
420
|
-
settings :analytics do
|
421
|
-
# @default `DD_TRACE_ANALYTICS_ENABLED` environment variable, otherwise `nil`
|
422
|
-
# @return [Boolean,nil]
|
423
|
-
option :enabled do |o|
|
424
|
-
o.default { env_to_bool(Tracing::Configuration::Ext::Analytics::ENV_TRACE_ANALYTICS_ENABLED, nil) }
|
425
|
-
o.lazy
|
426
|
-
end
|
427
|
-
end
|
428
|
-
|
429
|
-
# [Distributed Tracing](https://docs.datadoghq.com/tracing/setup_overview/setup/ruby/#distributed-tracing) propagation
|
430
|
-
# style configuration.
|
431
|
-
#
|
432
|
-
# The supported formats are:
|
433
|
-
# * `Datadog`: Datadog propagation format, described by [Distributed Tracing](https://docs.datadoghq.com/tracing/setup_overview/setup/ruby/#distributed-tracing).
|
434
|
-
# * `B3`: B3 Propagation using multiple headers, described by [openzipkin/b3-propagation](https://github.com/openzipkin/b3-propagation#multiple-headers).
|
435
|
-
# * `B3 single header`: B3 Propagation using a single header, described by [openzipkin/b3-propagation](https://github.com/openzipkin/b3-propagation#single-header).
|
436
|
-
#
|
437
|
-
# @public_api
|
438
|
-
settings :distributed_tracing do
|
439
|
-
# An ordered list of what data propagation styles the tracer will use to extract distributed tracing propagation
|
440
|
-
# data from incoming requests and messages.
|
441
|
-
#
|
442
|
-
# The tracer will try to find distributed headers in the order they are present in the list provided to this option.
|
443
|
-
# The first format to have valid data present will be used.
|
444
|
-
#
|
445
|
-
# @default `DD_PROPAGATION_STYLE_EXTRACT` environment variable (comma-separated list),
|
446
|
-
# otherwise `['Datadog','B3','B3 single header']`.
|
447
|
-
# @return [Array<String>]
|
448
|
-
option :propagation_extract_style do |o|
|
449
|
-
o.default do
|
450
|
-
# Look for all headers by default
|
451
|
-
env_to_list(
|
452
|
-
Tracing::Configuration::Ext::Distributed::ENV_PROPAGATION_STYLE_EXTRACT,
|
453
|
-
[
|
454
|
-
Tracing::Configuration::Ext::Distributed::PROPAGATION_STYLE_DATADOG,
|
455
|
-
Tracing::Configuration::Ext::Distributed::PROPAGATION_STYLE_B3,
|
456
|
-
Tracing::Configuration::Ext::Distributed::PROPAGATION_STYLE_B3_SINGLE_HEADER
|
457
|
-
],
|
458
|
-
comma_separated_only: true
|
459
|
-
)
|
460
|
-
end
|
461
|
-
|
462
|
-
o.lazy
|
463
|
-
end
|
464
|
-
|
465
|
-
# The data propagation styles the tracer will use to inject distributed tracing propagation
|
466
|
-
# data into outgoing requests and messages.
|
467
|
-
#
|
468
|
-
# The tracer will inject data from all styles specified in this option.
|
469
|
-
#
|
470
|
-
# @default `DD_PROPAGATION_STYLE_INJECT` environment variable (comma-separated list), otherwise `['Datadog']`.
|
471
|
-
# @return [Array<String>]
|
472
|
-
option :propagation_inject_style do |o|
|
473
|
-
o.default do
|
474
|
-
env_to_list(
|
475
|
-
Tracing::Configuration::Ext::Distributed::ENV_PROPAGATION_STYLE_INJECT,
|
476
|
-
[Tracing::Configuration::Ext::Distributed::PROPAGATION_STYLE_DATADOG],
|
477
|
-
comma_separated_only: true # Only inject Datadog headers by default
|
478
|
-
)
|
479
|
-
end
|
480
|
-
|
481
|
-
o.lazy
|
482
|
-
end
|
483
|
-
end
|
484
|
-
|
485
|
-
# Enable trace collection and span generation.
|
486
|
-
#
|
487
|
-
# You can use this option to disable tracing without having to
|
488
|
-
# remove the library as a whole.
|
489
|
-
#
|
490
|
-
# @default `DD_TRACE_ENABLED` environment variable, otherwise `true`
|
491
|
-
# @return [Boolean]
|
492
|
-
option :enabled do |o|
|
493
|
-
o.default { env_to_bool(Datadog::Core::Diagnostics::Ext::DD_TRACE_ENABLED, true) }
|
494
|
-
o.lazy
|
495
|
-
end
|
496
|
-
|
497
|
-
# A custom tracer instance.
|
498
|
-
#
|
499
|
-
# It must respect the contract of {Datadog::Tracing::Tracer}.
|
500
|
-
# It's recommended to delegate methods to {Datadog::Tracing::Tracer} to ease the implementation
|
501
|
-
# of a custom tracer.
|
502
|
-
#
|
503
|
-
# This option will not return the live tracer instance: it only holds a custom tracing instance, if any.
|
504
|
-
#
|
505
|
-
# For internal use only.
|
506
|
-
#
|
507
|
-
# @default `nil`
|
508
|
-
# @return [Object,nil]
|
509
|
-
option :instance
|
510
|
-
|
511
|
-
# Automatic correlation between tracing and logging.
|
512
|
-
# @see https://docs.datadoghq.com/tracing/setup_overview/setup/ruby/#trace-correlation
|
513
|
-
# @return [Boolean]
|
514
|
-
option :log_injection do |o|
|
515
|
-
o.default { env_to_bool(Tracing::Configuration::Ext::Correlation::ENV_LOGS_INJECTION_ENABLED, true) }
|
516
|
-
o.lazy
|
517
|
-
end
|
518
|
-
|
519
|
-
# Configures an alternative trace transport behavior, where
|
520
|
-
# traces can be sent to the agent and backend before all spans
|
521
|
-
# have finished.
|
522
|
-
#
|
523
|
-
# This is useful for long-running jobs or very large traces.
|
524
|
-
#
|
525
|
-
# The trace flame graph will display the partial trace as it is received and constantly
|
526
|
-
# update with new spans as they are flushed.
|
527
|
-
# @public_api
|
528
|
-
settings :partial_flush do
|
529
|
-
# Enable partial trace flushing.
|
530
|
-
#
|
531
|
-
# @default `false`
|
532
|
-
# @return [Boolean]
|
533
|
-
option :enabled, default: false
|
534
|
-
|
535
|
-
# Minimum number of finished spans required in a single unfinished trace before
|
536
|
-
# the tracer will consider that trace for partial flushing.
|
537
|
-
#
|
538
|
-
# This option helps preserve a minimum amount of batching in the
|
539
|
-
# flushing process, reducing network overhead.
|
540
|
-
#
|
541
|
-
# This threshold only applies to unfinished traces. Traces that have finished
|
542
|
-
# are always flushed immediately.
|
543
|
-
#
|
544
|
-
# @default 500
|
545
|
-
# @return [Integer]
|
546
|
-
option :min_spans_threshold, default: 500
|
547
|
-
end
|
548
|
-
|
549
|
-
# Enables {https://docs.datadoghq.com/tracing/trace_retention_and_ingestion/#datadog-intelligent-retention-filter
|
550
|
-
# Datadog intelligent retention filter}.
|
551
|
-
# @default `true`
|
552
|
-
# @return [Boolean,nil]
|
553
|
-
option :priority_sampling
|
554
|
-
|
555
|
-
option :report_hostname do |o|
|
556
|
-
o.default { env_to_bool(Tracing::Configuration::Ext::NET::ENV_REPORT_HOSTNAME, false) }
|
557
|
-
o.lazy
|
558
|
-
end
|
559
|
-
|
560
|
-
# A custom sampler instance.
|
561
|
-
# The object must respect the {Datadog::Tracing::Sampling::Sampler} interface.
|
562
|
-
# @default `nil`
|
563
|
-
# @return [Object,nil]
|
564
|
-
option :sampler
|
565
|
-
|
566
|
-
# Client-side sampling configuration.
|
567
|
-
# @see https://docs.datadoghq.com/tracing/trace_ingestion/mechanisms/
|
568
|
-
# @public_api
|
569
|
-
settings :sampling do
|
570
|
-
# Default sampling rate for the tracer.
|
571
|
-
#
|
572
|
-
# If `nil`, the trace uses an automatic sampling strategy that tries to ensure
|
573
|
-
# the collection of traces that are considered important (e.g. traces with an error, traces
|
574
|
-
# for resources not seen recently).
|
575
|
-
#
|
576
|
-
# @default `DD_TRACE_SAMPLE_RATE` environment variable, otherwise `nil`.
|
577
|
-
# @return [Float,nil]
|
578
|
-
option :default_rate do |o|
|
579
|
-
o.default { env_to_float(Tracing::Configuration::Ext::Sampling::ENV_SAMPLE_RATE, nil) }
|
580
|
-
o.lazy
|
581
|
-
end
|
582
|
-
|
583
|
-
# Rate limit for number of spans per second.
|
584
|
-
#
|
585
|
-
# Spans created above the limit will contribute to service metrics, but won't
|
586
|
-
# have their payload stored.
|
587
|
-
#
|
588
|
-
# @default `DD_TRACE_RATE_LIMIT` environment variable, otherwise 100.
|
589
|
-
# @return [Numeric,nil]
|
590
|
-
option :rate_limit do |o|
|
591
|
-
o.default { env_to_float(Tracing::Configuration::Ext::Sampling::ENV_RATE_LIMIT, 100) }
|
592
|
-
o.lazy
|
593
|
-
end
|
594
|
-
|
595
|
-
# Single span sampling rules.
|
596
|
-
# These rules allow a span to be kept when its encompassing trace is dropped.
|
597
|
-
#
|
598
|
-
# The syntax for single span sampling rules can be found here:
|
599
|
-
# TODO: <Single Span Sampling documentation URL here>
|
600
|
-
#
|
601
|
-
# @default `DD_SPAN_SAMPLING_RULES` environment variable.
|
602
|
-
# Otherwise, `ENV_SPAN_SAMPLING_RULES_FILE` environment variable.
|
603
|
-
# Otherwise `nil`.
|
604
|
-
# @return [String,nil]
|
605
|
-
# @public_api
|
606
|
-
option :span_rules do |o|
|
607
|
-
o.default do
|
608
|
-
rules = ENV[Tracing::Configuration::Ext::Sampling::Span::ENV_SPAN_SAMPLING_RULES]
|
609
|
-
rules_file = ENV[Tracing::Configuration::Ext::Sampling::Span::ENV_SPAN_SAMPLING_RULES_FILE]
|
610
|
-
|
611
|
-
if rules
|
612
|
-
if rules_file
|
613
|
-
Datadog.logger.warn(
|
614
|
-
'Both DD_SPAN_SAMPLING_RULES and DD_SPAN_SAMPLING_RULES_FILE were provided: only ' \
|
615
|
-
'DD_SPAN_SAMPLING_RULES will be used. Please do not provide DD_SPAN_SAMPLING_RULES_FILE when ' \
|
616
|
-
'also providing DD_SPAN_SAMPLING_RULES as their configuration conflicts. ' \
|
617
|
-
"DD_SPAN_SAMPLING_RULES_FILE=#{rules_file} DD_SPAN_SAMPLING_RULES=#{rules}"
|
618
|
-
)
|
619
|
-
end
|
620
|
-
rules
|
621
|
-
elsif rules_file
|
622
|
-
begin
|
623
|
-
File.read(rules_file)
|
624
|
-
rescue => e
|
625
|
-
# `File#read` errors have clear and actionable messages, no need to add extra exception info.
|
626
|
-
Datadog.logger.warn(
|
627
|
-
"Cannot read span sampling rules file `#{rules_file}`: #{e.message}." \
|
628
|
-
'No span sampling rules will be applied.'
|
629
|
-
)
|
630
|
-
nil
|
631
|
-
end
|
632
|
-
end
|
633
|
-
end
|
634
|
-
o.lazy
|
635
|
-
end
|
636
|
-
end
|
637
|
-
|
638
|
-
# [Continuous Integration Visibility](https://docs.datadoghq.com/continuous_integration/) configuration.
|
639
|
-
# @public_api
|
640
|
-
settings :test_mode do
|
641
|
-
# Enable test mode. This allows the tracer to collect spans from test runs.
|
642
|
-
#
|
643
|
-
# It also prevents the tracer from collecting spans in a production environment. Only use in a test environment.
|
644
|
-
#
|
645
|
-
# @default `DD_TRACE_TEST_MODE_ENABLED` environment variable, otherwise `false`
|
646
|
-
# @return [Boolean]
|
647
|
-
option :enabled do |o|
|
648
|
-
o.default { env_to_bool(Tracing::Configuration::Ext::Test::ENV_MODE_ENABLED, false) }
|
649
|
-
o.lazy
|
650
|
-
end
|
651
|
-
|
652
|
-
option :trace_flush do |o|
|
653
|
-
o.default { nil }
|
654
|
-
o.lazy
|
655
|
-
end
|
656
|
-
|
657
|
-
option :writer_options do |o|
|
658
|
-
o.default { {} }
|
659
|
-
o.lazy
|
660
|
-
end
|
661
|
-
end
|
662
|
-
|
663
|
-
# @see file:docs/GettingStarted.md#configuring-the-transport-layer Configuring the transport layer
|
664
|
-
#
|
665
|
-
# A {Proc} that configures a custom tracer transport.
|
666
|
-
# @yield Receives a {Datadog::Transport::HTTP} that can be modified with custom adapters and settings.
|
667
|
-
# @yieldparam [Datadog::Transport::HTTP] t transport to be configured.
|
668
|
-
# @default `nil`
|
669
|
-
# @return [Proc,nil]
|
670
|
-
option :transport_options, default: nil
|
671
|
-
|
672
|
-
# A custom writer instance.
|
673
|
-
# The object must respect the {Datadog::Tracing::Writer} interface.
|
674
|
-
#
|
675
|
-
# This option is recommended for internal use only.
|
676
|
-
#
|
677
|
-
# @default `nil`
|
678
|
-
# @return [Object,nil]
|
679
|
-
option :writer
|
680
|
-
|
681
|
-
# A custom {Hash} with keyword options to be passed to {Datadog::Tracing::Writer#initialize}.
|
682
|
-
#
|
683
|
-
# This option is recommended for internal use only.
|
684
|
-
#
|
685
|
-
# @default `{}`
|
686
|
-
# @return [Hash,nil]
|
687
|
-
option :writer_options, default: ->(_i) { {} }, lazy: true
|
688
|
-
|
689
|
-
# Client IP configuration
|
690
|
-
# @public_api
|
691
|
-
settings :client_ip do
|
692
|
-
# Whether client IP collection is enabled. When enabled client IPs from HTTP requests will
|
693
|
-
# be reported in traces.
|
694
|
-
#
|
695
|
-
# Usage of the DD_TRACE_CLIENT_IP_HEADER_DISABLED environment variable is deprecated.
|
696
|
-
#
|
697
|
-
# @see https://docs.datadoghq.com/tracing/configure_data_security#configuring-a-client-ip-header
|
698
|
-
#
|
699
|
-
# @default `DD_TRACE_CLIENT_IP_ENABLED` environment variable, otherwise `false`.
|
700
|
-
# @return [Boolean]
|
701
|
-
option :enabled do |o|
|
702
|
-
o.default do
|
703
|
-
disabled = env_to_bool(Tracing::Configuration::Ext::ClientIp::ENV_DISABLED)
|
704
|
-
|
705
|
-
enabled = if disabled.nil?
|
706
|
-
false
|
707
|
-
else
|
708
|
-
Datadog.logger.warn { "#{Tracing::Configuration::Ext::ClientIp::ENV_DISABLED} environment variable is deprecated, found set to #{disabled}, use #{Tracing::Configuration::Ext::ClientIp::ENV_ENABLED}=#{!disabled}" }
|
709
|
-
|
710
|
-
!disabled
|
711
|
-
end
|
712
|
-
|
713
|
-
# ENABLED env var takes precedence over deprecated DISABLED
|
714
|
-
env_to_bool(Tracing::Configuration::Ext::ClientIp::ENV_ENABLED, enabled)
|
715
|
-
end
|
716
|
-
o.lazy
|
717
|
-
end
|
718
|
-
|
719
|
-
# An optional name of a custom header to resolve the client IP from.
|
720
|
-
#
|
721
|
-
# @default `DD_TRACE_CLIENT_IP_HEADER` environment variable, otherwise `nil`.
|
722
|
-
# @return [String,nil]
|
723
|
-
option :header_name do |o|
|
724
|
-
o.default { ENV.fetch(Tracing::Configuration::Ext::ClientIp::ENV_HEADER_NAME, nil) }
|
725
|
-
o.lazy
|
726
|
-
end
|
727
|
-
end
|
728
|
-
|
729
|
-
# Maximum size for the `x-datadog-tags` distributed trace tags header.
|
730
|
-
#
|
731
|
-
# If the serialized size of distributed trace tags is larger than this value, it will
|
732
|
-
# not be parsed if incoming, nor exported if outgoing. An error message will be logged
|
733
|
-
# in this case.
|
734
|
-
#
|
735
|
-
# @default `DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH` environment variable, otherwise `512`
|
736
|
-
# @return [Integer]
|
737
|
-
option :x_datadog_tags_max_length do |o|
|
738
|
-
o.default { env_to_int(Tracing::Configuration::Ext::Distributed::ENV_X_DATADOG_TAGS_MAX_LENGTH, 512) }
|
739
|
-
o.lazy
|
740
|
-
end
|
741
|
-
end
|
742
|
-
|
743
415
|
# The `version` tag in Datadog. Use it to enable [Deployment Tracking](https://docs.datadoghq.com/tracing/deployment_tracking/).
|
744
416
|
# @see https://docs.datadoghq.com/getting_started/tagging/unified_service_tagging
|
745
417
|
# @default `DD_VERSION` environment variable, otherwise `nils`
|
@@ -763,9 +435,12 @@ module Datadog
|
|
763
435
|
o.lazy
|
764
436
|
end
|
765
437
|
end
|
438
|
+
|
439
|
+
# TODO: Tracing should manage its own settings.
|
440
|
+
# Keep this extension here for now to keep things working.
|
441
|
+
extend Datadog::Tracing::Configuration::Settings
|
766
442
|
end
|
767
443
|
# rubocop:enable Metrics/BlockLength
|
768
|
-
# rubocop:enable Layout/LineLength
|
769
444
|
end
|
770
445
|
end
|
771
446
|
end
|
@@ -221,9 +221,9 @@ module Datadog
|
|
221
221
|
!!Datadog.configuration.diagnostics.health_metrics.enabled
|
222
222
|
end
|
223
223
|
|
224
|
-
|
225
|
-
|
226
|
-
|
224
|
+
def profiling_enabled
|
225
|
+
!!Datadog.configuration.profiling.enabled
|
226
|
+
end
|
227
227
|
|
228
228
|
# TODO: Populate when automatic log correlation is implemented
|
229
229
|
# def logs_correlation_enabled
|
@@ -254,6 +254,7 @@ module Datadog
|
|
254
254
|
partial_flushing_enabled: partial_flushing_enabled,
|
255
255
|
priority_sampling_enabled: priority_sampling_enabled,
|
256
256
|
health_metrics_enabled: health_metrics_enabled,
|
257
|
+
profiling_enabled: profiling_enabled,
|
257
258
|
**instrumented_integrations_settings
|
258
259
|
}
|
259
260
|
end
|
@@ -1,7 +1,7 @@
|
|
1
|
-
# typed:
|
1
|
+
# typed: ignore
|
2
2
|
|
3
|
-
require_relative 'ext'
|
4
3
|
require_relative '../metrics/client'
|
4
|
+
require_relative '../../tracing/diagnostics/health'
|
5
5
|
|
6
6
|
module Datadog
|
7
7
|
module Core
|
@@ -10,26 +10,8 @@ module Datadog
|
|
10
10
|
module Health
|
11
11
|
# Health metrics for diagnostics
|
12
12
|
class Metrics < Core::Metrics::Client
|
13
|
-
|
14
|
-
|
15
|
-
count :api_responses, Ext::Health::Metrics::METRIC_API_RESPONSES
|
16
|
-
count :error_context_overflow, Ext::Health::Metrics::METRIC_ERROR_CONTEXT_OVERFLOW
|
17
|
-
count :error_instrumentation_patch, Ext::Health::Metrics::METRIC_ERROR_INSTRUMENTATION_PATCH
|
18
|
-
count :error_span_finish, Ext::Health::Metrics::METRIC_ERROR_SPAN_FINISH
|
19
|
-
count :error_unfinished_spans, Ext::Health::Metrics::METRIC_ERROR_UNFINISHED_SPANS
|
20
|
-
count :instrumentation_patched, Ext::Health::Metrics::METRIC_INSTRUMENTATION_PATCHED
|
21
|
-
count :queue_accepted, Ext::Health::Metrics::METRIC_QUEUE_ACCEPTED
|
22
|
-
count :queue_accepted_lengths, Ext::Health::Metrics::METRIC_QUEUE_ACCEPTED_LENGTHS
|
23
|
-
count :queue_dropped, Ext::Health::Metrics::METRIC_QUEUE_DROPPED
|
24
|
-
count :traces_filtered, Ext::Health::Metrics::METRIC_TRACES_FILTERED
|
25
|
-
count :transport_trace_too_large, Ext::Health::Metrics::METRIC_TRANSPORT_TRACE_TOO_LARGE
|
26
|
-
count :transport_chunked, Ext::Health::Metrics::METRIC_TRANSPORT_CHUNKED
|
27
|
-
count :writer_cpu_time, Ext::Health::Metrics::METRIC_WRITER_CPU_TIME
|
28
|
-
|
29
|
-
gauge :queue_length, Ext::Health::Metrics::METRIC_QUEUE_LENGTH
|
30
|
-
gauge :queue_max_length, Ext::Health::Metrics::METRIC_QUEUE_MAX_LENGTH
|
31
|
-
gauge :queue_spans, Ext::Health::Metrics::METRIC_QUEUE_SPANS
|
32
|
-
gauge :sampling_service_cache_length, Ext::Health::Metrics::METRIC_SAMPLING_SERVICE_CACHE_LENGTH
|
13
|
+
# TODO: Don't reference this. Have tracing add its metrics behavior.
|
14
|
+
extend Tracing::Diagnostics::Health::Metrics
|
33
15
|
end
|
34
16
|
end
|
35
17
|
end
|
@@ -9,18 +9,45 @@ module Datadog
|
|
9
9
|
module VariableHelpers
|
10
10
|
extend self
|
11
11
|
|
12
|
-
|
13
|
-
|
12
|
+
# Reads an environment variable as a Boolean.
|
13
|
+
#
|
14
|
+
# @param [String] var environment variable
|
15
|
+
# @param [Array<String>] var list of environment variables
|
16
|
+
# @param [Boolean] default the default value if the keys in `var` are not present in the environment
|
17
|
+
# @param [Boolean] deprecation_warning when `var` is a list, record a deprecation log when
|
18
|
+
# the first key in `var` is not used.
|
19
|
+
# @return [Boolean] if the environment value is the string `true`
|
20
|
+
# @return [default] if the environment value is not found
|
21
|
+
def env_to_bool(var, default = nil, deprecation_warning: true)
|
22
|
+
var = decode_array(var, deprecation_warning)
|
14
23
|
var && ENV.key?(var) ? ENV[var].to_s.strip.downcase == 'true' : default
|
15
24
|
end
|
16
25
|
|
17
|
-
|
18
|
-
|
26
|
+
# Reads an environment variable as an Integer.
|
27
|
+
#
|
28
|
+
# @param [String] var environment variable
|
29
|
+
# @param [Array<String>] var list of environment variables
|
30
|
+
# @param [Integer] default the default value if the keys in `var` are not present in the environment
|
31
|
+
# @param [Boolean] deprecation_warning when `var` is a list, record a deprecation log when
|
32
|
+
# the first key in `var` is not used.
|
33
|
+
# @return [Integer] if the environment value is a valid Integer
|
34
|
+
# @return [default] if the environment value is not found
|
35
|
+
def env_to_int(var, default = nil, deprecation_warning: true)
|
36
|
+
var = decode_array(var, deprecation_warning)
|
19
37
|
var && ENV.key?(var) ? ENV[var].to_i : default
|
20
38
|
end
|
21
39
|
|
22
|
-
|
23
|
-
|
40
|
+
# Reads an environment variable as a Float.
|
41
|
+
#
|
42
|
+
# @param [String] var environment variable
|
43
|
+
# @param [Array<String>] var list of environment variables
|
44
|
+
# @param [Float] default the default value if the keys in `var` are not present in the environment
|
45
|
+
# @param [Boolean] deprecation_warning when `var` is a list, record a deprecation log when
|
46
|
+
# the first key in `var` is not used.
|
47
|
+
# @return [Float] if the environment value is a valid Float
|
48
|
+
# @return [default] if the environment value is not found
|
49
|
+
def env_to_float(var, default = nil, deprecation_warning: true)
|
50
|
+
var = decode_array(var, deprecation_warning)
|
24
51
|
var && ENV.key?(var) ? ENV[var].to_f : default
|
25
52
|
end
|
26
53
|
|
@@ -33,8 +60,16 @@ module Datadog
|
|
33
60
|
# either trailing or leading are trimmed.
|
34
61
|
#
|
35
62
|
# Empty entries, after trimmed, are also removed from the result.
|
36
|
-
|
37
|
-
|
63
|
+
#
|
64
|
+
# @param [String] var environment variable
|
65
|
+
# @param [Array<String>] var list of environment variables
|
66
|
+
# @param [Array<Object>] default the default value if the keys in `var` are not present in the environment
|
67
|
+
# @param [Boolean] deprecation_warning when `var` is a list, record a deprecation log when
|
68
|
+
# the first key in `var` is not used.
|
69
|
+
# @return [Array<Object>] if the environment value is a valid list
|
70
|
+
# @return [default] if the environment value is not found
|
71
|
+
def env_to_list(var, default = [], comma_separated_only:, deprecation_warning: true)
|
72
|
+
var = decode_array(var, deprecation_warning)
|
38
73
|
if var && ENV.key?(var)
|
39
74
|
value = ENV[var]
|
40
75
|
|
@@ -59,8 +94,21 @@ module Datadog
|
|
59
94
|
|
60
95
|
private
|
61
96
|
|
62
|
-
def decode_array(var)
|
63
|
-
var.is_a?(Array)
|
97
|
+
def decode_array(var, deprecation_warning)
|
98
|
+
if var.is_a?(Array)
|
99
|
+
var.find.with_index do |env_var, i|
|
100
|
+
found = ENV.key?(env_var)
|
101
|
+
|
102
|
+
# Check if we are using a non-preferred environment variable
|
103
|
+
if deprecation_warning && found && i != 0
|
104
|
+
Datadog::Core.log_deprecation { "#{env_var} environment variable is deprecated, use #{var.first} instead." }
|
105
|
+
end
|
106
|
+
|
107
|
+
found
|
108
|
+
end
|
109
|
+
else
|
110
|
+
var
|
111
|
+
end
|
64
112
|
end
|
65
113
|
end
|
66
114
|
end
|
@@ -2,6 +2,7 @@
|
|
2
2
|
|
3
3
|
require_relative '../utils/time'
|
4
4
|
require_relative '../utils/only_once'
|
5
|
+
require_relative '../configuration/ext'
|
5
6
|
|
6
7
|
require_relative 'ext'
|
7
8
|
require_relative 'options'
|
@@ -50,11 +51,11 @@ module Datadog
|
|
50
51
|
end
|
51
52
|
|
52
53
|
def default_hostname
|
53
|
-
ENV.fetch(Ext::ENV_DEFAULT_HOST, Ext::DEFAULT_HOST)
|
54
|
+
ENV.fetch(Configuration::Ext::Transport::ENV_DEFAULT_HOST, Ext::DEFAULT_HOST)
|
54
55
|
end
|
55
56
|
|
56
57
|
def default_port
|
57
|
-
ENV.fetch(Ext::ENV_DEFAULT_PORT, Ext::DEFAULT_PORT).to_i
|
58
|
+
ENV.fetch(Configuration::Ext::Metrics::ENV_DEFAULT_PORT, Ext::DEFAULT_PORT).to_i
|
58
59
|
end
|
59
60
|
|
60
61
|
def default_statsd_client
|
@@ -7,8 +7,6 @@ module Datadog
|
|
7
7
|
module Ext
|
8
8
|
DEFAULT_HOST = '127.0.0.1'.freeze
|
9
9
|
DEFAULT_PORT = 8125
|
10
|
-
ENV_DEFAULT_HOST = 'DD_AGENT_HOST'.freeze
|
11
|
-
ENV_DEFAULT_PORT = 'DD_METRIC_AGENT_PORT'.freeze
|
12
10
|
|
13
11
|
TAG_LANG = 'language'.freeze
|
14
12
|
TAG_LANG_INTERPRETER = 'language-interpreter'.freeze
|
@@ -135,6 +135,7 @@ module Datadog
|
|
135
135
|
format_configuration_value(configuration.tracing.writer_options[:flush_interval])
|
136
136
|
options['logger.instance'] = configuration.logger.instance.class.to_s
|
137
137
|
options['appsec.enabled'] = configuration.dig('appsec', 'enabled') if configuration.respond_to?('appsec')
|
138
|
+
options['tracing.opentelemetry.enabled'] = !defined?(Datadog::OpenTelemetry::LOADED).nil?
|
138
139
|
compact_hash(options)
|
139
140
|
end
|
140
141
|
|
data/lib/datadog/core/utils.rb
CHANGED
@@ -1,7 +1,6 @@
|
|
1
1
|
# typed: true
|
2
2
|
|
3
3
|
require_relative 'utils/forking'
|
4
|
-
require_relative '../tracing/span'
|
5
4
|
|
6
5
|
module Datadog
|
7
6
|
module Core
|
@@ -11,26 +10,6 @@ module Datadog
|
|
11
10
|
extend Forking
|
12
11
|
|
13
12
|
EMPTY_STRING = ''.encode(::Encoding::UTF_8).freeze
|
14
|
-
# We use a custom random number generator because we want no interference
|
15
|
-
# with the default one. Using the default prng, we could break code that
|
16
|
-
# would rely on srand/rand sequences.
|
17
|
-
|
18
|
-
# Return a randomly generated integer, valid as a Span ID or Trace ID.
|
19
|
-
# This method is thread-safe and fork-safe.
|
20
|
-
def self.next_id
|
21
|
-
after_fork! { reset! }
|
22
|
-
id_rng.rand(Tracing::Span::RUBY_ID_RANGE)
|
23
|
-
end
|
24
|
-
|
25
|
-
def self.id_rng
|
26
|
-
@id_rng ||= Random.new
|
27
|
-
end
|
28
|
-
|
29
|
-
def self.reset!
|
30
|
-
@id_rng = Random.new
|
31
|
-
end
|
32
|
-
|
33
|
-
private_class_method :id_rng, :reset!
|
34
13
|
|
35
14
|
# Stringifies `value` and ensures the outcome is
|
36
15
|
# string is no longer than `size`.
|