Skip to content

Commit

Permalink
feat(logging): update the api
Browse files Browse the repository at this point in the history
#### logging:v2

The following keys were added:
- schemas.LogMetric.properties.resourceName (Total Keys: 2)
  • Loading branch information
yoshi-automation committed May 10, 2024
1 parent 4893aa0 commit b4ab366
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 1 deletion.
6 changes: 6 additions & 0 deletions docs/dyn/logging_v2.projects.metrics.html
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,7 @@ <h3>Method Details</h3>
&quot;valueType&quot;: &quot;A String&quot;, # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
},
&quot;name&quot;: &quot;A String&quot;, # Required. The client-assigned metric identifier. Examples: &quot;error_count&quot;, &quot;nginx/requests&quot;.Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*&#x27;,()%/. 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 &quot;projects/PROJECT_ID/metrics/METRIC_ID&quot;. Example: If the resource name of a metric is &quot;projects/my-project/metrics/nginx%2Frequests&quot;, this field&#x27;s value is &quot;nginx/requests&quot;.
&quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the metric: &quot;projects/[PROJECT_ID]/metrics/[METRIC_ID]&quot;
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the metric.This field may not be present for older metrics.
&quot;valueExtractor&quot;: &quot;A String&quot;, # 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: field: The name of the log entry field from which the value is to be extracted. 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, &quot;.*quantity=(\d+).*&quot;)
&quot;version&quot;: &quot;A String&quot;, # Deprecated. The API version that created or updated this metric. The v2 format is used by default and cannot be changed.
Expand Down Expand Up @@ -227,6 +228,7 @@ <h3>Method Details</h3>
&quot;valueType&quot;: &quot;A String&quot;, # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
},
&quot;name&quot;: &quot;A String&quot;, # Required. The client-assigned metric identifier. Examples: &quot;error_count&quot;, &quot;nginx/requests&quot;.Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*&#x27;,()%/. 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 &quot;projects/PROJECT_ID/metrics/METRIC_ID&quot;. Example: If the resource name of a metric is &quot;projects/my-project/metrics/nginx%2Frequests&quot;, this field&#x27;s value is &quot;nginx/requests&quot;.
&quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the metric: &quot;projects/[PROJECT_ID]/metrics/[METRIC_ID]&quot;
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the metric.This field may not be present for older metrics.
&quot;valueExtractor&quot;: &quot;A String&quot;, # 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: field: The name of the log entry field from which the value is to be extracted. 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, &quot;.*quantity=(\d+).*&quot;)
&quot;version&quot;: &quot;A String&quot;, # Deprecated. The API version that created or updated this metric. The v2 format is used by default and cannot be changed.
Expand Down Expand Up @@ -317,6 +319,7 @@ <h3>Method Details</h3>
&quot;valueType&quot;: &quot;A String&quot;, # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
},
&quot;name&quot;: &quot;A String&quot;, # Required. The client-assigned metric identifier. Examples: &quot;error_count&quot;, &quot;nginx/requests&quot;.Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*&#x27;,()%/. 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 &quot;projects/PROJECT_ID/metrics/METRIC_ID&quot;. Example: If the resource name of a metric is &quot;projects/my-project/metrics/nginx%2Frequests&quot;, this field&#x27;s value is &quot;nginx/requests&quot;.
&quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the metric: &quot;projects/[PROJECT_ID]/metrics/[METRIC_ID]&quot;
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the metric.This field may not be present for older metrics.
&quot;valueExtractor&quot;: &quot;A String&quot;, # 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: field: The name of the log entry field from which the value is to be extracted. 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, &quot;.*quantity=(\d+).*&quot;)
&quot;version&quot;: &quot;A String&quot;, # Deprecated. The API version that created or updated this metric. The v2 format is used by default and cannot be changed.
Expand Down Expand Up @@ -393,6 +396,7 @@ <h3>Method Details</h3>
&quot;valueType&quot;: &quot;A String&quot;, # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
},
&quot;name&quot;: &quot;A String&quot;, # Required. The client-assigned metric identifier. Examples: &quot;error_count&quot;, &quot;nginx/requests&quot;.Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*&#x27;,()%/. 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 &quot;projects/PROJECT_ID/metrics/METRIC_ID&quot;. Example: If the resource name of a metric is &quot;projects/my-project/metrics/nginx%2Frequests&quot;, this field&#x27;s value is &quot;nginx/requests&quot;.
&quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the metric: &quot;projects/[PROJECT_ID]/metrics/[METRIC_ID]&quot;
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the metric.This field may not be present for older metrics.
&quot;valueExtractor&quot;: &quot;A String&quot;, # 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: field: The name of the log entry field from which the value is to be extracted. 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, &quot;.*quantity=(\d+).*&quot;)
&quot;version&quot;: &quot;A String&quot;, # Deprecated. The API version that created or updated this metric. The v2 format is used by default and cannot be changed.
Expand Down Expand Up @@ -477,6 +481,7 @@ <h3>Method Details</h3>
&quot;valueType&quot;: &quot;A String&quot;, # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
},
&quot;name&quot;: &quot;A String&quot;, # Required. The client-assigned metric identifier. Examples: &quot;error_count&quot;, &quot;nginx/requests&quot;.Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*&#x27;,()%/. 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 &quot;projects/PROJECT_ID/metrics/METRIC_ID&quot;. Example: If the resource name of a metric is &quot;projects/my-project/metrics/nginx%2Frequests&quot;, this field&#x27;s value is &quot;nginx/requests&quot;.
&quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the metric: &quot;projects/[PROJECT_ID]/metrics/[METRIC_ID]&quot;
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the metric.This field may not be present for older metrics.
&quot;valueExtractor&quot;: &quot;A String&quot;, # 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: field: The name of the log entry field from which the value is to be extracted. 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, &quot;.*quantity=(\d+).*&quot;)
&quot;version&quot;: &quot;A String&quot;, # Deprecated. The API version that created or updated this metric. The v2 format is used by default and cannot be changed.
Expand Down Expand Up @@ -542,6 +547,7 @@ <h3>Method Details</h3>
&quot;valueType&quot;: &quot;A String&quot;, # Whether the measurement is an integer, a floating-point number, etc. Some combinations of metric_kind and value_type might not be supported.
},
&quot;name&quot;: &quot;A String&quot;, # Required. The client-assigned metric identifier. Examples: &quot;error_count&quot;, &quot;nginx/requests&quot;.Metric identifiers are limited to 100 characters and can include only the following characters: A-Z, a-z, 0-9, and the special characters _-.,+!*&#x27;,()%/. 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 &quot;projects/PROJECT_ID/metrics/METRIC_ID&quot;. Example: If the resource name of a metric is &quot;projects/my-project/metrics/nginx%2Frequests&quot;, this field&#x27;s value is &quot;nginx/requests&quot;.
&quot;resourceName&quot;: &quot;A String&quot;, # Output only. The resource name of the metric: &quot;projects/[PROJECT_ID]/metrics/[METRIC_ID]&quot;
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The last update timestamp of the metric.This field may not be present for older metrics.
&quot;valueExtractor&quot;: &quot;A String&quot;, # 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: field: The name of the log entry field from which the value is to be extracted. 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, &quot;.*quantity=(\d+).*&quot;)
&quot;version&quot;: &quot;A String&quot;, # Deprecated. The API version that created or updated this metric. The v2 format is used by default and cannot be changed.
Expand Down
7 changes: 6 additions & 1 deletion googleapiclient/discovery_cache/documents/logging.v2.json
Original file line number Diff line number Diff line change
Expand Up @@ -8132,7 +8132,7 @@
}
}
},
"revision": "20240426",
"revision": "20240503",
"rootUrl": "https://logging.googleapis.com/",
"schemas": {
"AuditConfig": {
Expand Down Expand Up @@ -9576,6 +9576,11 @@
"description": "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\".",
"type": "string"
},
"resourceName": {
"description": "Output only. The resource name of the metric: \"projects/[PROJECT_ID]/metrics/[METRIC_ID]\" ",
"readOnly": true,
"type": "string"
},
"updateTime": {
"description": "Output only. The last update timestamp of the metric.This field may not be present for older metrics.",
"format": "google-datetime",
Expand Down

0 comments on commit b4ab366

Please sign in to comment.