Class: Datadog::CI::Span
- Inherits:
-
Object
- Object
- Datadog::CI::Span
- Defined in:
- lib/datadog/ci/span.rb
Overview
Represents a single part of a test run. Could be a session, suite, test, or any custom span.
Direct Known Subclasses
Instance Attribute Summary collapse
-
#tracer_span ⇒ Object
readonly
Returns the value of attribute tracer_span.
Instance Method Summary collapse
-
#clear_tag(key) ⇒ void
Removes tag by key.
-
#failed!(exception: nil) ⇒ void
Sets the status of the span to "fail".
-
#failed? ⇒ bool
Checks whether span status is FAIL.
-
#finish ⇒ void
Finishes the span.
-
#get_tag(key) ⇒ String
Gets tag value by key.
-
#git_branch ⇒ String
Returns the git branch name extracted from the environment.
-
#git_commit_sha ⇒ String
Returns the latest commit SHA extracted from the environment.
-
#git_repository_url ⇒ String
Returns the git repository URL extracted from the environment.
-
#id ⇒ Integer
The ID of the span.
-
#initialize(tracer_span) ⇒ Span
constructor
A new instance of Span.
-
#name ⇒ String
The name of the span.
-
#os_architecture ⇒ String
Returns the OS architecture extracted from the environment.
-
#os_platform ⇒ String
Returns the OS platform extracted from the environment.
-
#os_version ⇒ String
Returns the OS version extracted from the environment.
-
#passed! ⇒ void
Sets the status of the span to "pass".
-
#passed? ⇒ bool
Checks whether span status is PASS.
-
#runtime_name ⇒ String
Returns the runtime name extracted from the environment.
-
#runtime_version ⇒ String
Returns the runtime version extracted from the environment.
-
#service ⇒ String
The service name of the span.
- #set_default_tags ⇒ Object
- #set_environment_runtime_tags ⇒ Object
-
#set_metric(key, value) ⇒ void
Sets metric value by key.
-
#set_tag(key, value) ⇒ void
Sets tag value by key.
-
#set_tags(tags) ⇒ void
Sets multiple tags at once.
-
#skipped!(exception: nil, reason: nil) ⇒ void
Sets the status of the span to "skip".
-
#skipped? ⇒ bool
Checks whether span status is SKIP.
- #to_s ⇒ Object
-
#trace_id ⇒ Integer
The trace ID of the trace this span belongs to.
-
#type ⇒ String
The type of the span (for example "test" or type that was provided to [Datadog::CI.trace]).
-
#undefined? ⇒ bool
Checks whether span status is not set yet.
Constructor Details
#initialize(tracer_span) ⇒ Span
Returns a new instance of Span.
17 18 19 |
# File 'lib/datadog/ci/span.rb', line 17 def initialize(tracer_span) @tracer_span = tracer_span end |
Instance Attribute Details
#tracer_span ⇒ Object (readonly)
Returns the value of attribute tracer_span.
15 16 17 |
# File 'lib/datadog/ci/span.rb', line 15 def tracer_span @tracer_span end |
Instance Method Details
#clear_tag(key) ⇒ void
This method returns an undefined value.
Removes tag by key.
113 114 115 |
# File 'lib/datadog/ci/span.rb', line 113 def clear_tag(key) tracer_span.clear_tag(key) end |
#failed!(exception: nil) ⇒ void
This method returns an undefined value.
Sets the status of the span to "fail".
79 80 81 82 83 |
# File 'lib/datadog/ci/span.rb', line 79 def failed!(exception: nil) tracer_span.status = 1 tracer_span.set_tag(Ext::Test::TAG_STATUS, Ext::Test::Status::FAIL) tracer_span.set_error(exception) unless exception.nil? end |
#failed? ⇒ bool
Checks whether span status is FAIL.
60 61 62 |
# File 'lib/datadog/ci/span.rb', line 60 def failed? tracer_span.get_tag(Ext::Test::TAG_STATUS) == Ext::Test::Status::FAIL end |
#finish ⇒ void
This method returns an undefined value.
Finishes the span.
127 128 129 |
# File 'lib/datadog/ci/span.rb', line 127 def finish tracer_span.finish end |
#get_tag(key) ⇒ String
Gets tag value by key.
98 99 100 |
# File 'lib/datadog/ci/span.rb', line 98 def get_tag(key) tracer_span.get_tag(key) end |
#git_branch ⇒ String
Returns the git branch name extracted from the environment.
152 153 154 |
# File 'lib/datadog/ci/span.rb', line 152 def git_branch tracer_span.get_tag(Ext::Git::TAG_BRANCH) end |
#git_commit_sha ⇒ String
Returns the latest commit SHA extracted from the environment.
146 147 148 |
# File 'lib/datadog/ci/span.rb', line 146 def git_commit_sha tracer_span.get_tag(Ext::Git::TAG_COMMIT_SHA) end |
#git_repository_url ⇒ String
Returns the git repository URL extracted from the environment.
140 141 142 |
# File 'lib/datadog/ci/span.rb', line 140 def git_repository_url tracer_span.get_tag(Ext::Git::TAG_REPOSITORY_URL) end |
#id ⇒ Integer
Returns the ID of the span.
22 23 24 |
# File 'lib/datadog/ci/span.rb', line 22 def id tracer_span.id end |
#name ⇒ String
Returns the name of the span.
32 33 34 |
# File 'lib/datadog/ci/span.rb', line 32 def name tracer_span.name end |
#os_architecture ⇒ String
Returns the OS architecture extracted from the environment.
158 159 160 |
# File 'lib/datadog/ci/span.rb', line 158 def os_architecture tracer_span.get_tag(Ext::Test::TAG_OS_ARCHITECTURE) end |
#os_platform ⇒ String
Returns the OS platform extracted from the environment.
164 165 166 |
# File 'lib/datadog/ci/span.rb', line 164 def os_platform tracer_span.get_tag(Ext::Test::TAG_OS_PLATFORM) end |
#os_version ⇒ String
Returns the OS version extracted from the environment.
170 171 172 |
# File 'lib/datadog/ci/span.rb', line 170 def os_version tracer_span.get_tag(Ext::Test::TAG_OS_VERSION) end |
#passed! ⇒ void
This method returns an undefined value.
Sets the status of the span to "pass".
72 73 74 |
# File 'lib/datadog/ci/span.rb', line 72 def passed! tracer_span.set_tag(Ext::Test::TAG_STATUS, Ext::Test::Status::PASS) end |
#passed? ⇒ bool
Checks whether span status is PASS.
54 55 56 |
# File 'lib/datadog/ci/span.rb', line 54 def passed? tracer_span.get_tag(Ext::Test::TAG_STATUS) == Ext::Test::Status::PASS end |
#runtime_name ⇒ String
Returns the runtime name extracted from the environment.
176 177 178 |
# File 'lib/datadog/ci/span.rb', line 176 def runtime_name tracer_span.get_tag(Ext::Test::TAG_RUNTIME_NAME) end |
#runtime_version ⇒ String
Returns the runtime version extracted from the environment.
182 183 184 |
# File 'lib/datadog/ci/span.rb', line 182 def runtime_version tracer_span.get_tag(Ext::Test::TAG_RUNTIME_VERSION) end |
#service ⇒ String
Returns the service name of the span.
37 38 39 |
# File 'lib/datadog/ci/span.rb', line 37 def service tracer_span.service end |
#set_default_tags ⇒ Object
195 196 197 |
# File 'lib/datadog/ci/span.rb', line 195 def tracer_span.set_tag(Ext::Test::TAG_SPAN_KIND, Ext::Test::SPAN_KIND_TEST) end |
#set_environment_runtime_tags ⇒ Object
186 187 188 189 190 191 192 193 |
# File 'lib/datadog/ci/span.rb', line 186 def tracer_span.set_tag(Ext::Test::TAG_OS_ARCHITECTURE, ::RbConfig::CONFIG["host_cpu"]) tracer_span.set_tag(Ext::Test::TAG_OS_PLATFORM, ::RbConfig::CONFIG["host_os"]) tracer_span.set_tag(Ext::Test::TAG_OS_VERSION, Core::Environment::Platform.kernel_release) tracer_span.set_tag(Ext::Test::TAG_RUNTIME_NAME, Core::Environment::Ext::LANG_ENGINE) tracer_span.set_tag(Ext::Test::TAG_RUNTIME_VERSION, Core::Environment::Ext::ENGINE_VERSION) tracer_span.set_tag(Ext::Test::TAG_COMMAND, Utils::TestRun.command) end |
#set_metric(key, value) ⇒ void
This method returns an undefined value.
Sets metric value by key.
121 122 123 |
# File 'lib/datadog/ci/span.rb', line 121 def set_metric(key, value) tracer_span.set_metric(key, value) end |
#set_tag(key, value) ⇒ void
This method returns an undefined value.
Sets tag value by key.
106 107 108 |
# File 'lib/datadog/ci/span.rb', line 106 def set_tag(key, value) tracer_span.set_tag(key, value) end |
#set_tags(tags) ⇒ void
This method returns an undefined value.
Sets multiple tags at once.
134 135 136 |
# File 'lib/datadog/ci/span.rb', line 134 def () tracer_span.() end |
#skipped!(exception: nil, reason: nil) ⇒ void
This method returns an undefined value.
Sets the status of the span to "skip".
89 90 91 92 93 |
# File 'lib/datadog/ci/span.rb', line 89 def skipped!(exception: nil, reason: nil) tracer_span.set_tag(Ext::Test::TAG_STATUS, Ext::Test::Status::SKIP) tracer_span.set_error(exception) unless exception.nil? tracer_span.set_tag(Ext::Test::TAG_SKIP_REASON, reason) unless reason.nil? end |
#skipped? ⇒ bool
Checks whether span status is SKIP.
66 67 68 |
# File 'lib/datadog/ci/span.rb', line 66 def skipped? tracer_span.get_tag(Ext::Test::TAG_STATUS) == Ext::Test::Status::SKIP end |
#to_s ⇒ Object
199 200 201 |
# File 'lib/datadog/ci/span.rb', line 199 def to_s "#{self.class}(name:#{name},tracer_span:#{@tracer_span})" end |
#trace_id ⇒ Integer
Returns the trace ID of the trace this span belongs to.
27 28 29 |
# File 'lib/datadog/ci/span.rb', line 27 def trace_id tracer_span.trace_id end |
#type ⇒ String
Returns the type of the span (for example "test" or type that was provided to [Datadog::CI.trace]).
42 43 44 |
# File 'lib/datadog/ci/span.rb', line 42 def type tracer_span.type end |
#undefined? ⇒ bool
Checks whether span status is not set yet.
48 49 50 |
# File 'lib/datadog/ci/span.rb', line 48 def undefined? tracer_span.get_tag(Ext::Test::TAG_STATUS).nil? end |