feat(logging): update the api

#### logging:v2 The following keys were added: - schemas.LogEntry.properties.errorGroups (Total Keys: 3) - schemas.LogErrorGroup (Total Keys: 3)
googleapis · Nov 7, 2023 · bd19999 · bd19999
1 parent 2bd3709
commit bd19999
Show file tree

Hide file tree

Showing 2 changed files with 35 additions and 1 deletion.
diff --git a/docs/dyn/logging_v2.entries.html b/docs/dyn/logging_v2.entries.html
@@ -173,6 +173,11 @@ <h3>Method Details</h3>
     { # Result returned from ListLogEntries.
   &quot;entries&quot;: [ # A list of log entries. If entries is empty, nextPageToken may still be returned, indicating that more entries may exist. See nextPageToken for more information.
     { # An individual entry in a log.
+      &quot;errorGroups&quot;: [ # Output only. The Error Reporting (https://cloud.google.com/error-reporting) error groups associated with this LogEntry. Error Reporting sets the values for this field during error group creation.For more information, see View error details( https://cloud.google.com/error-reporting/docs/viewing-errors#view_error_details)This field isn&#x27;t available during log routing (https://cloud.google.com/logging/docs/routing/overview)
+        { # Contains metadata that associates the LogEntry to Error Reporting error groups.
+          &quot;id&quot;: &quot;A String&quot;, # The id is a unique identifier for a particular error group; it is the last part of the error group resource name: /projects//errors/. Example: COShysOX0r_51QE The id is derived from key parts of the error-log content and is treated as Service Data. For information about how Service Data is handled, see Google Cloud Privacy Notice (https://cloud.google.com/terms/cloud-privacy-notice).
+        },
+      ],
       &quot;httpRequest&quot;: { # A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message. # Optional. Information about the HTTP request associated with this log entry, if applicable.
         &quot;cacheFillBytes&quot;: &quot;A String&quot;, # The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
         &quot;cacheHit&quot;: True or False, # Whether or not an entity was served from cache (with or without validation).
@@ -285,6 +290,11 @@ <h3>Method Details</h3>
     { # Result returned from TailLogEntries.
   &quot;entries&quot;: [ # A list of log entries. Each response in the stream will order entries with increasing values of LogEntry.timestamp. Ordering is not guaranteed between separate responses.
     { # An individual entry in a log.
+      &quot;errorGroups&quot;: [ # Output only. The Error Reporting (https://cloud.google.com/error-reporting) error groups associated with this LogEntry. Error Reporting sets the values for this field during error group creation.For more information, see View error details( https://cloud.google.com/error-reporting/docs/viewing-errors#view_error_details)This field isn&#x27;t available during log routing (https://cloud.google.com/logging/docs/routing/overview)
+        { # Contains metadata that associates the LogEntry to Error Reporting error groups.
+          &quot;id&quot;: &quot;A String&quot;, # The id is a unique identifier for a particular error group; it is the last part of the error group resource name: /projects//errors/. Example: COShysOX0r_51QE The id is derived from key parts of the error-log content and is treated as Service Data. For information about how Service Data is handled, see Google Cloud Privacy Notice (https://cloud.google.com/terms/cloud-privacy-notice).
+        },
+      ],
       &quot;httpRequest&quot;: { # A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message. # Optional. Information about the HTTP request associated with this log entry, if applicable.
         &quot;cacheFillBytes&quot;: &quot;A String&quot;, # The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
         &quot;cacheHit&quot;: True or False, # Whether or not an entity was served from cache (with or without validation).
@@ -373,6 +383,11 @@ <h3>Method Details</h3>
   &quot;dryRun&quot;: True or False, # Optional. If true, the request should expect normal response, but the entries won&#x27;t be persisted nor exported. Useful for checking whether the logging API endpoints are working properly before sending valuable data.
   &quot;entries&quot;: [ # Required. The log entries to send to Logging. The order of log entries in this list does not matter. Values supplied in this method&#x27;s log_name, resource, and labels fields are copied into those log entries in this list that do not include values for their corresponding fields. For more information, see the LogEntry type.If the timestamp or insert_id fields are missing in log entries, then this method supplies the current time or a unique identifier, respectively. The supplied values are chosen so that, among the log entries that did not supply their own values, the entries earlier in the list will sort before the entries later in the list. See the entries.list method.Log entries with timestamps that are more than the logs retention period (https://cloud.google.com/logging/quotas) in the past or more than 24 hours in the future will not be available when calling entries.list. However, those log entries can still be exported with LogSinks (https://cloud.google.com/logging/docs/api/tasks/exporting-logs).To improve throughput and to avoid exceeding the quota limit (https://cloud.google.com/logging/quotas) for calls to entries.write, you should try to include several log entries in this list, rather than calling this method for each individual log entry.
     { # An individual entry in a log.
+      &quot;errorGroups&quot;: [ # Output only. The Error Reporting (https://cloud.google.com/error-reporting) error groups associated with this LogEntry. Error Reporting sets the values for this field during error group creation.For more information, see View error details( https://cloud.google.com/error-reporting/docs/viewing-errors#view_error_details)This field isn&#x27;t available during log routing (https://cloud.google.com/logging/docs/routing/overview)
+        { # Contains metadata that associates the LogEntry to Error Reporting error groups.
+          &quot;id&quot;: &quot;A String&quot;, # The id is a unique identifier for a particular error group; it is the last part of the error group resource name: /projects//errors/. Example: COShysOX0r_51QE The id is derived from key parts of the error-log content and is treated as Service Data. For information about how Service Data is handled, see Google Cloud Privacy Notice (https://cloud.google.com/terms/cloud-privacy-notice).
+        },
+      ],
       &quot;httpRequest&quot;: { # A common proto for logging HTTP requests. Only contains semantics defined by the HTTP specification. Product-specific logging information MUST be defined in a separate message. # Optional. Information about the HTTP request associated with this log entry, if applicable.
         &quot;cacheFillBytes&quot;: &quot;A String&quot;, # The number of HTTP response bytes inserted into cache. Set only when a cache fill was attempted.
         &quot;cacheHit&quot;: True or False, # Whether or not an entity was served from cache (with or without validation).

diff --git a/googleapiclient/discovery_cache/documents/logging.v2.json b/googleapiclient/discovery_cache/documents/logging.v2.json
@@ -7084,7 +7084,7 @@
       }
     }
   },
-  "revision": "20231006",
+  "revision": "20231026",
   "rootUrl": "https://logging.googleapis.com/",
   "schemas": {
     "BigQueryDataset": {
@@ -8004,6 +8004,14 @@
       "description": "An individual entry in a log.",
       "id": "LogEntry",
       "properties": {
+        "errorGroups": {
+          "description": "Output only. The Error Reporting (https://cloud.google.com/error-reporting) error groups associated with this LogEntry. Error Reporting sets the values for this field during error group creation.For more information, see View error details( https://cloud.google.com/error-reporting/docs/viewing-errors#view_error_details)This field isn't available during log routing (https://cloud.google.com/logging/docs/routing/overview)",
+          "items": {
+            "$ref": "LogErrorGroup"
+          },
+          "readOnly": true,
+          "type": "array"
+        },
         "httpRequest": {
           "$ref": "HttpRequest",
           "description": "Optional. Information about the HTTP request associated with this log entry, if applicable."
@@ -8160,6 +8168,17 @@
       },
       "type": "object"
     },
+    "LogErrorGroup": {
+      "description": "Contains metadata that associates the LogEntry to Error Reporting error groups.",
+      "id": "LogErrorGroup",
+      "properties": {
+        "id": {
+          "description": "The id is a unique identifier for a particular error group; it is the last part of the error group resource name: /projects//errors/. Example: COShysOX0r_51QE The id is derived from key parts of the error-log content and is treated as Service Data. For information about how Service Data is handled, see Google Cloud Privacy Notice (https://cloud.google.com/terms/cloud-privacy-notice).",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "LogExclusion": {
       "description": "Specifies a set of log entries that are filtered out by a sink. If your Google Cloud resource receives a large volume of log entries, you can use exclusions to reduce your chargeable logs. Note that exclusions on organization-level and folder-level sinks don't apply to child resources. Note also that you cannot modify the _Required sink or exclude logs from it.",
       "id": "LogExclusion",