2015-12-03 01:10:07 +00:00
|
|
|
# Copyright 2015 Google Inc.
|
|
|
|
#
|
|
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
# you may not use this file except in compliance with the License.
|
|
|
|
# You may obtain a copy of the License at
|
|
|
|
#
|
|
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
#
|
|
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
# See the License for the specific language governing permissions and
|
|
|
|
# limitations under the License.
|
|
|
|
|
|
|
|
require 'date'
|
|
|
|
require 'google/apis/core/base_service'
|
|
|
|
require 'google/apis/core/json_representation'
|
|
|
|
require 'google/apis/core/hashable'
|
|
|
|
require 'google/apis/errors'
|
|
|
|
|
|
|
|
module Google
|
|
|
|
module Apis
|
|
|
|
module CloudtraceV1
|
|
|
|
|
2017-02-13 23:28:52 +00:00
|
|
|
# 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.
|
|
|
|
class TraceSpan
|
2015-12-03 01:10:07 +00:00
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2017-02-13 23:28:52 +00:00
|
|
|
# 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`
|
|
|
|
# @return [Hash<String,String>]
|
|
|
|
attr_accessor :labels
|
|
|
|
|
|
|
|
# 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.
|
2015-12-03 01:10:07 +00:00
|
|
|
# Corresponds to the JSON property `name`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :name
|
|
|
|
|
2017-02-13 23:28:52 +00:00
|
|
|
# Identifier for the span. Must be a 64-bit integer other than 0 and
|
|
|
|
# unique within a trace.
|
|
|
|
# Corresponds to the JSON property `spanId`
|
2015-12-03 01:10:07 +00:00
|
|
|
# @return [String]
|
2017-02-13 23:28:52 +00:00
|
|
|
attr_accessor :span_id
|
2015-12-03 01:10:07 +00:00
|
|
|
|
2015-12-14 22:27:57 +00:00
|
|
|
# ID of the parent span, if any. Optional.
|
2015-12-03 01:10:07 +00:00
|
|
|
# Corresponds to the JSON property `parentSpanId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :parent_span_id
|
|
|
|
|
2017-03-10 21:11:09 +00:00
|
|
|
# End time of the span in nanoseconds from the UNIX epoch.
|
|
|
|
# Corresponds to the JSON property `endTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :end_time
|
|
|
|
|
|
|
|
# Start time of the span in nanoseconds from the UNIX epoch.
|
|
|
|
# Corresponds to the JSON property `startTime`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :start_time
|
|
|
|
|
|
|
|
# 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`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :kind
|
|
|
|
|
2015-12-03 01:10:07 +00:00
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
2017-02-13 23:28:52 +00:00
|
|
|
@labels = args[:labels] if args.key?(:labels)
|
2016-01-29 22:32:46 +00:00
|
|
|
@name = args[:name] if args.key?(:name)
|
2017-02-13 23:28:52 +00:00
|
|
|
@span_id = args[:span_id] if args.key?(:span_id)
|
2016-01-29 22:32:46 +00:00
|
|
|
@parent_span_id = args[:parent_span_id] if args.key?(:parent_span_id)
|
2017-03-10 21:11:09 +00:00
|
|
|
@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)
|
2015-12-03 01:10:07 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2017-02-13 23:28:52 +00:00
|
|
|
# The response message for the `ListTraces` method.
|
|
|
|
class ListTracesResponse
|
2015-12-03 01:10:07 +00:00
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
2017-02-13 23:28:52 +00:00
|
|
|
# List of trace records returned.
|
2015-12-03 01:10:07 +00:00
|
|
|
# Corresponds to the JSON property `traces`
|
|
|
|
# @return [Array<Google::Apis::CloudtraceV1::Trace>]
|
|
|
|
attr_accessor :traces
|
|
|
|
|
2017-02-13 23:28:52 +00:00
|
|
|
# If defined, indicates that there are more traces that match the request
|
|
|
|
# and that this value should be passed to the next request to continue
|
|
|
|
# retrieving additional traces.
|
|
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :next_page_token
|
|
|
|
|
2015-12-03 01:10:07 +00:00
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
2016-01-29 22:32:46 +00:00
|
|
|
@traces = args[:traces] if args.key?(:traces)
|
2017-02-13 23:28:52 +00:00
|
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
2015-12-03 01:10:07 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2017-02-13 23:28:52 +00:00
|
|
|
# A generic empty message that you can re-use to avoid defining duplicated
|
|
|
|
# empty messages in your APIs. A typical example is to use it as the request
|
|
|
|
# or the response type of an API method. For instance:
|
|
|
|
# service Foo `
|
|
|
|
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
|
|
|
|
# `
|
|
|
|
# The JSON representation for `Empty` is empty JSON object ````.
|
2015-12-03 01:10:07 +00:00
|
|
|
class Empty
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
end
|
|
|
|
end
|
2017-02-13 23:28:52 +00:00
|
|
|
|
|
|
|
# A trace describes how long it takes for an application to perform an
|
|
|
|
# operation. It consists of a set of spans, each of which represent a single
|
|
|
|
# timed event within the operation.
|
|
|
|
class Trace
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# Project ID of the Cloud project where the trace data is stored.
|
|
|
|
# Corresponds to the JSON property `projectId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :project_id
|
|
|
|
|
|
|
|
# Collection of spans in the trace.
|
|
|
|
# Corresponds to the JSON property `spans`
|
|
|
|
# @return [Array<Google::Apis::CloudtraceV1::TraceSpan>]
|
|
|
|
attr_accessor :spans
|
|
|
|
|
|
|
|
# Globally unique identifier for the trace. This identifier is a 128-bit
|
|
|
|
# numeric value formatted as a 32-byte hex string.
|
|
|
|
# Corresponds to the JSON property `traceId`
|
|
|
|
# @return [String]
|
|
|
|
attr_accessor :trace_id
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@project_id = args[:project_id] if args.key?(:project_id)
|
|
|
|
@spans = args[:spans] if args.key?(:spans)
|
|
|
|
@trace_id = args[:trace_id] if args.key?(:trace_id)
|
|
|
|
end
|
|
|
|
end
|
2017-03-10 21:11:09 +00:00
|
|
|
|
|
|
|
# List of new or updated traces.
|
|
|
|
class Traces
|
|
|
|
include Google::Apis::Core::Hashable
|
|
|
|
|
|
|
|
# List of traces.
|
|
|
|
# Corresponds to the JSON property `traces`
|
|
|
|
# @return [Array<Google::Apis::CloudtraceV1::Trace>]
|
|
|
|
attr_accessor :traces
|
|
|
|
|
|
|
|
def initialize(**args)
|
|
|
|
update!(**args)
|
|
|
|
end
|
|
|
|
|
|
|
|
# Update properties of this object
|
|
|
|
def update!(**args)
|
|
|
|
@traces = args[:traces] if args.key?(:traces)
|
|
|
|
end
|
|
|
|
end
|
2015-12-03 01:10:07 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|