com.google.logging.v2

Interface LogMetricOrBuilder

All Superinterfaces:

com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder

All Known Implementing Classes:

LogMetric, LogMetric.Builder

public interface LogMetricOrBuilder
extends com.google.protobuf.MessageOrBuilder

Method Summary

Modifier and Type	Method and Description
boolean	containsLabelExtractors(String key) Optional.
String	getBucketName() Optional.
com.google.protobuf.ByteString	getBucketNameBytes() Optional.
com.google.api.Distribution.BucketOptions	getBucketOptions() Optional.
com.google.api.Distribution.BucketOptionsOrBuilder	getBucketOptionsOrBuilder() Optional.
com.google.protobuf.Timestamp	getCreateTime() Output only.
com.google.protobuf.TimestampOrBuilder	getCreateTimeOrBuilder() Output only.
String	getDescription() Optional.
com.google.protobuf.ByteString	getDescriptionBytes() Optional.
boolean	getDisabled() Optional.
String	getFilter() Required.
com.google.protobuf.ByteString	getFilterBytes() Required.
Map<String,String>	getLabelExtractors() Deprecated.
int	getLabelExtractorsCount() Optional.
Map<String,String>	getLabelExtractorsMap() Optional.
String	getLabelExtractorsOrDefault(String key, String defaultValue) Optional.
String	getLabelExtractorsOrThrow(String key) Optional.
com.google.api.MetricDescriptor	getMetricDescriptor() Optional.
com.google.api.MetricDescriptorOrBuilder	getMetricDescriptorOrBuilder() Optional.
String	getName() Required.
com.google.protobuf.ByteString	getNameBytes() Required.
com.google.protobuf.Timestamp	getUpdateTime() Output only.
com.google.protobuf.TimestampOrBuilder	getUpdateTimeOrBuilder() Output only.
String	getValueExtractor() Optional.
com.google.protobuf.ByteString	getValueExtractorBytes() Optional.
LogMetric.ApiVersion	getVersion() Deprecated. google.logging.v2.LogMetric.version is deprecated. See google/logging/v2/logging_metrics.proto;l=237
int	getVersionValue() Deprecated. google.logging.v2.LogMetric.version is deprecated. See google/logging/v2/logging_metrics.proto;l=237
boolean	hasBucketOptions() Optional.
boolean	hasCreateTime() Output only.
boolean	hasMetricDescriptor() Optional.
boolean	hasUpdateTime() Output only.

Methods inherited from interface com.google.protobuf.MessageOrBuilder

findInitializationErrors, getAllFields, getDefaultInstanceForType, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof

Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

isInitialized

Method Detail

getName

String getName()

 Required. The client-assigned metric identifier.
 Examples: `"error_count"`, `"nginx/requests"`.

 Metric identifiers are limited to 100 characters and can include only the
 following characters: `A-Z`, `a-z`, `0-9`, and the special characters
 `_-.,+!*',()%/`. The forward-slash character (`/`) denotes a hierarchy of
 name pieces, and it cannot be the first character of the name.

 This field is the `[METRIC_ID]` part of a metric resource name in the
 format "projects/[PROJECT_ID]/metrics/[METRIC_ID]". Example: If the
 resource name of a metric is
 `"projects/my-project/metrics/nginx%2Frequests"`, this field's value is
 `"nginx/requests"`.
 

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Returns:

The name.

getNameBytes

com.google.protobuf.ByteString getNameBytes()

 Required. The client-assigned metric identifier.
 Examples: `"error_count"`, `"nginx/requests"`.

 Metric identifiers are limited to 100 characters and can include only the
 following characters: `A-Z`, `a-z`, `0-9`, and the special characters
 `_-.,+!*',()%/`. The forward-slash character (`/`) denotes a hierarchy of
 name pieces, and it cannot be the first character of the name.

 This field is the `[METRIC_ID]` part of a metric resource name in the
 format "projects/[PROJECT_ID]/metrics/[METRIC_ID]". Example: If the
 resource name of a metric is
 `"projects/my-project/metrics/nginx%2Frequests"`, this field's value is
 `"nginx/requests"`.
 

string name = 1 [(.google.api.field_behavior) = REQUIRED];

Returns:

The bytes for name.

getDescription

String getDescription()

 Optional. A description of this metric, which is used in documentation.
 The maximum length of the description is 8000 characters.
 

string description = 2 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The description.

getDescriptionBytes

com.google.protobuf.ByteString getDescriptionBytes()

 Optional. A description of this metric, which is used in documentation.
 The maximum length of the description is 8000 characters.
 

string description = 2 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The bytes for description.

getFilter

String getFilter()

 Required. An [advanced logs
 filter](https://cloud.google.com/logging/docs/view/advanced_filters) which
 is used to match log entries. Example:

     "resource.type=gae_app AND severity>=ERROR"

 The maximum length of the filter is 20000 characters.
 

string filter = 3 [(.google.api.field_behavior) = REQUIRED];

Returns:

The filter.

getFilterBytes

com.google.protobuf.ByteString getFilterBytes()

 Required. An [advanced logs
 filter](https://cloud.google.com/logging/docs/view/advanced_filters) which
 is used to match log entries. Example:

     "resource.type=gae_app AND severity>=ERROR"

 The maximum length of the filter is 20000 characters.
 

string filter = 3 [(.google.api.field_behavior) = REQUIRED];

Returns:

The bytes for filter.

getBucketName

String getBucketName()

 Optional. The resource name of the Log Bucket that owns the Log Metric.
 Only Log Buckets in projects are supported. The bucket has to be in the
 same project as the metric.

 For example:

   `projects/my-project/locations/global/buckets/my-bucket`

 If empty, then the Log Metric is considered a non-Bucket Log Metric.
 

string bucket_name = 13 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The bucketName.

getBucketNameBytes

com.google.protobuf.ByteString getBucketNameBytes()

 Optional. The resource name of the Log Bucket that owns the Log Metric.
 Only Log Buckets in projects are supported. The bucket has to be in the
 same project as the metric.

 For example:

   `projects/my-project/locations/global/buckets/my-bucket`

 If empty, then the Log Metric is considered a non-Bucket Log Metric.
 

string bucket_name = 13 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The bytes for bucketName.

getDisabled

boolean getDisabled()

 Optional. If set to True, then this metric is disabled and it does not
 generate any points.
 

bool disabled = 12 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The disabled.

hasMetricDescriptor

boolean hasMetricDescriptor()

 Optional. The metric descriptor associated with the logs-based metric.
 If unspecified, it uses a default metric descriptor with a DELTA metric
 kind, INT64 value type, with no labels and a unit of "1". Such a metric
 counts the number of log entries matching the `filter` expression.

 The `name`, `type`, and `description` fields in the `metric_descriptor`
 are output only, and is constructed using the `name` and `description`
 field in the LogMetric.

 To create a logs-based metric that records a distribution of log values, a
 DELTA metric kind with a DISTRIBUTION value type must be used along with
 a `value_extractor` expression in the LogMetric.

 Each label in the metric descriptor must have a matching label
 name as the key and an extractor expression as the value in the
 `label_extractors` map.

 The `metric_kind` and `value_type` fields in the `metric_descriptor` cannot
 be updated once initially configured. New labels can be added in the
 `metric_descriptor`, but existing labels cannot be modified except for
 their description.
 

.google.api.MetricDescriptor metric_descriptor = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the metricDescriptor field is set.

getMetricDescriptor

com.google.api.MetricDescriptor getMetricDescriptor()

 Optional. The metric descriptor associated with the logs-based metric.
 If unspecified, it uses a default metric descriptor with a DELTA metric
 kind, INT64 value type, with no labels and a unit of "1". Such a metric
 counts the number of log entries matching the `filter` expression.

 The `name`, `type`, and `description` fields in the `metric_descriptor`
 are output only, and is constructed using the `name` and `description`
 field in the LogMetric.

 To create a logs-based metric that records a distribution of log values, a
 DELTA metric kind with a DISTRIBUTION value type must be used along with
 a `value_extractor` expression in the LogMetric.

 Each label in the metric descriptor must have a matching label
 name as the key and an extractor expression as the value in the
 `label_extractors` map.

 The `metric_kind` and `value_type` fields in the `metric_descriptor` cannot
 be updated once initially configured. New labels can be added in the
 `metric_descriptor`, but existing labels cannot be modified except for
 their description.
 

.google.api.MetricDescriptor metric_descriptor = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The metricDescriptor.

getMetricDescriptorOrBuilder

com.google.api.MetricDescriptorOrBuilder getMetricDescriptorOrBuilder()

 Optional. The metric descriptor associated with the logs-based metric.
 If unspecified, it uses a default metric descriptor with a DELTA metric
 kind, INT64 value type, with no labels and a unit of "1". Such a metric
 counts the number of log entries matching the `filter` expression.

 The `name`, `type`, and `description` fields in the `metric_descriptor`
 are output only, and is constructed using the `name` and `description`
 field in the LogMetric.

 To create a logs-based metric that records a distribution of log values, a
 DELTA metric kind with a DISTRIBUTION value type must be used along with
 a `value_extractor` expression in the LogMetric.

 Each label in the metric descriptor must have a matching label
 name as the key and an extractor expression as the value in the
 `label_extractors` map.

 The `metric_kind` and `value_type` fields in the `metric_descriptor` cannot
 be updated once initially configured. New labels can be added in the
 `metric_descriptor`, but existing labels cannot be modified except for
 their description.
 

.google.api.MetricDescriptor metric_descriptor = 5 [(.google.api.field_behavior) = OPTIONAL];

getValueExtractor

String getValueExtractor()

 Optional. A `value_extractor` is required when using a distribution
 logs-based metric to extract the values to record from a log entry.
 Two functions are supported for value extraction: `EXTRACT(field)` or
 `REGEXP_EXTRACT(field, regex)`. The arguments are:

   1. field: The name of the log entry field from which the value is to be
      extracted.
   2. regex: A regular expression using the Google RE2 syntax
      (https://github.com/google/re2/wiki/Syntax) with a single capture
      group to extract data from the specified log entry field. The value
      of the field is converted to a string before applying the regex.
      It is an error to specify a regex that does not include exactly one
      capture group.

 The result of the extraction must be convertible to a double type, as the
 distribution always records double values. If either the extraction or
 the conversion to double fails, then those values are not recorded in the
 distribution.

 Example: `REGEXP_EXTRACT(jsonPayload.request, ".*quantity=(\d+).*")`
 

string value_extractor = 6 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The valueExtractor.

getValueExtractorBytes

com.google.protobuf.ByteString getValueExtractorBytes()

 Optional. A `value_extractor` is required when using a distribution
 logs-based metric to extract the values to record from a log entry.
 Two functions are supported for value extraction: `EXTRACT(field)` or
 `REGEXP_EXTRACT(field, regex)`. The arguments are:

   1. field: The name of the log entry field from which the value is to be
      extracted.
   2. regex: A regular expression using the Google RE2 syntax
      (https://github.com/google/re2/wiki/Syntax) with a single capture
      group to extract data from the specified log entry field. The value
      of the field is converted to a string before applying the regex.
      It is an error to specify a regex that does not include exactly one
      capture group.

 The result of the extraction must be convertible to a double type, as the
 distribution always records double values. If either the extraction or
 the conversion to double fails, then those values are not recorded in the
 distribution.

 Example: `REGEXP_EXTRACT(jsonPayload.request, ".*quantity=(\d+).*")`
 

string value_extractor = 6 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The bytes for valueExtractor.

getLabelExtractorsCount

int getLabelExtractorsCount()

 Optional. A map from a label key string to an extractor expression which is
 used to extract data from a log entry field and assign as the label value.
 Each label key specified in the LabelDescriptor must have an associated
 extractor expression in this map. The syntax of the extractor expression
 is the same as for the `value_extractor` field.

 The extracted value is converted to the type defined in the label
 descriptor. If either the extraction or the type conversion fails,
 the label will have a default value. The default value for a string
 label is an empty string, for an integer label its 0, and for a boolean
 label its `false`.

 Note that there are upper bounds on the maximum number of labels and the
 number of active time series that are allowed in a project.
 

map<string, string> label_extractors = 7 [(.google.api.field_behavior) = OPTIONAL];

containsLabelExtractors

boolean containsLabelExtractors(String key)

 Optional. A map from a label key string to an extractor expression which is
 used to extract data from a log entry field and assign as the label value.
 Each label key specified in the LabelDescriptor must have an associated
 extractor expression in this map. The syntax of the extractor expression
 is the same as for the `value_extractor` field.

 The extracted value is converted to the type defined in the label
 descriptor. If either the extraction or the type conversion fails,
 the label will have a default value. The default value for a string
 label is an empty string, for an integer label its 0, and for a boolean
 label its `false`.

 Note that there are upper bounds on the maximum number of labels and the
 number of active time series that are allowed in a project.
 

map<string, string> label_extractors = 7 [(.google.api.field_behavior) = OPTIONAL];

getLabelExtractors

@Deprecated
Map<String,String> getLabelExtractors()

Deprecated.

Use getLabelExtractorsMap() instead.

getLabelExtractorsMap

Map<String,String> getLabelExtractorsMap()

 Optional. A map from a label key string to an extractor expression which is
 used to extract data from a log entry field and assign as the label value.
 Each label key specified in the LabelDescriptor must have an associated
 extractor expression in this map. The syntax of the extractor expression
 is the same as for the `value_extractor` field.

 The extracted value is converted to the type defined in the label
 descriptor. If either the extraction or the type conversion fails,
 the label will have a default value. The default value for a string
 label is an empty string, for an integer label its 0, and for a boolean
 label its `false`.

 Note that there are upper bounds on the maximum number of labels and the
 number of active time series that are allowed in a project.
 

map<string, string> label_extractors = 7 [(.google.api.field_behavior) = OPTIONAL];

getLabelExtractorsOrDefault

String getLabelExtractorsOrDefault(String key,
                                   String defaultValue)

 Optional. A map from a label key string to an extractor expression which is
 used to extract data from a log entry field and assign as the label value.
 Each label key specified in the LabelDescriptor must have an associated
 extractor expression in this map. The syntax of the extractor expression
 is the same as for the `value_extractor` field.

 The extracted value is converted to the type defined in the label
 descriptor. If either the extraction or the type conversion fails,
 the label will have a default value. The default value for a string
 label is an empty string, for an integer label its 0, and for a boolean
 label its `false`.

 Note that there are upper bounds on the maximum number of labels and the
 number of active time series that are allowed in a project.
 

map<string, string> label_extractors = 7 [(.google.api.field_behavior) = OPTIONAL];

getLabelExtractorsOrThrow

String getLabelExtractorsOrThrow(String key)

 Optional. A map from a label key string to an extractor expression which is
 used to extract data from a log entry field and assign as the label value.
 Each label key specified in the LabelDescriptor must have an associated
 extractor expression in this map. The syntax of the extractor expression
 is the same as for the `value_extractor` field.

 The extracted value is converted to the type defined in the label
 descriptor. If either the extraction or the type conversion fails,
 the label will have a default value. The default value for a string
 label is an empty string, for an integer label its 0, and for a boolean
 label its `false`.

 Note that there are upper bounds on the maximum number of labels and the
 number of active time series that are allowed in a project.
 

map<string, string> label_extractors = 7 [(.google.api.field_behavior) = OPTIONAL];

hasBucketOptions

boolean hasBucketOptions()

 Optional. The `bucket_options` are required when the logs-based metric is
 using a DISTRIBUTION value type and it describes the bucket boundaries
 used to create a histogram of the extracted values.
 

.google.api.Distribution.BucketOptions bucket_options = 8 [(.google.api.field_behavior) = OPTIONAL];

Returns:

Whether the bucketOptions field is set.

getBucketOptions

com.google.api.Distribution.BucketOptions getBucketOptions()

 Optional. The `bucket_options` are required when the logs-based metric is
 using a DISTRIBUTION value type and it describes the bucket boundaries
 used to create a histogram of the extracted values.
 

.google.api.Distribution.BucketOptions bucket_options = 8 [(.google.api.field_behavior) = OPTIONAL];

Returns:

The bucketOptions.

getBucketOptionsOrBuilder

com.google.api.Distribution.BucketOptionsOrBuilder getBucketOptionsOrBuilder()

 Optional. The `bucket_options` are required when the logs-based metric is
 using a DISTRIBUTION value type and it describes the bucket boundaries
 used to create a histogram of the extracted values.
 

.google.api.Distribution.BucketOptions bucket_options = 8 [(.google.api.field_behavior) = OPTIONAL];

hasCreateTime

boolean hasCreateTime()

 Output only. The creation timestamp of the metric.

 This field may not be present for older metrics.
 

.google.protobuf.Timestamp create_time = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns:

Whether the createTime field is set.

getCreateTime

com.google.protobuf.Timestamp getCreateTime()

 Output only. The creation timestamp of the metric.

 This field may not be present for older metrics.
 

.google.protobuf.Timestamp create_time = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns:

The createTime.

getCreateTimeOrBuilder

com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder()

 Output only. The creation timestamp of the metric.

 This field may not be present for older metrics.
 

.google.protobuf.Timestamp create_time = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

hasUpdateTime

boolean hasUpdateTime()

 Output only. The last update timestamp of the metric.

 This field may not be present for older metrics.
 

.google.protobuf.Timestamp update_time = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns:

Whether the updateTime field is set.

getUpdateTime

com.google.protobuf.Timestamp getUpdateTime()

 Output only. The last update timestamp of the metric.

 This field may not be present for older metrics.
 

.google.protobuf.Timestamp update_time = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns:

The updateTime.

getUpdateTimeOrBuilder

com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder()

 Output only. The last update timestamp of the metric.

 This field may not be present for older metrics.
 

.google.protobuf.Timestamp update_time = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

getVersionValue

@Deprecated
int getVersionValue()

Deprecated. google.logging.v2.LogMetric.version is deprecated. See google/logging/v2/logging_metrics.proto;l=237

 Deprecated. The API version that created or updated this metric.
 The v2 format is used by default and cannot be changed.
 

.google.logging.v2.LogMetric.ApiVersion version = 4 [deprecated = true];

Returns:

The enum numeric value on the wire for version.

getVersion

@Deprecated
LogMetric.ApiVersion getVersion()

Deprecated. google.logging.v2.LogMetric.version is deprecated. See google/logging/v2/logging_metrics.proto;l=237

 Deprecated. The API version that created or updated this metric.
 The v2 format is used by default and cannot be changed.
 

.google.logging.v2.LogMetric.ApiVersion version = 4 [deprecated = true];

Returns:

The version.