Default request referring to version v3 of the Stackdriver Monitoring API. This contains the host and root path used as a starting point for constructing service requests.

View monitoring data for all of your Google Cloud and third-party projects

View and manage your data across Google Cloud Platform services

View and write monitoring data for all of your Google and third-party Cloud and API projects

Publish metric data to your Google Cloud projects

Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.

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.

See: monitoredResourceDescriptor smart constructor.

Creates a value of MonitoredResourceDescriptor with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• mrdName
• mrdDisplayName
• mrdLabels
• mrdType
• mrdDescription

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}".

Optional. A concise name for the monitored resource type that might be displayed in user interfaces. It should be a Title Cased Noun Phrase, without any article or other determiners. For example, "Google Cloud SQL Database".

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".

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.

Optional. A detailed description of the monitored resource type that might be used in documentation.

The type of measurement.

The ListTimeSeries response.

See: listTimeSeriesResponse smart constructor.

Creates a value of ListTimeSeriesResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• ltsrNextPageToken
• ltsrTimeSeries

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.

One or more time series that match the filter included in the request.

The MetricAssociations response.

See: listMetricAssociationsResponse smart constructor.

Creates a value of ListMetricAssociationsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• lmarNextPageToken
• lmarMetricAssociations

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.

The MetricAssociations that match the specified filters.

Defines a metric type and its schema. Once a metric descriptor is created, deleting or altering it stops data collection and makes the metric type's existing data unusable.

See: metricDescriptor smart constructor.

Creates a value of MetricDescriptor with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• mdMetricKind
• mdName
• mdDisplayName
• mdLabels
• mdType
• mdValueType
• mdDescription
• mdUnit

Whether the metric records instantaneous values, changes to a value, etc. Some combinations of metric_kind and value_type might not be supported.

The resource name of the metric descriptor. Depending on the implementation, the name typically includes: (1) the parent resource name that defines the scope of the metric type or of its data; and (2) the metric's URL-encoded type, which also appears in the type field of this descriptor. For example, following is the resource name of a custom metric within the GCP project my-project-id: "projects/my-project-id/metricDescriptors/custom.googleapis.com%2Finvoice%2Fpaid%2Famount"

A concise name for the metric, which can be displayed in user interfaces. Use sentence case without an ending period, for example "Request count".

The set of labels that can be used to describe a specific instance of this metric type. For example, the appengine.googleapis.com/http/server/response_latencies metric type has a label for the HTTP response code, response_code, so you can look at latencies for successful responses or just for responses that failed.

The metric type, including its DNS name prefix. The type is not URL-encoded. All user-defined custom metric types have the DNS name custom.googleapis.com. Metric types should use a natural hierarchical grouping. For example: "custom.googleapis.com/invoice/paid/amount" "appengine.googleapis.com/http/server/response_latencies"

Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.

A detailed description of the metric, which can be used in documentation.

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 dayPrefixes (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)GrammarThe 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 '}'.

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.

See: group' smart constructor.

Creates a value of Group with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• gName
• gDisplayName
• gFilter
• gIsCluster
• gParentName

Output only. 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.

A user-assigned name for this group, used only for display purposes.

The filter used to determine which monitored resources belong to this group.

If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.

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, "".

A single strongly-typed value.

See: typedValue smart constructor.

Creates a value of TypedValue with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• tvBoolValue
• tvDoubleValue
• tvStringValue
• tvDistributionValue
• tvInt64Value

A Boolean value: true or false.

A 64-bit double-precision floating-point number. Its magnitude is approximately ±10±300 and it has 16 significant digits of precision.

A variable-length string value.

A distribution value.

A 64-bit integer. Its range is approximately ±9.2x1018.

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".

See: monitoredResourceLabels smart constructor.

Creates a value of MonitoredResourceLabels with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• mrlAddtional

SourceContext represents information about the source of a protobuf element, like the file in which it is defined.

See: sourceContext smart constructor.

Creates a value of SourceContext with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• scFileName

The path-qualified name of the .proto file that contained the associated protobuf element. For example: "google/protobuf/source_context.proto".

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.

See: distribution smart constructor.

Creates a value of Distribution with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• dSumOfSquaredDeviation
• dMean
• dCount
• dBucketCounts
• dRange
• dBucketOptions

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.

The arithmetic mean of the values in the population. If count is zero then this field must be zero.

The number of values in the population. Must be non-negative.

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.

If specified, contains the range of the population values. The field must not be present if the count is zero. This field is presently ignored by the Stackdriver Monitoring API v3.

Defines the histogram bucket boundaries.

A single field of a message type.

See: field smart constructor.

Creates a value of Field with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• fKind
• fOneofIndex
• fName
• fJSONName
• fCardinality
• fOptions
• fPacked
• fDefaultValue
• fNumber
• fTypeURL

The field type.

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.

The field name.

The field JSON name.

The field cardinality.

The protocol buffer options.

Whether to use alternative packed wire representation.

The string value of the default value of this field. Proto2 syntax only.

The field number.

The field type URL, without the scheme, for message or enumeration types. Example: "type.googleapis.com/google.protobuf.Timestamp".

The field type.

A Vital Signs MetricAssociation, representing the inclusion of its referenced metric type within its parent category.

See: metricAssociation smart constructor.

Creates a value of MetricAssociation with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• maMetricType
• maName
• maIsDefault

Resource name of the metric. It must be the full resource name. For example, "compute.googleapis.com/instance/cpu/utilization".

Resource name for the metric association.

A flag to indicate whether this association is part of Stackdriver's default taxonomy.

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 {}.

See: empty smart constructor.