Class: Google::Apis::CloudtraceV1::TraceSpan

Inherits:
Object
  • Object
show all
Includes:
Google::Apis::Core::Hashable, Google::Apis::Core::JsonObjectSupport
Defined in:
generated/google/apis/cloudtrace_v1/classes.rb,
generated/google/apis/cloudtrace_v1/representations.rb,
generated/google/apis/cloudtrace_v1/representations.rb

Overview

A span represents a single timed event within a trace. Spans can be nested and form a trace tree. Often, a trace contains a root span that describes the end-to-end latency of an operation and, optionally, one or more subspans for its suboperations. Spans do not need to be contiguous. There may be gaps between spans in a trace.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Google::Apis::Core::JsonObjectSupport

#to_json

Methods included from Google::Apis::Core::Hashable

process_value, #to_h

Constructor Details

#initialize(**args) ⇒ TraceSpan

Returns a new instance of TraceSpan



97
98
99
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 97

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#end_time ⇒ String

End time of the span in nanoseconds from the UNIX epoch. Corresponds to the JSON property endTime

Returns:

  • (String) 


55
56
57
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 55

def end_time
  @end_time
end

#kind ⇒ String

Distinguishes between spans generated in a particular context. For example, two spans with the same name may be distinguished using RPC_CLIENT and RPC_SERVER to identify queueing latency associated with the span. Corresponds to the JSON property kind

Returns:

  • (String) 


67
68
69
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 67

def kind
  @kind
end

#labels ⇒ Hash<String,String>

Collection of labels associated with the span. Label keys must be less than 128 bytes. Label values must be less than 16 kilobytes. Corresponds to the JSON property labels

Returns:

  • (Hash<String,String>) 


73
74
75
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 73

def labels
  @labels
end

#name ⇒ String

Name of the span. Must be less than 128 bytes. The span name is sanitized and displayed in the Stackdriver Trace tool in the % dynamic print site_values.console_name %. The name may be a method name or some other per-call site name. For the same executable and the same call point, a best practice is to use a consistent name, which makes it easier to correlate cross-trace spans. Corresponds to the JSON property name

Returns:

  • (String) 


84
85
86
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 84

def name
  @name
end

#parent_span_id ⇒ String

ID of the parent span, if any. Optional. Corresponds to the JSON property parentSpanId

Returns:

  • (String) 


95
96
97
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 95

def parent_span_id
  @parent_span_id
end

#span_id ⇒ String

Identifier for the span. Must be a 64-bit integer other than 0 and unique within a trace. Corresponds to the JSON property spanId

Returns:

  • (String) 


90
91
92
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 90

def span_id
  @span_id
end

#start_time ⇒ String

Start time of the span in nanoseconds from the UNIX epoch. Corresponds to the JSON property startTime

Returns:

  • (String) 


60
61
62
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 60

def start_time
  @start_time
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



102
103
104
105
106
107
108
109
110
 
# File 'generated/google/apis/cloudtrace_v1/classes.rb', line 102

def update!(**args)
  @end_time = args[:end_time] if args.key?(:end_time)
  @start_time = args[:start_time] if args.key?(:start_time)
  @kind = args[:kind] if args.key?(:kind)
  @labels = args[:labels] if args.key?(:labels)
  @name = args[:name] if args.key?(:name)
  @span_id = args[:span_id] if args.key?(:span_id)
  @parent_span_id = args[:parent_span_id] if args.key?(:parent_span_id)
end