Package 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 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];

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