google-cloud-logging 1.10.2 → 1.10.7

data/lib/google/cloud/logging/v2/config_service_v2_client_config.json

@@ -4,9 +4,14 @@
       "retry_codes": {
         "idempotent": [
           "DEADLINE_EXCEEDED",
+          "INTERNAL",
           "UNAVAILABLE"
         ],
-        "non_idempotent": []
+        "non_idempotent": [],
+        "idempotent2": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
       },
       "retry_params": {
         "default": {
@@ -20,54 +25,59 @@
         }
       },
       "methods": {
-        "ListBuckets": {
+        "DeleteSink": {
           "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
-        "GetBucket": {
+        "UpdateSink": {
           "timeout_millis": 60000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
-        "UpdateBucket": {
+        "DeleteExclusion": {
           "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
+          "retry_codes_name": "idempotent",
           "retry_params_name": "default"
         },
-        "ListSinks": {
+        "ListBuckets": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
-        "GetSink": {
+        "GetBucket": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
-        "CreateSink": {
+        "UpdateBucket": {
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
-        "UpdateSink": {
+        "ListSinks": {
           "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
-        "DeleteSink": {
+        "GetSink": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent2",
+          "retry_params_name": "default"
+        },
+        "CreateSink": {
           "timeout_millis": 60000,
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
         "ListExclusions": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
         "GetExclusion": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
         "CreateExclusion": {
@@ -80,14 +90,9 @@
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default"
         },
-        "DeleteExclusion": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        },
         "GetCmekSettings": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
         "UpdateCmekSettings": {

data/lib/google/cloud/logging/v2/doc/google/logging/v2/log_entry.rb

@@ -74,7 +74,7 @@ module Google
       #     the fractional seconds might be omitted when the timestamp is displayed.
       #
       #     Incoming log entries should have timestamps that are no more than the [logs
-      #     retention period](/logging/quotas) in the past, and no more than 24 hours
+      #     retention period](https://cloud.google.com/logging/quotas) in the past, and no more than 24 hours
       #     in the future. Log entries outside those time boundaries will not be
       #     available when calling `entries.list`, but those log entries can still be
       #     [exported with LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).

data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging.rb

@@ -127,7 +127,7 @@ module Google
       # @!attribute [rw] filter
       #   @return [String]
       #     Optional. A filter that chooses which log entries to return.  See [Advanced
-      #     Logs Queries](/logging/docs/view/advanced-queries).  Only log entries that
+      #     Logs Queries](https://cloud.google.com/logging/docs/view/advanced-queries).  Only log entries that
       #     match the filter are returned.  An empty filter matches all log entries in
       #     the resources listed in `resource_names`. Referencing a parent resource
       #     that is not listed in `resource_names` will cause the filter to return no

data/lib/google/cloud/logging/v2/doc/google/logging/v2/logging_config.rb

@@ -104,7 +104,7 @@ module Google
       #     Until you grant this identity write-access to the destination, log entry
       #     exports from this sink will fail. For more information,
       #     see [Granting Access for a
-      #     Resource](/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource).
+      #     Resource](https://cloud.google.com/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource).
       #     Consult the destination service's documentation to determine the
       #     appropriate IAM roles to assign to the identity.
       # @!attribute [rw] include_children
@@ -155,11 +155,11 @@ module Google
       # @!attribute [rw] use_partitioned_tables
       #   @return [true, false]
       #     Optional. Whether to use [BigQuery's partition
-      #     tables](/bigquery/docs/partitioned-tables). By default, Logging
+      #     tables](https://cloud.google.com/bigquery/docs/partitioned-tables). By default, Logging
       #     creates dated tables based on the log entries' timestamps, e.g.
       #     syslog_20170523. With partitioned tables the date suffix is no longer
       #     present and [special query
-      #     syntax](/bigquery/docs/querying-partitioned-tables) has to be used instead.
+      #     syntax](https://cloud.google.com/bigquery/docs/querying-partitioned-tables) has to be used instead.
       #     In both cases, tables are sharded based on UTC timezone.
       # @!attribute [rw] uses_timestamp_column_partitioning
       #   @return [true, false]
@@ -578,7 +578,7 @@ module Google
       #     Required. The CMEK settings to update.
       #
       #     See [Enabling CMEK for Logs
-      #     Router](/logging/docs/routing/managed-encryption) for more information.
+      #     Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
       #     Optional. Field mask identifying which fields from `cmek_settings` should
@@ -627,7 +627,7 @@ module Google
       #     To disable CMEK for the Logs Router, set this field to an empty string.
       #
       #     See [Enabling CMEK for Logs
-      #     Router](/logging/docs/routing/managed-encryption) for more information.
+      #     Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
       # @!attribute [rw] service_account_id
       #   @return [String]
       #     Output only. The service account that will be used by the Logs Router to access your
@@ -640,7 +640,7 @@ module Google
       #     obtain the service account ID.
       #
       #     See [Enabling CMEK for Logs
-      #     Router](/logging/docs/routing/managed-encryption) for more information.
+      #     Router](https://cloud.google.com/logging/docs/routing/managed-encryption) for more information.
       class CmekSettings; end
 
       # LogBucket lifecycle states (Beta).

data/lib/google/cloud/logging/v2/logging_service_v2_client.rb

@@ -282,11 +282,6 @@ module Google
               &Google::Logging::V2::LoggingServiceV2::Stub.method(:new)
             )
 
-            @write_log_entries = Google::Gax.create_api_call(
-              @logging_service_v2_stub.method(:write_log_entries),
-              defaults["write_log_entries"],
-              exception_transformer: exception_transformer
-            )
             @delete_log = Google::Gax.create_api_call(
               @logging_service_v2_stub.method(:delete_log),
               defaults["delete_log"],
@@ -300,6 +295,11 @@ module Google
               defaults["list_log_entries"],
               exception_transformer: exception_transformer
             )
+            @write_log_entries = Google::Gax.create_api_call(
+              @logging_service_v2_stub.method(:write_log_entries),
+              defaults["write_log_entries"],
+              exception_transformer: exception_transformer
+            )
             @list_monitored_resource_descriptors = Google::Gax.create_api_call(
               @logging_service_v2_stub.method(:list_monitored_resource_descriptors),
               defaults["list_monitored_resource_descriptors"],
@@ -317,122 +317,6 @@ module Google
 
           # Service calls
 
-          # Writes log entries to Logging. This API method is the
-          # only way to send log entries to Logging. This method
-          # is used, directly or indirectly, by the Logging agent
-          # (fluentd) and all logging libraries configured to use Logging.
-          # A single request may contain log entries for a maximum of 1000
-          # different resources (projects, organizations, billing accounts or
-          # folders)
-          #
-          # @param entries [Array<Google::Logging::V2::LogEntry | Hash>]
-          #   Required. The log entries to send to Logging. The order of log
-          #   entries in this list does not matter. Values supplied in this method'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
-          #   {Google::Logging::V2::LogEntry 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/quota-policy) 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/quota-policy) 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.
-          #   A hash of the same form as `Google::Logging::V2::LogEntry`
-          #   can also be provided.
-          # @param log_name [String]
-          #   Optional. A default log resource name that is assigned to all log entries
-          #   in `entries` that do not specify a value for `log_name`:
-          #
-          #       "projects/[PROJECT_ID]/logs/[LOG_ID]"
-          #       "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
-          #       "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
-          #       "folders/[FOLDER_ID]/logs/[LOG_ID]"
-          #
-          #   `[LOG_ID]` must be URL-encoded. For example:
-          #
-          #       "projects/my-project-id/logs/syslog"
-          #       "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
-          #
-          #   The permission `logging.logEntries.create` is needed on each project,
-          #   organization, billing account, or folder that is receiving new log
-          #   entries, whether the resource is specified in `logName` or in an
-          #   individual log entry.
-          # @param resource [Google::Api::MonitoredResource | Hash]
-          #   Optional. A default monitored resource object that is assigned to all log
-          #   entries in `entries` that do not specify a value for `resource`. Example:
-          #
-          #       { "type": "gce_instance",
-          #         "labels": {
-          #           "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
-          #
-          #   See {Google::Logging::V2::LogEntry LogEntry}.
-          #   A hash of the same form as `Google::Api::MonitoredResource`
-          #   can also be provided.
-          # @param labels [Hash{String => String}]
-          #   Optional. Default labels that are added to the `labels` field of all log
-          #   entries in `entries`. If a log entry already has a label with the same key
-          #   as a label in this parameter, then the log entry's label is not changed.
-          #   See {Google::Logging::V2::LogEntry LogEntry}.
-          # @param partial_success [true, false]
-          #   Optional. Whether valid entries should be written even if some other
-          #   entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
-          #   entry is not written, then the response status is the error associated
-          #   with one of the failed entries and the response includes error details
-          #   keyed by the entries' zero-based index in the `entries.write` method.
-          # @param dry_run [true, false]
-          #   Optional. If true, the request should expect normal response, but the
-          #   entries won't be persisted nor exported. Useful for checking whether the
-          #   logging API endpoints are working properly before sending valuable data.
-          # @param options [Google::Gax::CallOptions]
-          #   Overrides the default settings for this call, e.g, timeout,
-          #   retries, etc.
-          # @yield [result, operation] Access the result along with the RPC operation
-          # @yieldparam result [Google::Logging::V2::WriteLogEntriesResponse]
-          # @yieldparam operation [GRPC::ActiveCall::Operation]
-          # @return [Google::Logging::V2::WriteLogEntriesResponse]
-          # @raise [Google::Gax::GaxError] if the RPC is aborted.
-          # @example
-          #   require "google/cloud/logging/v2"
-          #
-          #   logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
-          #
-          #   # TODO: Initialize `entries`:
-          #   entries = []
-          #   response = logging_client.write_log_entries(entries)
-
-          def write_log_entries \
-              entries,
-              log_name: nil,
-              resource: nil,
-              labels: nil,
-              partial_success: nil,
-              dry_run: nil,
-              options: nil,
-              &block
-            req = {
-              entries: entries,
-              log_name: log_name,
-              resource: resource,
-              labels: labels,
-              partial_success: partial_success,
-              dry_run: dry_run
-            }.delete_if { |_, v| v.nil? }
-            req = Google::Gax::to_proto(req, Google::Logging::V2::WriteLogEntriesRequest)
-            @write_log_entries.call(req, options, &block)
-          end
-
           # Deletes all the log entries in a log. The log reappears if it receives new
           # entries. Log entries written shortly before the delete operation might not
           # be deleted. Entries received after the delete operation with a timestamp
@@ -496,7 +380,7 @@ module Google
           #   Projects listed in the `project_ids` field are added to this list.
           # @param filter [String]
           #   Optional. A filter that chooses which log entries to return.  See [Advanced
-          #   Logs Queries](/logging/docs/view/advanced-queries).  Only log entries that
+          #   Logs Queries](https://cloud.google.com/logging/docs/view/advanced-queries).  Only log entries that
           #   match the filter are returned.  An empty filter matches all log entries in
           #   the resources listed in `resource_names`. Referencing a parent resource
           #   that is not listed in `resource_names` will cause the filter to return no
@@ -565,6 +449,122 @@ module Google
             @list_log_entries.call(req, options, &block)
           end
 
+          # Writes log entries to Logging. This API method is the
+          # only way to send log entries to Logging. This method
+          # is used, directly or indirectly, by the Logging agent
+          # (fluentd) and all logging libraries configured to use Logging.
+          # A single request may contain log entries for a maximum of 1000
+          # different resources (projects, organizations, billing accounts or
+          # folders)
+          #
+          # @param entries [Array<Google::Logging::V2::LogEntry | Hash>]
+          #   Required. The log entries to send to Logging. The order of log
+          #   entries in this list does not matter. Values supplied in this method'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
+          #   {Google::Logging::V2::LogEntry 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/quota-policy) 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/quota-policy) 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.
+          #   A hash of the same form as `Google::Logging::V2::LogEntry`
+          #   can also be provided.
+          # @param log_name [String]
+          #   Optional. A default log resource name that is assigned to all log entries
+          #   in `entries` that do not specify a value for `log_name`:
+          #
+          #       "projects/[PROJECT_ID]/logs/[LOG_ID]"
+          #       "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
+          #       "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
+          #       "folders/[FOLDER_ID]/logs/[LOG_ID]"
+          #
+          #   `[LOG_ID]` must be URL-encoded. For example:
+          #
+          #       "projects/my-project-id/logs/syslog"
+          #       "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
+          #
+          #   The permission `logging.logEntries.create` is needed on each project,
+          #   organization, billing account, or folder that is receiving new log
+          #   entries, whether the resource is specified in `logName` or in an
+          #   individual log entry.
+          # @param resource [Google::Api::MonitoredResource | Hash]
+          #   Optional. A default monitored resource object that is assigned to all log
+          #   entries in `entries` that do not specify a value for `resource`. Example:
+          #
+          #       { "type": "gce_instance",
+          #         "labels": {
+          #           "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
+          #
+          #   See {Google::Logging::V2::LogEntry LogEntry}.
+          #   A hash of the same form as `Google::Api::MonitoredResource`
+          #   can also be provided.
+          # @param labels [Hash{String => String}]
+          #   Optional. Default labels that are added to the `labels` field of all log
+          #   entries in `entries`. If a log entry already has a label with the same key
+          #   as a label in this parameter, then the log entry's label is not changed.
+          #   See {Google::Logging::V2::LogEntry LogEntry}.
+          # @param partial_success [true, false]
+          #   Optional. Whether valid entries should be written even if some other
+          #   entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
+          #   entry is not written, then the response status is the error associated
+          #   with one of the failed entries and the response includes error details
+          #   keyed by the entries' zero-based index in the `entries.write` method.
+          # @param dry_run [true, false]
+          #   Optional. If true, the request should expect normal response, but the
+          #   entries won't be persisted nor exported. Useful for checking whether the
+          #   logging API endpoints are working properly before sending valuable data.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Logging::V2::WriteLogEntriesResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Logging::V2::WriteLogEntriesResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/logging/v2"
+          #
+          #   logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
+          #
+          #   # TODO: Initialize `entries`:
+          #   entries = []
+          #   response = logging_client.write_log_entries(entries)
+
+          def write_log_entries \
+              entries,
+              log_name: nil,
+              resource: nil,
+              labels: nil,
+              partial_success: nil,
+              dry_run: nil,
+              options: nil,
+              &block
+            req = {
+              entries: entries,
+              log_name: log_name,
+              resource: resource,
+              labels: labels,
+              partial_success: partial_success,
+              dry_run: dry_run
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Logging::V2::WriteLogEntriesRequest)
+            @write_log_entries.call(req, options, &block)
+          end
+
           # Lists the descriptors for monitored resource types used by Logging.
           #
           # @param page_size [Integer]

data/lib/google/cloud/logging/v2/logging_service_v2_client_config.json

@@ -4,9 +4,14 @@
       "retry_codes": {
         "idempotent": [
           "DEADLINE_EXCEEDED",
+          "INTERNAL",
           "UNAVAILABLE"
         ],
-        "non_idempotent": []
+        "non_idempotent": [],
+        "idempotent2": [
+          "DEADLINE_EXCEEDED",
+          "UNAVAILABLE"
+        ]
       },
       "retry_params": {
         "default": {
@@ -20,9 +25,19 @@
         }
       },
       "methods": {
+        "DeleteLog": {
+          "timeout_millis": 60000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ListLogEntries": {
+          "timeout_millis": 10000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
         "WriteLogEntries": {
           "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
+          "retry_codes_name": "idempotent",
           "retry_params_name": "default",
           "bundling": {
             "element_count_threshold": 1000,
@@ -30,24 +45,14 @@
             "delay_threshold_millis": 50
           }
         },
-        "DeleteLog": {
-          "timeout_millis": 60000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        },
-        "ListLogEntries": {
-          "timeout_millis": 10000,
-          "retry_codes_name": "non_idempotent",
-          "retry_params_name": "default"
-        },
         "ListMonitoredResourceDescriptors": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         },
         "ListLogs": {
           "timeout_millis": 60000,
-          "retry_codes_name": "idempotent",
+          "retry_codes_name": "idempotent2",
           "retry_params_name": "default"
         }
       }