1406 lines
59 KiB
Ruby
1406 lines
59 KiB
Ruby
# 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 MonitoringV3
|
|
|
|
# A specific metric identified by specifying values for all of the
|
|
# labels of a `MetricDescriptor`.
|
|
class Metric
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The set of labels that uniquely identify a metric. To specify a
|
|
# metric, all labels enumerated in the `MetricDescriptor` must be
|
|
# assigned values.
|
|
# Corresponds to the JSON property `labels`
|
|
# @return [Hash<String,String>]
|
|
attr_accessor :labels
|
|
|
|
# An existing metric type, see google.api.MetricDescriptor.
|
|
# For example, `compute.googleapis.com/instance/cpu/usage_time`.
|
|
# Corresponds to the JSON property `type`
|
|
# @return [String]
|
|
attr_accessor :type
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@labels = args[:labels] if args.key?(:labels)
|
|
@type = args[:type] if args.key?(:type)
|
|
end
|
|
end
|
|
|
|
# The `ListGroupMembers` response.
|
|
class ListGroupMembersResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A set of monitored resources in the group.
|
|
# Corresponds to the JSON property `members`
|
|
# @return [Array<Google::Apis::MonitoringV3::MonitoredResource>]
|
|
attr_accessor :members
|
|
|
|
# If there are more results than have been returned, then this field is
|
|
# set to a non-empty value. To see the additional results, use that value as
|
|
# `pageToken` in the next call to this method.
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
# @return [String]
|
|
attr_accessor :next_page_token
|
|
|
|
# The total number of elements matching this request.
|
|
# Corresponds to the JSON property `totalSize`
|
|
# @return [Fixnum]
|
|
attr_accessor :total_size
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@members = args[:members] if args.key?(:members)
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
@total_size = args[:total_size] if args.key?(:total_size)
|
|
end
|
|
end
|
|
|
|
# A time interval extending from after `startTime` through `endTime`. If
|
|
# `startTime` is omitted, the interval is the single point in time, `endTime`.
|
|
class TimeInterval
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Required. The end of the interval. The interval includes this
|
|
# time.
|
|
# Corresponds to the JSON property `endTime`
|
|
# @return [String]
|
|
attr_accessor :end_time
|
|
|
|
# If this value is omitted, the interval is a point in time,
|
|
# `endTime`. If `startTime` is present, it must be earlier than
|
|
# (less than) `endTime`. The interval begins after
|
|
# `startTime`—it does not include `startTime`.
|
|
# Corresponds to the JSON property `startTime`
|
|
# @return [String]
|
|
attr_accessor :start_time
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@end_time = args[:end_time] if args.key?(:end_time)
|
|
@start_time = args[:start_time] if args.key?(:start_time)
|
|
end
|
|
end
|
|
|
|
# The description of a dynamic collection of monitored resources. Each group
|
|
# has a filter that is matched against monitored resources and their associated
|
|
# metadata. If a group's filter matches an available monitored resource, then
|
|
# that resource is a member of that group. Groups can contain any number of
|
|
# monitored resources, and each monitored resource can be a member of any
|
|
# number of groups.
|
|
# Groups can be nested in parent-child hierarchies. The `parentName` field
|
|
# identifies an optional parent for each group. If a group has a parent, then
|
|
# the only monitored resources available to be matched by the group's filter
|
|
# are the resources contained in the parent group. In other words, a group
|
|
# contains the monitored resources that match its filter and the filters of all
|
|
# the group's ancestors. A group without a parent can contain any monitored
|
|
# resource.
|
|
# For example, consider an infrastructure running a set of instances with two
|
|
# user-defined tags: `"environment"` and `"role"`. A parent group has a filter,
|
|
# `environment="production"`. A child of that parent group has a filter,
|
|
# `role="transcoder"`. The parent group contains all instances in the
|
|
# production environment, regardless of their roles. The child group contains
|
|
# instances that have the transcoder role *and* are in the production
|
|
# environment.
|
|
# The monitored resources contained in a group can change at any moment,
|
|
# depending on what resources exist and what filters are associated with the
|
|
# group and its ancestors.
|
|
class Group
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A user-assigned name for this group, used only for display purposes.
|
|
# Corresponds to the JSON property `displayName`
|
|
# @return [String]
|
|
attr_accessor :display_name
|
|
|
|
# The name of the group's parent, if it has one.
|
|
# The format is `"projects/`project_id_or_number`/groups/`group_id`"`.
|
|
# For groups with no parent, `parentName` is the empty string, `""`.
|
|
# Corresponds to the JSON property `parentName`
|
|
# @return [String]
|
|
attr_accessor :parent_name
|
|
|
|
# If true, the members of this group are considered to be a cluster.
|
|
# The system can perform additional analysis on groups that are clusters.
|
|
# Corresponds to the JSON property `isCluster`
|
|
# @return [Boolean]
|
|
attr_accessor :is_cluster
|
|
alias_method :is_cluster?, :is_cluster
|
|
|
|
# The filter used to determine which monitored resources belong to this group.
|
|
# Corresponds to the JSON property `filter`
|
|
# @return [String]
|
|
attr_accessor :filter
|
|
|
|
# The name of this group.
|
|
# The format is
|
|
# `"projects/`project_id_or_number`/groups/`group_id`"`.
|
|
# When creating a group, this field is ignored and a new name is created
|
|
# consisting of the project specified in the call to `CreateGroup`
|
|
# and a unique ``group_id`` that is generated automatically.
|
|
# @OutputOnly
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@display_name = args[:display_name] if args.key?(:display_name)
|
|
@parent_name = args[:parent_name] if args.key?(:parent_name)
|
|
@is_cluster = args[:is_cluster] if args.key?(:is_cluster)
|
|
@filter = args[:filter] if args.key?(:filter)
|
|
@name = args[:name] if args.key?(:name)
|
|
end
|
|
end
|
|
|
|
# The `ListTimeSeries` response.
|
|
class ListTimeSeriesResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# One or more time series that match the filter included in the request.
|
|
# Corresponds to the JSON property `timeSeries`
|
|
# @return [Array<Google::Apis::MonitoringV3::TimeSeries>]
|
|
attr_accessor :time_series
|
|
|
|
# If there are more results than have been returned, then this field is set
|
|
# to a non-empty value. To see the additional results,
|
|
# use that value as `pageToken` in the next call to this method.
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
# @return [String]
|
|
attr_accessor :next_page_token
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@time_series = args[:time_series] if args.key?(:time_series)
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
end
|
|
end
|
|
|
|
# A single data point in a time series.
|
|
class Point
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A single strongly-typed value.
|
|
# Corresponds to the JSON property `value`
|
|
# @return [Google::Apis::MonitoringV3::TypedValue]
|
|
attr_accessor :value
|
|
|
|
# A time interval extending from after `startTime` through `endTime`. If
|
|
# `startTime` is omitted, the interval is the single point in time, `endTime`.
|
|
# Corresponds to the JSON property `interval`
|
|
# @return [Google::Apis::MonitoringV3::TimeInterval]
|
|
attr_accessor :interval
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@value = args[:value] if args.key?(:value)
|
|
@interval = args[:interval] if args.key?(:interval)
|
|
end
|
|
end
|
|
|
|
# A single data point from a `collectd`-based plugin.
|
|
class CollectdValue
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A single strongly-typed value.
|
|
# Corresponds to the JSON property `value`
|
|
# @return [Google::Apis::MonitoringV3::TypedValue]
|
|
attr_accessor :value
|
|
|
|
# The data source for the `collectd` value. For example there are
|
|
# two data sources for network measurements: `"rx"` and `"tx"`.
|
|
# Corresponds to the JSON property `dataSourceName`
|
|
# @return [String]
|
|
attr_accessor :data_source_name
|
|
|
|
# The type of measurement.
|
|
# Corresponds to the JSON property `dataSourceType`
|
|
# @return [String]
|
|
attr_accessor :data_source_type
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@value = args[:value] if args.key?(:value)
|
|
@data_source_name = args[:data_source_name] if args.key?(:data_source_name)
|
|
@data_source_type = args[:data_source_type] if args.key?(:data_source_type)
|
|
end
|
|
end
|
|
|
|
# A collection of data points that describes the time-varying nature
|
|
# of a metric. A time series is identified by a combination of a
|
|
# fully-specified monitored resource and a fully-specified metric.
|
|
class TimeSeries
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A specific metric identified by specifying values for all of the
|
|
# labels of a `MetricDescriptor`.
|
|
# Corresponds to the JSON property `metric`
|
|
# @return [Google::Apis::MonitoringV3::Metric]
|
|
attr_accessor :metric
|
|
|
|
# The data points of this time series. When used as output, points will be
|
|
# sorted by decreasing time order. When used as input, points could be
|
|
# written in any orders.
|
|
# Corresponds to the JSON property `points`
|
|
# @return [Array<Google::Apis::MonitoringV3::Point>]
|
|
attr_accessor :points
|
|
|
|
# The value type of the time series. This can be different than the value
|
|
# type specified in [google.api.MetricDescriptor] because of alignment and
|
|
# reduction operations on the data. This field is ignored when writing data;
|
|
# the value specified in the descriptor is used instead.
|
|
# @OutputOnly
|
|
# Corresponds to the JSON property `valueType`
|
|
# @return [String]
|
|
attr_accessor :value_type
|
|
|
|
# An object representing a resource that can be used for monitoring, logging,
|
|
# billing, or other purposes. Examples include virtual machine instances,
|
|
# databases, and storage devices such as disks. The `type` field identifies a
|
|
# MonitoredResourceDescriptor object that describes the resource's
|
|
# schema. Information in the `labels` field identifies the actual resource and
|
|
# its attributes according to the schema. For example, a particular Compute
|
|
# Engine VM instance could be represented by the following object, because the
|
|
# MonitoredResourceDescriptor for `"gce_instance"` has labels
|
|
# `"instance_id"` and `"zone"`:
|
|
# ` "type": "gce_instance",
|
|
# "labels": ` "instance_id": "12345678901234",
|
|
# "zone": "us-central1-a" ``
|
|
# Corresponds to the JSON property `resource`
|
|
# @return [Google::Apis::MonitoringV3::MonitoredResource]
|
|
attr_accessor :resource
|
|
|
|
# The metric kind of the time series. This can be different than the metric
|
|
# kind specified in [google.api.MetricDescriptor] because of alignment and
|
|
# reduction operations on the data. This field is ignored when writing data;
|
|
# the value specified in the descriptor is used instead.
|
|
# @OutputOnly
|
|
# Corresponds to the JSON property `metricKind`
|
|
# @return [String]
|
|
attr_accessor :metric_kind
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@metric = args[:metric] if args.key?(:metric)
|
|
@points = args[:points] if args.key?(:points)
|
|
@value_type = args[:value_type] if args.key?(:value_type)
|
|
@resource = args[:resource] if args.key?(:resource)
|
|
@metric_kind = args[:metric_kind] if args.key?(:metric_kind)
|
|
end
|
|
end
|
|
|
|
# Defines a metric type and its schema.
|
|
class MetricDescriptor
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A detailed description of the metric, which can be used in documentation.
|
|
# Corresponds to the JSON property `description`
|
|
# @return [String]
|
|
attr_accessor :description
|
|
|
|
# The unit in which the metric value is reported. It is only applicable
|
|
# if the `value_type` is `INT64`, `DOUBLE`, or `DISTRIBUTION`. The
|
|
# supported units are a subset of [The Unified Code for Units of
|
|
# Measure](http://unitsofmeasure.org/ucum.html) standard:
|
|
# **Basic units (UNIT)**
|
|
# * `bit` bit
|
|
# * `By` byte
|
|
# * `s` second
|
|
# * `min` minute
|
|
# * `h` hour
|
|
# * `d` day
|
|
# **Prefixes (PREFIX)**
|
|
# * `k` kilo (10**3)
|
|
# * `M` mega (10**6)
|
|
# * `G` giga (10**9)
|
|
# * `T` tera (10**12)
|
|
# * `P` peta (10**15)
|
|
# * `E` exa (10**18)
|
|
# * `Z` zetta (10**21)
|
|
# * `Y` yotta (10**24)
|
|
# * `m` milli (10**-3)
|
|
# * `u` micro (10**-6)
|
|
# * `n` nano (10**-9)
|
|
# * `p` pico (10**-12)
|
|
# * `f` femto (10**-15)
|
|
# * `a` atto (10**-18)
|
|
# * `z` zepto (10**-21)
|
|
# * `y` yocto (10**-24)
|
|
# * `Ki` kibi (2**10)
|
|
# * `Mi` mebi (2**20)
|
|
# * `Gi` gibi (2**30)
|
|
# * `Ti` tebi (2**40)
|
|
# **Grammar**
|
|
# The grammar includes the dimensionless unit `1`, such as `1/s`.
|
|
# The grammar also includes these connectors:
|
|
# * `/` division (as an infix operator, e.g. `1/s`).
|
|
# * `.` multiplication (as an infix operator, e.g. `GBy.d`)
|
|
# The grammar for a unit is as follows:
|
|
# Expression = Component ` "." Component ` ` "/" Component ` ;
|
|
# Component = [ PREFIX ] UNIT [ Annotation ]
|
|
# | Annotation
|
|
# | "1"
|
|
# ;
|
|
# Annotation = "`" NAME "`" ;
|
|
# Notes:
|
|
# * `Annotation` is just a comment if it follows a `UNIT` and is
|
|
# equivalent to `1` if it is used alone. For examples,
|
|
# ``requests`/s == 1/s`, `By`transmitted`/s == By/s`.
|
|
# * `NAME` is a sequence of non-blank printable ASCII characters not
|
|
# containing '`' or '`'.
|
|
# Corresponds to the JSON property `unit`
|
|
# @return [String]
|
|
attr_accessor :unit
|
|
|
|
# The set of labels that can be used to describe a specific instance of this
|
|
# metric type. For example, the
|
|
# `compute.googleapis.com/instance/network/received_bytes_count` metric type
|
|
# has a label, `loadbalanced`, that specifies whether the traffic was
|
|
# received through a load balanced IP address.
|
|
# Corresponds to the JSON property `labels`
|
|
# @return [Array<Google::Apis::MonitoringV3::LabelDescriptor>]
|
|
attr_accessor :labels
|
|
|
|
# Whether the metric records instantaneous values, changes to a value, etc.
|
|
# Corresponds to the JSON property `metricKind`
|
|
# @return [String]
|
|
attr_accessor :metric_kind
|
|
|
|
# Whether the measurement is an integer, a floating-point number, etc.
|
|
# Corresponds to the JSON property `valueType`
|
|
# @return [String]
|
|
attr_accessor :value_type
|
|
|
|
# A concise name for the metric, which can be displayed in user interfaces.
|
|
# Use sentence case without an ending period, for example "Request count".
|
|
# Corresponds to the JSON property `displayName`
|
|
# @return [String]
|
|
attr_accessor :display_name
|
|
|
|
# Resource name. The format of the name may vary between different
|
|
# implementations. For examples:
|
|
# projects/`project_id`/metricDescriptors/`type=**`
|
|
# metricDescriptors/`type=**`
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
# The metric type including a DNS name prefix, for example
|
|
# `"compute.googleapis.com/instance/cpu/utilization"`. Metric types
|
|
# should use a natural hierarchical grouping such as the following:
|
|
# compute.googleapis.com/instance/cpu/utilization
|
|
# compute.googleapis.com/instance/disk/read_ops_count
|
|
# compute.googleapis.com/instance/network/received_bytes_count
|
|
# Note that if the metric type changes, the monitoring data will be
|
|
# discontinued, and anything depends on it will break, such as monitoring
|
|
# dashboards, alerting rules and quota limits. Therefore, once a metric has
|
|
# been published, its type should be immutable.
|
|
# Corresponds to the JSON property `type`
|
|
# @return [String]
|
|
attr_accessor :type
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@description = args[:description] if args.key?(:description)
|
|
@unit = args[:unit] if args.key?(:unit)
|
|
@labels = args[:labels] if args.key?(:labels)
|
|
@metric_kind = args[:metric_kind] if args.key?(:metric_kind)
|
|
@value_type = args[:value_type] if args.key?(:value_type)
|
|
@display_name = args[:display_name] if args.key?(:display_name)
|
|
@name = args[:name] if args.key?(:name)
|
|
@type = args[:type] if args.key?(:type)
|
|
end
|
|
end
|
|
|
|
# Specify a sequence of buckets that have a width that is proportional to
|
|
# the value of the lower bound. Each bucket represents a constant relative
|
|
# uncertainty on a specific value in the bucket.
|
|
# Defines `num_finite_buckets + 2` (= N) buckets with these boundaries for
|
|
# bucket i:
|
|
# Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).
|
|
# Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)).
|
|
class Exponential
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Must be greater than 1.
|
|
# Corresponds to the JSON property `growthFactor`
|
|
# @return [Float]
|
|
attr_accessor :growth_factor
|
|
|
|
# Must be greater than 0.
|
|
# Corresponds to the JSON property `scale`
|
|
# @return [Float]
|
|
attr_accessor :scale
|
|
|
|
# Must be greater than 0.
|
|
# Corresponds to the JSON property `numFiniteBuckets`
|
|
# @return [Fixnum]
|
|
attr_accessor :num_finite_buckets
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@growth_factor = args[:growth_factor] if args.key?(:growth_factor)
|
|
@scale = args[:scale] if args.key?(:scale)
|
|
@num_finite_buckets = args[:num_finite_buckets] if args.key?(:num_finite_buckets)
|
|
end
|
|
end
|
|
|
|
# A set of buckets with arbitrary widths.
|
|
# Defines `size(bounds) + 1` (= N) buckets with these boundaries for
|
|
# bucket i:
|
|
# Upper bound (0 <= i < N-1): bounds[i]
|
|
# Lower bound (1 <= i < N); bounds[i - 1]
|
|
# There must be at least one element in `bounds`. If `bounds` has only one
|
|
# element, there are no finite buckets, and that single element is the
|
|
# common boundary of the overflow and underflow buckets.
|
|
class Explicit
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The values must be monotonically increasing.
|
|
# Corresponds to the JSON property `bounds`
|
|
# @return [Array<Float>]
|
|
attr_accessor :bounds
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@bounds = args[:bounds] if args.key?(:bounds)
|
|
end
|
|
end
|
|
|
|
# Specify a sequence of buckets that all have the same width (except
|
|
# overflow and underflow). Each bucket represents a constant absolute
|
|
# uncertainty on the specific value in the bucket.
|
|
# Defines `num_finite_buckets + 2` (= N) buckets with these boundaries for
|
|
# bucket `i`:
|
|
# Upper bound (0 <= i < N-1): offset + (width * i).
|
|
# Lower bound (1 <= i < N): offset + (width * (i - 1)).
|
|
class Linear
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Must be greater than 0.
|
|
# Corresponds to the JSON property `width`
|
|
# @return [Float]
|
|
attr_accessor :width
|
|
|
|
# Lower bound of the first bucket.
|
|
# Corresponds to the JSON property `offset`
|
|
# @return [Float]
|
|
attr_accessor :offset
|
|
|
|
# Must be greater than 0.
|
|
# Corresponds to the JSON property `numFiniteBuckets`
|
|
# @return [Fixnum]
|
|
attr_accessor :num_finite_buckets
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@width = args[:width] if args.key?(:width)
|
|
@offset = args[:offset] if args.key?(:offset)
|
|
@num_finite_buckets = args[:num_finite_buckets] if args.key?(:num_finite_buckets)
|
|
end
|
|
end
|
|
|
|
# A collection of data points sent from a `collectd`-based plugin.
|
|
# See the `collectd` documentation for more information.
|
|
class CollectdPayload
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The end time of the interval.
|
|
# Corresponds to the JSON property `endTime`
|
|
# @return [String]
|
|
attr_accessor :end_time
|
|
|
|
# The measurement metadata. Example: `"process_id" -> 12345`
|
|
# Corresponds to the JSON property `metadata`
|
|
# @return [Hash<String,Google::Apis::MonitoringV3::TypedValue>]
|
|
attr_accessor :metadata
|
|
|
|
# The measured values during this time interval.
|
|
# Each value must have a different `dataSourceName`.
|
|
# Corresponds to the JSON property `values`
|
|
# @return [Array<Google::Apis::MonitoringV3::CollectdValue>]
|
|
attr_accessor :values
|
|
|
|
# The instance name of the plugin Example: `"hdcl"`.
|
|
# Corresponds to the JSON property `pluginInstance`
|
|
# @return [String]
|
|
attr_accessor :plugin_instance
|
|
|
|
# The start time of the interval.
|
|
# Corresponds to the JSON property `startTime`
|
|
# @return [String]
|
|
attr_accessor :start_time
|
|
|
|
# The measurement type instance. Example: `"used"`.
|
|
# Corresponds to the JSON property `typeInstance`
|
|
# @return [String]
|
|
attr_accessor :type_instance
|
|
|
|
# The measurement type. Example: `"memory"`.
|
|
# Corresponds to the JSON property `type`
|
|
# @return [String]
|
|
attr_accessor :type
|
|
|
|
# The name of the plugin. Example: `"disk"`.
|
|
# Corresponds to the JSON property `plugin`
|
|
# @return [String]
|
|
attr_accessor :plugin
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@end_time = args[:end_time] if args.key?(:end_time)
|
|
@metadata = args[:metadata] if args.key?(:metadata)
|
|
@values = args[:values] if args.key?(:values)
|
|
@plugin_instance = args[:plugin_instance] if args.key?(:plugin_instance)
|
|
@start_time = args[:start_time] if args.key?(:start_time)
|
|
@type_instance = args[:type_instance] if args.key?(:type_instance)
|
|
@type = args[:type] if args.key?(:type)
|
|
@plugin = args[:plugin] if args.key?(:plugin)
|
|
end
|
|
end
|
|
|
|
# The `ListMetricDescriptors` response.
|
|
class ListMetricDescriptorsResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The metric descriptors that are available to the project
|
|
# and that match the value of `filter`, if present.
|
|
# Corresponds to the JSON property `metricDescriptors`
|
|
# @return [Array<Google::Apis::MonitoringV3::MetricDescriptor>]
|
|
attr_accessor :metric_descriptors
|
|
|
|
# If there are more results than have been returned, then this field is set
|
|
# to a non-empty value. To see the additional results,
|
|
# use that value as `pageToken` in the next call to this method.
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
# @return [String]
|
|
attr_accessor :next_page_token
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@metric_descriptors = args[:metric_descriptors] if args.key?(:metric_descriptors)
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
end
|
|
end
|
|
|
|
# Distribution contains summary statistics for a population of values and,
|
|
# optionally, a histogram representing the distribution of those values across
|
|
# a specified set of histogram buckets.
|
|
# The summary statistics are the count, mean, sum of the squared deviation from
|
|
# the mean, the minimum, and the maximum of the set of population of values.
|
|
# The histogram is based on a sequence of buckets and gives a count of values
|
|
# that fall into each bucket. The boundaries of the buckets are given either
|
|
# explicitly or by specifying parameters for a method of computing them
|
|
# (buckets of fixed width or buckets of exponentially increasing width).
|
|
# Although it is not forbidden, it is generally a bad idea to include
|
|
# non-finite values (infinities or NaNs) in the population of values, as this
|
|
# will render the `mean` and `sum_of_squared_deviation` fields meaningless.
|
|
class Distribution
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# If `bucket_options` is given, then the sum of the values in `bucket_counts`
|
|
# must equal the value in `count`. If `bucket_options` is not given, no
|
|
# `bucket_counts` fields may be given.
|
|
# Bucket counts are given in order under the numbering scheme described
|
|
# above (the underflow bucket has number 0; the finite buckets, if any,
|
|
# have numbers 1 through N-2; the overflow bucket has number N-1).
|
|
# The size of `bucket_counts` must be no greater than N as defined in
|
|
# `bucket_options`.
|
|
# Any suffix of trailing zero bucket_count fields may be omitted.
|
|
# Corresponds to the JSON property `bucketCounts`
|
|
# @return [Array<String>]
|
|
attr_accessor :bucket_counts
|
|
|
|
# A Distribution may optionally contain a histogram of the values in the
|
|
# population. The histogram is given in `bucket_counts` as counts of values
|
|
# that fall into one of a sequence of non-overlapping buckets. The sequence
|
|
# of buckets is described by `bucket_options`.
|
|
# A bucket specifies an inclusive lower bound and exclusive upper bound for
|
|
# the values that are counted for that bucket. The upper bound of a bucket
|
|
# is strictly greater than the lower bound.
|
|
# The sequence of N buckets for a Distribution consists of an underflow
|
|
# bucket (number 0), zero or more finite buckets (number 1 through N - 2) and
|
|
# an overflow bucket (number N - 1). The buckets are contiguous: the lower
|
|
# bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1.
|
|
# The buckets span the whole range of finite values: lower bound of the
|
|
# underflow bucket is -infinity and the upper bound of the overflow bucket is
|
|
# +infinity. The finite buckets are so-called because both bounds are
|
|
# finite.
|
|
# `BucketOptions` describes bucket boundaries in one of three ways. Two
|
|
# describe the boundaries by giving parameters for a formula to generate
|
|
# boundaries and one gives the bucket boundaries explicitly.
|
|
# If `bucket_boundaries` is not given, then no `bucket_counts` may be given.
|
|
# Corresponds to the JSON property `bucketOptions`
|
|
# @return [Google::Apis::MonitoringV3::BucketOptions]
|
|
attr_accessor :bucket_options
|
|
|
|
# The number of values in the population. Must be non-negative.
|
|
# Corresponds to the JSON property `count`
|
|
# @return [String]
|
|
attr_accessor :count
|
|
|
|
# The sum of squared deviations from the mean of the values in the
|
|
# population. For values x_i this is:
|
|
# Sum[i=1..n]((x_i - mean)^2)
|
|
# Knuth, "The Art of Computer Programming", Vol. 2, page 323, 3rd edition
|
|
# describes Welford's method for accumulating this sum in one pass.
|
|
# If `count` is zero then this field must be zero.
|
|
# Corresponds to the JSON property `sumOfSquaredDeviation`
|
|
# @return [Float]
|
|
attr_accessor :sum_of_squared_deviation
|
|
|
|
# The arithmetic mean of the values in the population. If `count` is zero
|
|
# then this field must be zero.
|
|
# Corresponds to the JSON property `mean`
|
|
# @return [Float]
|
|
attr_accessor :mean
|
|
|
|
# The range of the population values.
|
|
# Corresponds to the JSON property `range`
|
|
# @return [Google::Apis::MonitoringV3::Range]
|
|
attr_accessor :range
|
|
|
|
# Must be in increasing order of |value| field. The current requirement
|
|
# enforced by the backend is that at most one Exemplar will fall into any
|
|
# bucket.
|
|
# Corresponds to the JSON property `exemplars`
|
|
# @return [Array<Google::Apis::MonitoringV3::Exemplar>]
|
|
attr_accessor :exemplars
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@bucket_counts = args[:bucket_counts] if args.key?(:bucket_counts)
|
|
@bucket_options = args[:bucket_options] if args.key?(:bucket_options)
|
|
@count = args[:count] if args.key?(:count)
|
|
@sum_of_squared_deviation = args[:sum_of_squared_deviation] if args.key?(:sum_of_squared_deviation)
|
|
@mean = args[:mean] if args.key?(:mean)
|
|
@range = args[:range] if args.key?(:range)
|
|
@exemplars = args[:exemplars] if args.key?(:exemplars)
|
|
end
|
|
end
|
|
|
|
# An object representing a resource that can be used for monitoring, logging,
|
|
# billing, or other purposes. Examples include virtual machine instances,
|
|
# databases, and storage devices such as disks. The `type` field identifies a
|
|
# MonitoredResourceDescriptor object that describes the resource's
|
|
# schema. Information in the `labels` field identifies the actual resource and
|
|
# its attributes according to the schema. For example, a particular Compute
|
|
# Engine VM instance could be represented by the following object, because the
|
|
# MonitoredResourceDescriptor for `"gce_instance"` has labels
|
|
# `"instance_id"` and `"zone"`:
|
|
# ` "type": "gce_instance",
|
|
# "labels": ` "instance_id": "12345678901234",
|
|
# "zone": "us-central1-a" ``
|
|
class MonitoredResource
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Required. Values for all of the labels listed in the associated monitored
|
|
# resource descriptor. For example, Cloud SQL databases use the labels
|
|
# `"database_id"` and `"zone"`.
|
|
# Corresponds to the JSON property `labels`
|
|
# @return [Hash<String,String>]
|
|
attr_accessor :labels
|
|
|
|
# Required. The monitored resource type. This field must match
|
|
# the `type` field of a MonitoredResourceDescriptor object. For
|
|
# example, the type of a Cloud SQL database is `"cloudsql_database"`.
|
|
# Corresponds to the JSON property `type`
|
|
# @return [String]
|
|
attr_accessor :type
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@labels = args[:labels] if args.key?(:labels)
|
|
@type = args[:type] if args.key?(:type)
|
|
end
|
|
end
|
|
|
|
# A description of a label.
|
|
class LabelDescriptor
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A human-readable description for the label.
|
|
# Corresponds to the JSON property `description`
|
|
# @return [String]
|
|
attr_accessor :description
|
|
|
|
# The type of data that can be assigned to the label.
|
|
# Corresponds to the JSON property `valueType`
|
|
# @return [String]
|
|
attr_accessor :value_type
|
|
|
|
# The label key.
|
|
# Corresponds to the JSON property `key`
|
|
# @return [String]
|
|
attr_accessor :key
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@description = args[:description] if args.key?(:description)
|
|
@value_type = args[:value_type] if args.key?(:value_type)
|
|
@key = args[:key] if args.key?(:key)
|
|
end
|
|
end
|
|
|
|
# An object that describes the schema of a MonitoredResource object using a
|
|
# type name and a set of labels. For example, the monitored resource
|
|
# descriptor for Google Compute Engine VM instances has a type of
|
|
# `"gce_instance"` and specifies the use of the labels `"instance_id"` and
|
|
# `"zone"` to identify particular VM instances.
|
|
# Different APIs can support different monitored resource types. APIs generally
|
|
# provide a `list` method that returns the monitored resource descriptors used
|
|
# by the API.
|
|
class MonitoredResourceDescriptor
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Optional. A concise name for the monitored resource type that might be
|
|
# displayed in user interfaces. For example, `"Google Cloud SQL Database"`.
|
|
# Corresponds to the JSON property `displayName`
|
|
# @return [String]
|
|
attr_accessor :display_name
|
|
|
|
# Optional. A detailed description of the monitored resource type that might
|
|
# be used in documentation.
|
|
# Corresponds to the JSON property `description`
|
|
# @return [String]
|
|
attr_accessor :description
|
|
|
|
# Required. A set of labels used to describe instances of this monitored
|
|
# resource type. For example, an individual Google Cloud SQL database is
|
|
# identified by values for the labels `"database_id"` and `"zone"`.
|
|
# Corresponds to the JSON property `labels`
|
|
# @return [Array<Google::Apis::MonitoringV3::LabelDescriptor>]
|
|
attr_accessor :labels
|
|
|
|
# Required. The monitored resource type. For example, the type
|
|
# `"cloudsql_database"` represents databases in Google Cloud SQL.
|
|
# The maximum length of this value is 256 characters.
|
|
# Corresponds to the JSON property `type`
|
|
# @return [String]
|
|
attr_accessor :type
|
|
|
|
# Optional. The resource name of the monitored resource descriptor:
|
|
# `"projects/`project_id`/monitoredResourceDescriptors/`type`"` where
|
|
# `type` is the value of the `type` field in this object and
|
|
# `project_id` is a project ID that provides API-specific context for
|
|
# accessing the type. APIs that do not use project information can use the
|
|
# resource name format `"monitoredResourceDescriptors/`type`"`.
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@display_name = args[:display_name] if args.key?(:display_name)
|
|
@description = args[:description] if args.key?(:description)
|
|
@labels = args[:labels] if args.key?(:labels)
|
|
@type = args[:type] if args.key?(:type)
|
|
@name = args[:name] if args.key?(:name)
|
|
end
|
|
end
|
|
|
|
# A single strongly-typed value.
|
|
class TypedValue
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A Boolean value: `true` or `false`.
|
|
# Corresponds to the JSON property `boolValue`
|
|
# @return [Boolean]
|
|
attr_accessor :bool_value
|
|
alias_method :bool_value?, :bool_value
|
|
|
|
# A variable-length string value.
|
|
# Corresponds to the JSON property `stringValue`
|
|
# @return [String]
|
|
attr_accessor :string_value
|
|
|
|
# A 64-bit integer. Its range is approximately ±9.2x10<sup>18</sup>.
|
|
# Corresponds to the JSON property `int64Value`
|
|
# @return [String]
|
|
attr_accessor :int64_value
|
|
|
|
# A 64-bit double-precision floating-point number. Its magnitude
|
|
# is approximately ±10<sup>±300</sup> and it has 16
|
|
# significant digits of precision.
|
|
# Corresponds to the JSON property `doubleValue`
|
|
# @return [Float]
|
|
attr_accessor :double_value
|
|
|
|
# Distribution contains summary statistics for a population of values and,
|
|
# optionally, a histogram representing the distribution of those values across
|
|
# a specified set of histogram buckets.
|
|
# The summary statistics are the count, mean, sum of the squared deviation from
|
|
# the mean, the minimum, and the maximum of the set of population of values.
|
|
# The histogram is based on a sequence of buckets and gives a count of values
|
|
# that fall into each bucket. The boundaries of the buckets are given either
|
|
# explicitly or by specifying parameters for a method of computing them
|
|
# (buckets of fixed width or buckets of exponentially increasing width).
|
|
# Although it is not forbidden, it is generally a bad idea to include
|
|
# non-finite values (infinities or NaNs) in the population of values, as this
|
|
# will render the `mean` and `sum_of_squared_deviation` fields meaningless.
|
|
# Corresponds to the JSON property `distributionValue`
|
|
# @return [Google::Apis::MonitoringV3::Distribution]
|
|
attr_accessor :distribution_value
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@bool_value = args[:bool_value] if args.key?(:bool_value)
|
|
@string_value = args[:string_value] if args.key?(:string_value)
|
|
@int64_value = args[:int64_value] if args.key?(:int64_value)
|
|
@double_value = args[:double_value] if args.key?(:double_value)
|
|
@distribution_value = args[:distribution_value] if args.key?(:distribution_value)
|
|
end
|
|
end
|
|
|
|
# The `ListMonitoredResourcDescriptors` response.
|
|
class ListMonitoredResourceDescriptorsResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# If there are more results than have been returned, then this field is set
|
|
# to a non-empty value. To see the additional results,
|
|
# use that value as `pageToken` in the next call to this method.
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
# @return [String]
|
|
attr_accessor :next_page_token
|
|
|
|
# The monitored resource descriptors that are available to this project
|
|
# and that match `filter`, if present.
|
|
# Corresponds to the JSON property `resourceDescriptors`
|
|
# @return [Array<Google::Apis::MonitoringV3::MonitoredResourceDescriptor>]
|
|
attr_accessor :resource_descriptors
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
@resource_descriptors = args[:resource_descriptors] if args.key?(:resource_descriptors)
|
|
end
|
|
end
|
|
|
|
# A single field of a message type.
|
|
class Field
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The string value of the default value of this field. Proto2 syntax only.
|
|
# Corresponds to the JSON property `defaultValue`
|
|
# @return [String]
|
|
attr_accessor :default_value
|
|
|
|
# The field JSON name.
|
|
# Corresponds to the JSON property `jsonName`
|
|
# @return [String]
|
|
attr_accessor :json_name
|
|
|
|
# The protocol buffer options.
|
|
# Corresponds to the JSON property `options`
|
|
# @return [Array<Google::Apis::MonitoringV3::Option>]
|
|
attr_accessor :options
|
|
|
|
# The index of the field type in `Type.oneofs`, for message or enumeration
|
|
# types. The first type has index 1; zero means the type is not in the list.
|
|
# Corresponds to the JSON property `oneofIndex`
|
|
# @return [Fixnum]
|
|
attr_accessor :oneof_index
|
|
|
|
# The field cardinality.
|
|
# Corresponds to the JSON property `cardinality`
|
|
# @return [String]
|
|
attr_accessor :cardinality
|
|
|
|
# The field type URL, without the scheme, for message or enumeration
|
|
# types. Example: `"type.googleapis.com/google.protobuf.Timestamp"`.
|
|
# Corresponds to the JSON property `typeUrl`
|
|
# @return [String]
|
|
attr_accessor :type_url
|
|
|
|
# The field name.
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
# Whether to use alternative packed wire representation.
|
|
# Corresponds to the JSON property `packed`
|
|
# @return [Boolean]
|
|
attr_accessor :packed
|
|
alias_method :packed?, :packed
|
|
|
|
# The field number.
|
|
# Corresponds to the JSON property `number`
|
|
# @return [Fixnum]
|
|
attr_accessor :number
|
|
|
|
# The field type.
|
|
# Corresponds to the JSON property `kind`
|
|
# @return [String]
|
|
attr_accessor :kind
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@default_value = args[:default_value] if args.key?(:default_value)
|
|
@json_name = args[:json_name] if args.key?(:json_name)
|
|
@options = args[:options] if args.key?(:options)
|
|
@oneof_index = args[:oneof_index] if args.key?(:oneof_index)
|
|
@cardinality = args[:cardinality] if args.key?(:cardinality)
|
|
@type_url = args[:type_url] if args.key?(:type_url)
|
|
@name = args[:name] if args.key?(:name)
|
|
@packed = args[:packed] if args.key?(:packed)
|
|
@number = args[:number] if args.key?(:number)
|
|
@kind = args[:kind] if args.key?(:kind)
|
|
end
|
|
end
|
|
|
|
# A protocol buffer option, which can be attached to a message, field,
|
|
# enumeration, etc.
|
|
class Option
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The option's value. For example, `"com.google.protobuf"`.
|
|
# Corresponds to the JSON property `value`
|
|
# @return [Hash<String,Object>]
|
|
attr_accessor :value
|
|
|
|
# The option's name. For example, `"java_package"`.
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@value = args[:value] if args.key?(:value)
|
|
@name = args[:name] if args.key?(:name)
|
|
end
|
|
end
|
|
|
|
# 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 ````.
|
|
class Empty
|
|
include Google::Apis::Core::Hashable
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
end
|
|
end
|
|
|
|
# `SourceContext` represents information about the source of a
|
|
# protobuf element, like the file in which it is defined.
|
|
class SourceContext
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The path-qualified name of the .proto file that contained the associated
|
|
# protobuf element. For example: `"google/protobuf/source.proto"`.
|
|
# Corresponds to the JSON property `fileName`
|
|
# @return [String]
|
|
attr_accessor :file_name
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@file_name = args[:file_name] if args.key?(:file_name)
|
|
end
|
|
end
|
|
|
|
# The range of the population values.
|
|
class Range
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The maximum of the population values.
|
|
# Corresponds to the JSON property `max`
|
|
# @return [Float]
|
|
attr_accessor :max
|
|
|
|
# The minimum of the population values.
|
|
# Corresponds to the JSON property `min`
|
|
# @return [Float]
|
|
attr_accessor :min
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@max = args[:max] if args.key?(:max)
|
|
@min = args[:min] if args.key?(:min)
|
|
end
|
|
end
|
|
|
|
# The `CreateTimeSeries` request.
|
|
class CreateTimeSeriesRequest
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The new data to be added to a list of time series.
|
|
# Adds at most one data point to each of several time series. The new data
|
|
# point must be more recent than any other point in its time series. Each
|
|
# `TimeSeries` value must fully specify a unique time series by supplying
|
|
# all label values for the metric and the monitored resource.
|
|
# Corresponds to the JSON property `timeSeries`
|
|
# @return [Array<Google::Apis::MonitoringV3::TimeSeries>]
|
|
attr_accessor :time_series
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@time_series = args[:time_series] if args.key?(:time_series)
|
|
end
|
|
end
|
|
|
|
# A Distribution may optionally contain a histogram of the values in the
|
|
# population. The histogram is given in `bucket_counts` as counts of values
|
|
# that fall into one of a sequence of non-overlapping buckets. The sequence
|
|
# of buckets is described by `bucket_options`.
|
|
# A bucket specifies an inclusive lower bound and exclusive upper bound for
|
|
# the values that are counted for that bucket. The upper bound of a bucket
|
|
# is strictly greater than the lower bound.
|
|
# The sequence of N buckets for a Distribution consists of an underflow
|
|
# bucket (number 0), zero or more finite buckets (number 1 through N - 2) and
|
|
# an overflow bucket (number N - 1). The buckets are contiguous: the lower
|
|
# bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1.
|
|
# The buckets span the whole range of finite values: lower bound of the
|
|
# underflow bucket is -infinity and the upper bound of the overflow bucket is
|
|
# +infinity. The finite buckets are so-called because both bounds are
|
|
# finite.
|
|
# `BucketOptions` describes bucket boundaries in one of three ways. Two
|
|
# describe the boundaries by giving parameters for a formula to generate
|
|
# boundaries and one gives the bucket boundaries explicitly.
|
|
# If `bucket_boundaries` is not given, then no `bucket_counts` may be given.
|
|
class BucketOptions
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# A set of buckets with arbitrary widths.
|
|
# Defines `size(bounds) + 1` (= N) buckets with these boundaries for
|
|
# bucket i:
|
|
# Upper bound (0 <= i < N-1): bounds[i]
|
|
# Lower bound (1 <= i < N); bounds[i - 1]
|
|
# There must be at least one element in `bounds`. If `bounds` has only one
|
|
# element, there are no finite buckets, and that single element is the
|
|
# common boundary of the overflow and underflow buckets.
|
|
# Corresponds to the JSON property `explicitBuckets`
|
|
# @return [Google::Apis::MonitoringV3::Explicit]
|
|
attr_accessor :explicit_buckets
|
|
|
|
# Specify a sequence of buckets that have a width that is proportional to
|
|
# the value of the lower bound. Each bucket represents a constant relative
|
|
# uncertainty on a specific value in the bucket.
|
|
# Defines `num_finite_buckets + 2` (= N) buckets with these boundaries for
|
|
# bucket i:
|
|
# Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).
|
|
# Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)).
|
|
# Corresponds to the JSON property `exponentialBuckets`
|
|
# @return [Google::Apis::MonitoringV3::Exponential]
|
|
attr_accessor :exponential_buckets
|
|
|
|
# Specify a sequence of buckets that all have the same width (except
|
|
# overflow and underflow). Each bucket represents a constant absolute
|
|
# uncertainty on the specific value in the bucket.
|
|
# Defines `num_finite_buckets + 2` (= N) buckets with these boundaries for
|
|
# bucket `i`:
|
|
# Upper bound (0 <= i < N-1): offset + (width * i).
|
|
# Lower bound (1 <= i < N): offset + (width * (i - 1)).
|
|
# Corresponds to the JSON property `linearBuckets`
|
|
# @return [Google::Apis::MonitoringV3::Linear]
|
|
attr_accessor :linear_buckets
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@explicit_buckets = args[:explicit_buckets] if args.key?(:explicit_buckets)
|
|
@exponential_buckets = args[:exponential_buckets] if args.key?(:exponential_buckets)
|
|
@linear_buckets = args[:linear_buckets] if args.key?(:linear_buckets)
|
|
end
|
|
end
|
|
|
|
# The `CreateCollectdTimeSeries` request.
|
|
class CreateCollectdTimeSeriesRequest
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The `collectd` payloads representing the time series data.
|
|
# You must not include more than a single point for each
|
|
# time series, so no two payloads can have the same values
|
|
# for all of the fields `plugin`, `plugin_instance`, `type`, and `type_instance`.
|
|
# Corresponds to the JSON property `collectdPayloads`
|
|
# @return [Array<Google::Apis::MonitoringV3::CollectdPayload>]
|
|
attr_accessor :collectd_payloads
|
|
|
|
# The version of `collectd` that collected the data. Example: `"5.3.0-192.el6"`.
|
|
# Corresponds to the JSON property `collectdVersion`
|
|
# @return [String]
|
|
attr_accessor :collectd_version
|
|
|
|
# An object representing a resource that can be used for monitoring, logging,
|
|
# billing, or other purposes. Examples include virtual machine instances,
|
|
# databases, and storage devices such as disks. The `type` field identifies a
|
|
# MonitoredResourceDescriptor object that describes the resource's
|
|
# schema. Information in the `labels` field identifies the actual resource and
|
|
# its attributes according to the schema. For example, a particular Compute
|
|
# Engine VM instance could be represented by the following object, because the
|
|
# MonitoredResourceDescriptor for `"gce_instance"` has labels
|
|
# `"instance_id"` and `"zone"`:
|
|
# ` "type": "gce_instance",
|
|
# "labels": ` "instance_id": "12345678901234",
|
|
# "zone": "us-central1-a" ``
|
|
# Corresponds to the JSON property `resource`
|
|
# @return [Google::Apis::MonitoringV3::MonitoredResource]
|
|
attr_accessor :resource
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@collectd_payloads = args[:collectd_payloads] if args.key?(:collectd_payloads)
|
|
@collectd_version = args[:collectd_version] if args.key?(:collectd_version)
|
|
@resource = args[:resource] if args.key?(:resource)
|
|
end
|
|
end
|
|
|
|
# A protocol buffer message type.
|
|
class Type
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The list of types appearing in `oneof` definitions in this type.
|
|
# Corresponds to the JSON property `oneofs`
|
|
# @return [Array<String>]
|
|
attr_accessor :oneofs
|
|
|
|
# The protocol buffer options.
|
|
# Corresponds to the JSON property `options`
|
|
# @return [Array<Google::Apis::MonitoringV3::Option>]
|
|
attr_accessor :options
|
|
|
|
# `SourceContext` represents information about the source of a
|
|
# protobuf element, like the file in which it is defined.
|
|
# Corresponds to the JSON property `sourceContext`
|
|
# @return [Google::Apis::MonitoringV3::SourceContext]
|
|
attr_accessor :source_context
|
|
|
|
# The list of fields.
|
|
# Corresponds to the JSON property `fields`
|
|
# @return [Array<Google::Apis::MonitoringV3::Field>]
|
|
attr_accessor :fields
|
|
|
|
# The fully qualified message name.
|
|
# Corresponds to the JSON property `name`
|
|
# @return [String]
|
|
attr_accessor :name
|
|
|
|
# The source syntax.
|
|
# Corresponds to the JSON property `syntax`
|
|
# @return [String]
|
|
attr_accessor :syntax
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@oneofs = args[:oneofs] if args.key?(:oneofs)
|
|
@options = args[:options] if args.key?(:options)
|
|
@source_context = args[:source_context] if args.key?(:source_context)
|
|
@fields = args[:fields] if args.key?(:fields)
|
|
@name = args[:name] if args.key?(:name)
|
|
@syntax = args[:syntax] if args.key?(:syntax)
|
|
end
|
|
end
|
|
|
|
# Exemplars are example points that may be used to annotate aggregated
|
|
# distribution values. They are metadata that gives information about a
|
|
# particular value added to a Distribution bucket, such as a trace ID that
|
|
# was active when a value was added. They can contain further information,
|
|
# such as a example values and timestamps, origin, etc.
|
|
# This is an experimental feature which is available in internal Monarch.
|
|
# The purpose of including it here is to be able to construct demos and
|
|
# prototypes for the purposes of eludicating use cases.
|
|
class Exemplar
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# Value of the exemplar point. This value determines to which bucket the
|
|
# exemplar belongs.
|
|
# Corresponds to the JSON property `value`
|
|
# @return [Float]
|
|
attr_accessor :value
|
|
|
|
# Contextual information about the example value. Examples are:
|
|
# Trace ID: type.googleapis.com/google.devtools.cloudtrace.v1.Trace
|
|
# Literal string: type.googleapis.com/google.protobuf.StringValue
|
|
# Labels dropped during aggregation:
|
|
# type.googleapis.com/google.monitoring.v3.DroppedLabels
|
|
# There may be only a single attachment of any given message type in a
|
|
# single exemplar, and this is enforced by the system.
|
|
# Corresponds to the JSON property `attachments`
|
|
# @return [Array<Hash<String,Object>>]
|
|
attr_accessor :attachments
|
|
|
|
# The observation (sampling) time of the above value.
|
|
# Corresponds to the JSON property `timestamp`
|
|
# @return [String]
|
|
attr_accessor :timestamp
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@value = args[:value] if args.key?(:value)
|
|
@attachments = args[:attachments] if args.key?(:attachments)
|
|
@timestamp = args[:timestamp] if args.key?(:timestamp)
|
|
end
|
|
end
|
|
|
|
# The `ListGroups` response.
|
|
class ListGroupsResponse
|
|
include Google::Apis::Core::Hashable
|
|
|
|
# The groups that match the specified filters.
|
|
# Corresponds to the JSON property `group`
|
|
# @return [Array<Google::Apis::MonitoringV3::Group>]
|
|
attr_accessor :group
|
|
|
|
# If there are more results than have been returned, then this field is set
|
|
# to a non-empty value. To see the additional results,
|
|
# use that value as `pageToken` in the next call to this method.
|
|
# Corresponds to the JSON property `nextPageToken`
|
|
# @return [String]
|
|
attr_accessor :next_page_token
|
|
|
|
def initialize(**args)
|
|
update!(**args)
|
|
end
|
|
|
|
# Update properties of this object
|
|
def update!(**args)
|
|
@group = args[:group] if args.key?(:group)
|
|
@next_page_token = args[:next_page_token] if args.key?(:next_page_token)
|
|
end
|
|
end
|
|
end
|
|
end
|
|
end
|