Implement debug flag for telemetry

Author: p

lib/datadog/core/configuration/settings.rb

@@ -946,6 +946,16 @@ def initialize(*_)
           # @default `nil`.
           # @return [String,nil]
           option :service
+
+          # For internal use only.
+          # Enables telemetry debugging through the Datadog platform.
+          #
+          # @default `false`.
+          # @return [Boolean]
+          option :debug do |o|
+            o.type :bool
+            o.default false
+          end
         end
 
         settings :crashtracking do

lib/datadog/core/telemetry/emitter.rb

@@ -22,9 +22,9 @@ def initialize(transport, logger: Datadog.logger)
         end
 
         # Retrieves and emits a TelemetryRequest object based on the request type specified
-        def request(event)
+        def request(event, debug: false)
           seq_id = self.class.sequence.next
-          payload = Request.build_payload(event, seq_id)
+          payload = Request.build_payload(event, seq_id, debug: debug)
           res = @transport.send_telemetry(request_type: event.type, payload: payload)
           logger.debug { "Telemetry sent for event `#{event.type}` (response code: #{res.code})" }
           res

lib/datadog/core/telemetry/request.rb

@@ -11,11 +11,11 @@ module Request
         class << self
           using Core::Utils::Hash::Refinement
 
-          def build_payload(event, seq_id, api_version: 'v2')
+          def build_payload(event, seq_id, api_version: 'v2', debug: false)
             hash = {
               api_version: api_version,
               application: application,
-              debug: false,
+              debug: debug,
               host: host,
               payload: event.payload,
               request_type: event.type,

sig/datadog/core/telemetry/emitter.rbs

@@ -9,7 +9,7 @@ module Datadog
 
         extend Core::Utils::Forking
         def initialize: (untyped transport, ?logger: Core::Logger) -> void
-        def request: (Datadog::Core::Telemetry::Event::Base event) -> (Datadog::Core::Transport::HTTP::Adapters::Net::Response | Datadog::Core::Transport::InternalErrorResponse)
+        def request: (Datadog::Core::Telemetry::Event::Base event, ?debug: bool) -> (Datadog::Core::Transport::HTTP::Adapters::Net::Response | Datadog::Core::Transport::InternalErrorResponse)
         def self.sequence: () -> Datadog::Core::Utils::Sequence
       end
     end

sig/datadog/core/telemetry/request.rbs

@@ -2,7 +2,7 @@ module Datadog
   module Core
     module Telemetry
       module Request
-        def self.build_payload: (Event::Base event, int seq_id) -> ::Hash[Symbol, untyped]
+        def self.build_payload: (Event::Base event, int seq_id, ?debug: bool) -> ::Hash[Symbol, untyped]
 
         private