google-cloud-logging 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9844d4e41540ef97cb06a18febc80c45155d6296032a532b31e26cc00a7eeca9
-  data.tar.gz: 5e1b5a06346223d342873406bd87cea59d441458d88192f0000a0d4e43f006d1
+  metadata.gz: ee004a9efbc88d8ced69bdde05d9e4521d0cc9f1a006bbd6fdcb539f853e5582
+  data.tar.gz: 43343b033df5a5bd66aa8a9f7417ab6e7332da0ea9430b6855bdb52d6f88e834
 SHA512:
-  metadata.gz: 787ed9af979f2bdb9211ce456e06d40e05b2c397dd1a0750e228ae7dd5ccc6f6a4d0b407a3afdbed2a59a80439bb8a13745f081dd1190aa9e43887c8b70992ba
-  data.tar.gz: f4d201182423411533d12373d21199e659221364e5753d610cf2910b13eade54a15da8843a33867b43d771bc2d3048daeae5edac18ed1f4f19f32f4c94e33d17
+  metadata.gz: 47cb8309e35749c7ba29f543d71e8b669ace098e685d549e6f535199d0cb773ce079fae304151270cf2fb1f38c5e5160e1029c32aba913659ec80e344a7fc99a
+  data.tar.gz: 8cc34860166a40a49b94c5605ae96443cf5c2d7030eea726ffd17b7f431aa36a6f03855cb71bc3e9e2b6f3a3d615162c61ae283d12eb96d998e0c46d2b75ec5c

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Release History
 
+### 1.8.0 / 2019-10-03
+
+#### Features
+
+* Support additional fields of LogSink in the low-level interface
+  * Add LogSink#create_time field
+  * Add LogSink#update_time field
+  * Add LogSink#bigquery_options field
+  * Add BigQueryOptions type
+  * Update documentation
+
 ### 1.7.0 / 2019-08-23
 
 #### Features

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

@@ -33,8 +33,7 @@ module Google
   module Cloud
     module Logging
       module V2
-        # Service for configuring sinks used to export log entries out of
-        # Logging.
+        # Service for configuring sinks used to route log entries.
         #
         # @!attribute [r] config_service_v2_stub
         #   @return [Google::Logging::V2::ConfigServiceV2::Stub]
@@ -562,9 +561,9 @@ module Google
             @get_sink.call(req, options, &block)
           end
 
-          # Creates a sink that exports specified log entries to a destination.  The
+          # Creates a sink that exports specified log entries to a destination. The
           # export of newly-ingested log entries begins immediately, unless the sink's
-          # `writer_identity` is not permitted to write to the destination.  A sink can
+          # `writer_identity` is not permitted to write to the destination. A sink can
           # export log entries only from the resource owning the sink.
           #
           # @param parent [String]
@@ -583,17 +582,16 @@ module Google
           #   can also be provided.
           # @param unique_writer_identity [true, false]
           #   Optional. Determines the kind of IAM identity returned as `writer_identity`
-          #   in the new sink.  If this value is omitted or set to false, and if the
+          #   in the new sink. If this value is omitted or set to false, and if the
           #   sink's parent is a project, then the value returned as `writer_identity` is
-          #   the same group or service account used by Logging before the
-          #   addition of writer identities to this API. The sink's destination must be
-          #   in the same project as the sink itself.
+          #   the same group or service account used by Logging before the addition of
+          #   writer identities to this API. The sink's destination must be in the same
+          #   project as the sink itself.
           #
           #   If this field is set to true, or if the sink is owned by a non-project
           #   resource such as an organization, then the value of `writer_identity` will
-          #   be a unique service account used only for exports from the new sink.  For
-          #   more information, see `writer_identity` in
-          #   {Google::Logging::V2::LogSink LogSink}.
+          #   be a unique service account used only for exports from the new sink. For
+          #   more information, see `writer_identity` in {Google::Logging::V2::LogSink LogSink}.
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -627,8 +625,9 @@ module Google
             @create_sink.call(req, options, &block)
           end
 
-          # Updates a sink.  This method replaces the following fields in the existing
+          # Updates a sink. This method replaces the following fields in the existing
           # sink with values from the new sink: `destination`, and `filter`.
+          #
           # The updated sink might also have a new `writer_identity`; see the
           # `unique_writer_identity` field.
           #
@@ -648,9 +647,8 @@ module Google
           #   A hash of the same form as `Google::Logging::V2::LogSink`
           #   can also be provided.
           # @param unique_writer_identity [true, false]
-          #   Optional. See
-          #   [sinks.create](https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create)
-          #   for a description of this field.  When updating a sink, the effect of this
+          #   Optional. See {Google::Logging::V2::ConfigServiceV2#create_sink}
+          #   for a description of this field. When updating a sink, the effect of this
           #   field on the value of `writer_identity` in the updated sink depends on both
           #   the old and new values of this field:
           #
@@ -663,7 +661,7 @@ module Google
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
           #   Optional. Field mask that specifies the fields in `sink` that need
           #   an update. A sink field will be overwritten if, and only if, it is
-          #   in the update mask.  `name` and output only fields cannot be updated.
+          #   in the update mask. `name` and output only fields cannot be updated.
           #
           #   An empty updateMask is temporarily treated as using the following mask
           #   for backwards compatibility purposes:
@@ -913,11 +911,10 @@ module Google
           #   A hash of the same form as `Google::Logging::V2::LogExclusion`
           #   can also be provided.
           # @param update_mask [Google::Protobuf::FieldMask | Hash]
-          #   Required. A nonempty list of fields to change in the existing exclusion.
+          #   Required. A non-empty list of fields to change in the existing exclusion.
           #   New values for the fields are taken from the corresponding fields in the
-          #   {Google::Logging::V2::LogExclusion LogExclusion} included in this request.
-          #   Fields not mentioned in `update_mask` are not changed and are ignored in
-          #   the request.
+          #   {Google::Logging::V2::LogExclusion LogExclusion} included in this request. Fields not mentioned in
+          #   `update_mask` are not changed and are ignored in the request.
           #
           #   For example, to change the filter and description of an exclusion,
           #   specify an `update_mask` of `"filter,description"`.

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

@@ -26,9 +26,9 @@ module Google
       #         "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
       #         "folders/[FOLDER_ID]/logs/[LOG_ID]"
       #
-      #      A project number may optionally be used in place of PROJECT_ID. The
-      #      project number is translated to its corresponding PROJECT_ID internally
-      #      and the `log_name` field will contain PROJECT_ID in queries and exports.
+      #     A project number may optionally be used in place of PROJECT_ID. The project
+      #     number is translated to its corresponding PROJECT_ID internally and the
+      #     `log_name` field will contain PROJECT_ID in queries and exports.
       #
       #     `[LOG_ID]` must be URL-encoded within `log_name`. Example:
       #     `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
@@ -43,15 +43,21 @@ module Google
       #     any results.
       # @!attribute [rw] resource
       #   @return [Google::Api::MonitoredResource]
-      #     Required. The primary monitored resource associated with this log entry.
-      #     Example: a log entry that reports a database error would be
-      #     associated with the monitored resource designating the particular
-      #     database that reported the error.
+      #     Required. The monitored resource that produced this log entry.
+      #
+      #     Example: a log entry that reports a database error would be associated with
+      #     the monitored resource designating the particular database that reported
+      #     the error.
       # @!attribute [rw] proto_payload
       #   @return [Google::Protobuf::Any]
-      #     The log entry payload, represented as a protocol buffer.  Some
-      #     Google Cloud Platform services use this field for their log
-      #     entry payloads.
+      #     The log entry payload, represented as a protocol buffer. Some Google
+      #     Cloud Platform services use this field for their log entry payloads.
+      #
+      #     The following protocol buffer types are supported; user-defined types
+      #     are not supported:
+      #
+      #       "type.googleapis.com/google.cloud.audit.AuditLog"
+      #       "type.googleapis.com/google.appengine.logging.v1.RequestLog"
       # @!attribute [rw] text_payload
       #   @return [String]
       #     The log entry payload, represented as a Unicode string (UTF-8).
@@ -61,19 +67,18 @@ module Google
       #     expressed as a JSON object.
       # @!attribute [rw] timestamp
       #   @return [Google::Protobuf::Timestamp]
-      #     Optional. The time the event described by the log entry occurred.
-      #     This time is used to compute the log entry's age and to enforce
-      #     the logs retention period. If this field is omitted in a new log
-      #     entry, then Logging assigns it the current time.
-      #     Timestamps have nanosecond accuracy, but trailing zeros in the fractional
-      #     seconds might be omitted when the timestamp is displayed.
+      #     Optional. The time the event described by the log entry occurred.  This
+      #     time is used to compute the log entry's age and to enforce the logs
+      #     retention period. If this field is omitted in a new log entry, then Logging
+      #     assigns it the current time.  Timestamps have nanosecond accuracy, but
+      #     trailing zeros in 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](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).
+      #     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
+      #     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).
       # @!attribute [rw] receive_timestamp
       #   @return [Google::Protobuf::Timestamp]
       #     Output only. The time the log entry was received by Logging.
@@ -84,24 +89,30 @@ module Google
       # @!attribute [rw] insert_id
       #   @return [String]
       #     Optional. A unique identifier for the log entry. If you provide a value,
-      #     then Logging considers other log entries in the same project,
-      #     with the same `timestamp`, and with the same `insert_id` to be duplicates
-      #     which can be removed.  If omitted in new log entries, then
-      #     Logging assigns its own unique identifier. The `insert_id` is also used
-      #     to order log entries that have the same `timestamp` value.
+      #     then Logging considers other log entries in the same project, with the same
+      #     `timestamp`, and with the same `insert_id` to be duplicates which can be
+      #     removed. If omitted in new log entries, then Logging assigns its own unique
+      #     identifier. The `insert_id` is also used to order log entries that have the
+      #     same `timestamp` value.
       # @!attribute [rw] http_request
       #   @return [Google::Logging::Type::HttpRequest]
-      #     Optional. Information about the HTTP request associated with this
-      #     log entry, if applicable.
+      #     Optional. Information about the HTTP request associated with this log
+      #     entry, if applicable.
       # @!attribute [rw] labels
       #   @return [Hash{String => String}]
       #     Optional. A set of user-defined (key, value) data that provides additional
       #     information about the log entry.
       # @!attribute [rw] metadata
       #   @return [Google::Api::MonitoredResourceMetadata]
-      #     Output only. Additional metadata about the monitored resource.
+      #     Deprecated. Output only. Additional metadata about the monitored resource.
+      #
       #     Only `k8s_container`, `k8s_pod`, and `k8s_node` MonitoredResources have
-      #     this field populated.
+      #     this field populated for GKE versions older than 1.12.6. For GKE versions
+      #     1.12.6 and above, the `metadata` field has been deprecated. The Kubernetes
+      #     pod labels that used to be in `metadata.userLabels` will now be present in
+      #     the `labels` field with a key prefix of `k8s-pod/`. The Stackdriver system
+      #     labels that were present in the `metadata.systemLabels` field will no
+      #     longer be available in the LogEntry.
       # @!attribute [rw] operation
       #   @return [Google::Logging::V2::LogEntryOperation]
       #     Optional. Information about an operation associated with the log entry, if
@@ -115,12 +126,14 @@ module Google
       # @!attribute [rw] span_id
       #   @return [String]
       #     Optional. The span ID within the trace associated with the log entry.
-      #     For Trace spans, this is the same format that the Trace
-      #     API v2 uses: a 16-character hexadecimal encoding of an 8-byte array, such
-      #     as <code>"000000000000004a"</code>.
+      #
+      #     For Trace spans, this is the same format that the Trace API v2 uses: a
+      #     16-character hexadecimal encoding of an 8-byte array, such as
+      #     <code>"000000000000004a"</code>.
       # @!attribute [rw] trace_sampled
       #   @return [true, false]
       #     Optional. The sampling decision of the trace associated with the log entry.
+      #
       #     True means that the trace resource name in the `trace` field was sampled
       #     for storage in a trace backend. False means that the trace was not sampled
       #     for storage when this log entry was written, or the sampling decision was
@@ -136,12 +149,12 @@ module Google
       # a log entry is associated.
       # @!attribute [rw] id
       #   @return [String]
-      #     Optional. An arbitrary operation identifier. Log entries with the
-      #     same identifier are assumed to be part of the same operation.
+      #     Optional. An arbitrary operation identifier. Log entries with the same
+      #     identifier are assumed to be part of the same operation.
       # @!attribute [rw] producer
       #   @return [String]
-      #     Optional. An arbitrary producer identifier. The combination of
-      #     `id` and `producer` must be globally unique.  Examples for `producer`:
+      #     Optional. An arbitrary producer identifier. The combination of `id` and
+      #     `producer` must be globally unique. Examples for `producer`:
       #     `"MyDivision.MyBigCompany.com"`, `"github.com/MyProject/MyApplication"`.
       # @!attribute [rw] first
       #   @return [true, false]

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

@@ -87,8 +87,8 @@ module Google
       #     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).
+      #     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`,
@@ -117,9 +117,7 @@ module Google
       #   @return [Array<String>]
       #     Deprecated. Use `resource_names` instead.  One or more project identifiers
       #     or project numbers from which to retrieve log entries.  Example:
-      #     `"my-project-1A"`. If present, these project identifiers are converted to
-      #     resource name format and added to the list of resources in
-      #     `resource_names`.
+      #     `"my-project-1A"`.
       # @!attribute [rw] resource_names
       #   @return [Array<String>]
       #     Required. Names of one or more parent resources from which to
@@ -130,6 +128,7 @@ module Google
       #         "billingAccounts/[BILLING_ACCOUNT_ID]"
       #         "folders/[FOLDER_ID]"
       #
+      #
       #     Projects listed in the `project_ids` field are added to this list.
       # @!attribute [rw] filter
       #   @return [String]
@@ -232,8 +231,8 @@ module Google
       # @!attribute [rw] log_names
       #   @return [Array<String>]
       #     A list of log names. For example,
-      #     `"projects/my-project/syslog"` or
-      #     `"organizations/123/cloudresourcemanager.googleapis.com%2Factivity"`.
+      #     `"projects/my-project/logs/syslog"` or
+      #     `"organizations/123/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
       # @!attribute [rw] next_page_token
       #   @return [String]
       #     If there might be more results than those appearing in this response, then

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

@@ -18,13 +18,13 @@ module Google
     module V2
       # Describes a sink used to export log entries to one of the following
       # destinations in any project: a Cloud Storage bucket, a BigQuery dataset, or a
-      # Cloud Pub/Sub topic.  A logs filter controls which log entries are
-      # exported. The sink must be created within a project, organization, billing
-      # account, or folder.
+      # Cloud Pub/Sub topic. A logs filter controls which log entries are exported.
+      # The sink must be created within a project, organization, billing account, or
+      # folder.
       # @!attribute [rw] name
       #   @return [String]
       #     Required. The client-assigned sink identifier, unique within the
-      #     project. Example: `"my-syslog-errors-to-pubsub"`.  Sink identifiers are
+      #     project. Example: `"my-syslog-errors-to-pubsub"`. Sink identifiers are
       #     limited to 100 characters and can include only the following characters:
       #     upper and lower-case alphanumeric characters, underscores, hyphens, and
       #     periods.
@@ -38,34 +38,33 @@ module Google
       #
       #     The sink's `writer_identity`, set when the sink is created, must
       #     have permission to write to the destination or else the log
-      #     entries are not exported.  For more information, see
-      #     [Exporting Logs With Sinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
+      #     entries are not exported. For more information, see
+      #     [Exporting Logs with Sinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
       # @!attribute [rw] filter
       #   @return [String]
-      #     Optional.
-      #     An [advanced logs filter](https://cloud.google.com/logging/docs/view/advanced_filters).  The only
+      #     Optional. An [advanced logs filter](https://cloud.google.com/logging/docs/view/advanced-queries). The only
       #     exported log entries are those that are in the resource owning the sink and
-      #     that match the filter.  For example:
+      #     that match the filter. For example:
       #
       #         logName="projects/[PROJECT_ID]/logs/[LOG_ID]" AND severity>=ERROR
       # @!attribute [rw] output_version_format
       #   @return [Google::Logging::V2::LogSink::VersionFormat]
       #     Deprecated. The log entry format to use for this sink's exported log
-      #     entries.  The v2 format is used by default and cannot be changed.
+      #     entries. The v2 format is used by default and cannot be changed.
       # @!attribute [rw] writer_identity
       #   @return [String]
       #     Output only. An IAM identity—a service account or group—under
-      #     which Logging writes the exported log entries to the sink's
-      #     destination.  This field is set by
-      #     [sinks.create](https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create)
+      #     which Logging writes the exported log entries to the sink's destination.
+      #     This field is set by
+      #     {Google::Logging::V2::ConfigServiceV2#create_sink}
       #     and
-      #     [sinks.update](https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/update),
-      #     based on the setting of `unique_writer_identity` in those methods.
+      #     {Google::Logging::V2::ConfigServiceV2#update_sink}
+      #     based on the value of `unique_writer_identity` in those methods.
       #
       #     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).
+      #     see [Granting Access for a
+      #     Resource](/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
@@ -83,12 +82,25 @@ module Google
       #
       #         logName:("projects/test-project1/" OR "projects/test-project2/") AND
       #         resource.type=gce_instance
+      # @!attribute [rw] bigquery_options
+      #   @return [Google::Logging::V2::BigQueryOptions]
+      #     Optional. Options that affect sinks exporting data to BigQuery.
+      # @!attribute [rw] create_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The creation timestamp of the sink.
+      #
+      #     This field may not be present for older sinks.
+      # @!attribute [rw] update_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The last update timestamp of the sink.
+      #
+      #     This field may not be present for older sinks.
       # @!attribute [rw] start_time
       #   @return [Google::Protobuf::Timestamp]
-      #     Deprecated. This field is ignored when creating or updating sinks.
+      #     Do not use. This field is ignored.
       # @!attribute [rw] end_time
       #   @return [Google::Protobuf::Timestamp]
-      #     Deprecated. This field is ignored when creating or updating sinks.
+      #     Do not use. This field is ignored.
       class LogSink
         # Available log entry formats. Log entries can be written to
         # Logging in either format and can be exported in either format.
@@ -105,6 +117,18 @@ module Google
         end
       end
 
+      # Options that change functionality of a sink exporting data to BigQuery.
+      # @!attribute [rw] use_partitioned_tables
+      #   @return [true, false]
+      #     Optional. Whether to use [BigQuery's partition
+      #     tables](/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.
+      #     In both cases, tables are sharded based on UTC timezone.
+      class BigQueryOptions; end
+
       # The parameters to `ListSinks`.
       # @!attribute [rw] parent
       #   @return [String]
@@ -117,13 +141,13 @@ module Google
       # @!attribute [rw] page_token
       #   @return [String]
       #     Optional. If present, then retrieve the next batch of results from the
-      #     preceding call to this method.  `pageToken` must be the value of
-      #     `nextPageToken` from the previous response.  The values of other method
+      #     preceding call to this method. `pageToken` must be the value of
+      #     `nextPageToken` from the previous response. The values of other method
       #     parameters should be identical to those in the previous call.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Optional. The maximum number of results to return from this request.
-      #     Non-positive values are ignored.  The presence of `nextPageToken` in the
+      #     Non-positive values are ignored. The presence of `nextPageToken` in the
       #     response indicates that more results might be available.
       class ListSinksRequest; end
 
@@ -134,7 +158,7 @@ module Google
       # @!attribute [rw] next_page_token
       #   @return [String]
       #     If there might be more results than appear in this response, then
-      #     `nextPageToken` is included.  To get the next set of results, call the same
+      #     `nextPageToken` is included. To get the next set of results, call the same
       #     method again using the value of `nextPageToken` as `pageToken`.
       class ListSinksResponse; end
 
@@ -169,17 +193,16 @@ module Google
       # @!attribute [rw] unique_writer_identity
       #   @return [true, false]
       #     Optional. Determines the kind of IAM identity returned as `writer_identity`
-      #     in the new sink.  If this value is omitted or set to false, and if the
+      #     in the new sink. If this value is omitted or set to false, and if the
       #     sink's parent is a project, then the value returned as `writer_identity` is
-      #     the same group or service account used by Logging before the
-      #     addition of writer identities to this API. The sink's destination must be
-      #     in the same project as the sink itself.
+      #     the same group or service account used by Logging before the addition of
+      #     writer identities to this API. The sink's destination must be in the same
+      #     project as the sink itself.
       #
       #     If this field is set to true, or if the sink is owned by a non-project
       #     resource such as an organization, then the value of `writer_identity` will
-      #     be a unique service account used only for exports from the new sink.  For
-      #     more information, see `writer_identity` in
-      #     {Google::Logging::V2::LogSink LogSink}.
+      #     be a unique service account used only for exports from the new sink. For
+      #     more information, see `writer_identity` in {Google::Logging::V2::LogSink LogSink}.
       class CreateSinkRequest; end
 
       # The parameters to `UpdateSink`.
@@ -200,9 +223,8 @@ module Google
       #     as part of `sink_name`.
       # @!attribute [rw] unique_writer_identity
       #   @return [true, false]
-      #     Optional. See
-      #     [sinks.create](https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create)
-      #     for a description of this field.  When updating a sink, the effect of this
+      #     Optional. See {Google::Logging::V2::ConfigServiceV2#create_sink}
+      #     for a description of this field. When updating a sink, the effect of this
       #     field on the value of `writer_identity` in the updated sink depends on both
       #     the old and new values of this field:
       #
@@ -216,7 +238,7 @@ module Google
       #   @return [Google::Protobuf::FieldMask]
       #     Optional. Field mask that specifies the fields in `sink` that need
       #     an update. A sink field will be overwritten if, and only if, it is
-      #     in the update mask.  `name` and output only fields cannot be updated.
+      #     in the update mask. `name` and output only fields cannot be updated.
       #
       #     An empty updateMask is temporarily treated as using the following mask
       #     for backwards compatibility purposes:
@@ -245,11 +267,11 @@ module Google
       class DeleteSinkRequest; end
 
       # Specifies a set of log entries that are not to be stored in
-      # Logging. If your project receives a large volume of logs, you might be able
-      # to use exclusions to reduce your chargeable logs. Exclusions are processed
-      # after log sinks, so you can export log entries before they are excluded.
-      # Audit log entries and log entries from Amazon Web Services are never
-      # excluded.
+      # Logging. If your GCP resource receives a large volume of logs, you can
+      # use exclusions to reduce your chargeable logs. Exclusions are
+      # processed after log sinks, so you can export log entries before they are
+      # excluded. Note that organization-level and folder-level exclusions don't
+      # apply to child resources, and that you can't exclude audit log entries.
       # @!attribute [rw] name
       #   @return [String]
       #     Required. A client-assigned identifier, such as
@@ -260,21 +282,30 @@ module Google
       #     Optional. A description of this exclusion.
       # @!attribute [rw] filter
       #   @return [String]
-      #     Required.
-      #     An [advanced logs filter](https://cloud.google.com/logging/docs/view/advanced_filters)
+      #     Required. An [advanced logs filter](https://cloud.google.com/logging/docs/view/advanced-queries)
       #     that matches the log entries to be excluded. By using the
-      #     [sample function](https://cloud.google.com/logging/docs/view/advanced_filters#sample),
+      #     [sample function](https://cloud.google.com/logging/docs/view/advanced-queries#sample),
       #     you can exclude less than 100% of the matching log entries.
-      #     For example, the following filter matches 99% of low-severity log
-      #     entries from load balancers:
+      #     For example, the following query matches 99% of low-severity log
+      #     entries from Google Cloud Storage buckets:
       #
-      #     `"resource.type=http_load_balancer severity<ERROR sample(insertId, 0.99)"`
+      #     `"resource.type=gcs_bucket severity<ERROR sample(insertId, 0.99)"`
       # @!attribute [rw] disabled
       #   @return [true, false]
       #     Optional. If set to True, then this exclusion is disabled and it does not
-      #     exclude any log entries. You can use
-      #     [exclusions.patch](https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.exclusions/patch)
-      #     to change the value of this field.
+      #     exclude any log entries. You can [update an
+      #     exclusion][google.logging.v2.ConfigServiceV2.UpdateExclusion] to change the
+      #     value of this field.
+      # @!attribute [rw] create_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The creation timestamp of the exclusion.
+      #
+      #     This field may not be present for older exclusions.
+      # @!attribute [rw] update_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The last update timestamp of the exclusion.
+      #
+      #     This field may not be present for older exclusions.
       class LogExclusion; end
 
       # The parameters to `ListExclusions`.
@@ -289,13 +320,13 @@ module Google
       # @!attribute [rw] page_token
       #   @return [String]
       #     Optional. If present, then retrieve the next batch of results from the
-      #     preceding call to this method.  `pageToken` must be the value of
-      #     `nextPageToken` from the previous response.  The values of other method
+      #     preceding call to this method. `pageToken` must be the value of
+      #     `nextPageToken` from the previous response. The values of other method
       #     parameters should be identical to those in the previous call.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Optional. The maximum number of results to return from this request.
-      #     Non-positive values are ignored.  The presence of `nextPageToken` in the
+      #     Non-positive values are ignored. The presence of `nextPageToken` in the
       #     response indicates that more results might be available.
       class ListExclusionsRequest; end
 
@@ -306,7 +337,7 @@ module Google
       # @!attribute [rw] next_page_token
       #   @return [String]
       #     If there might be more results than appear in this response, then
-      #     `nextPageToken` is included.  To get the next set of results, call the same
+      #     `nextPageToken` is included. To get the next set of results, call the same
       #     method again using the value of `nextPageToken` as `pageToken`.
       class ListExclusionsResponse; end
 
@@ -357,11 +388,10 @@ module Google
       #     in `update_mask` are relevant.
       # @!attribute [rw] update_mask
       #   @return [Google::Protobuf::FieldMask]
-      #     Required. A nonempty list of fields to change in the existing exclusion.
+      #     Required. A non-empty list of fields to change in the existing exclusion.
       #     New values for the fields are taken from the corresponding fields in the
-      #     {Google::Logging::V2::LogExclusion LogExclusion} included in this request.
-      #     Fields not mentioned in `update_mask` are not changed and are ignored in
-      #     the request.
+      #     {Google::Logging::V2::LogExclusion LogExclusion} included in this request. Fields not mentioned in
+      #     `update_mask` are not changed and are ignored in the request.
       #
       #     For example, to change the filter and description of an exclusion,
       #     specify an `update_mask` of `"filter,description"`.

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

@@ -16,8 +16,8 @@
 module Google
   module Logging
     module V2
-      # Describes a logs-based metric.  The value of the metric is the
-      # number of log entries that match a logs filter in a given time interval.
+      # Describes a logs-based metric. The value of the metric is the number of log
+      # entries that match a logs filter in a given time interval.
       #
       # Logs-based metric can also be used to extract values from logs and create a
       # a distribution of the values. The distribution records the statistics of the
@@ -28,21 +28,20 @@ module Google
       #     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.
+      #     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.
       #
       #     The metric identifier in this field must not be
       #     [URL-encoded](https://en.wikipedia.org/wiki/Percent-encoding).
-      #     However, when the metric identifier appears as the `[METRIC_ID]`
-      #     part of a `metric_name` API parameter, then the metric identifier
-      #     must be URL-encoded. Example:
-      #     `"projects/my-project/metrics/nginx%2Frequests"`.
+      #     However, when the metric identifier appears as the `[METRIC_ID]` part of a
+      #     `metric_name` API parameter, then the metric identifier must be
+      #     URL-encoded. Example: `"projects/my-project/metrics/nginx%2Frequests"`.
       # @!attribute [rw] description
       #   @return [String]
       #     Optional. A description of this metric, which is used in documentation.
+      #     The maximum length of the description is 8000 characters.
       # @!attribute [rw] filter
       #   @return [String]
       #     Required. An [advanced logs filter](https://cloud.google.com/logging/docs/view/advanced_filters)
@@ -117,6 +116,16 @@ module Google
       #     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.
+      # @!attribute [rw] create_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The creation timestamp of the metric.
+      #
+      #     This field may not be present for older metrics.
+      # @!attribute [rw] update_time
+      #   @return [Google::Protobuf::Timestamp]
+      #     Output only. The last update timestamp of the metric.
+      #
+      #     This field may not be present for older metrics.
       # @!attribute [rw] version
       #   @return [Google::Logging::V2::LogMetric::ApiVersion]
       #     Deprecated. The API version that created or updated this metric.
@@ -141,13 +150,13 @@ module Google
       # @!attribute [rw] page_token
       #   @return [String]
       #     Optional. If present, then retrieve the next batch of results from the
-      #     preceding call to this method.  `pageToken` must be the value of
-      #     `nextPageToken` from the previous response.  The values of other method
+      #     preceding call to this method. `pageToken` must be the value of
+      #     `nextPageToken` from the previous response. The values of other method
       #     parameters should be identical to those in the previous call.
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Optional. The maximum number of results to return from this request.
-      #     Non-positive values are ignored.  The presence of `nextPageToken` in the
+      #     Non-positive values are ignored. The presence of `nextPageToken` in the
       #     response indicates that more results might be available.
       class ListLogMetricsRequest; end
 
@@ -158,7 +167,7 @@ module Google
       # @!attribute [rw] next_page_token
       #   @return [String]
       #     If there might be more results than appear in this response, then
-      #     `nextPageToken` is included.  To get the next set of results, call this
+      #     `nextPageToken` is included. To get the next set of results, call this
       #     method again using the value of `nextPageToken` as `pageToken`.
       class ListLogMetricsResponse; end
 

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

@@ -88,11 +88,13 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
+    # standard
+    # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
-    # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
-    # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
-    # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # to this format using
+    # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
+    # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+    # the Joda Time's [`ISODateTimeFormat.dateTime()`](
     # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds

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

@@ -434,8 +434,8 @@ module Google
           #   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).
+          #   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`,
@@ -525,9 +525,9 @@ module Google
             @write_log_entries.call(req, options, &block)
           end
 
-          # Lists log entries.  Use this method to retrieve log entries from
-          # Logging.  For ways to export log entries, see
-          # [Exporting Logs](https://cloud.google.com/logging/docs/export).
+          # Lists log entries.  Use this method to retrieve log entries that originated
+          # from a project/folder/organization/billing account.  For ways to export log
+          # entries, see [Exporting Logs](https://cloud.google.com/logging/docs/export).
           #
           # @param resource_names [Array<String>]
           #   Required. Names of one or more parent resources from which to
@@ -538,13 +538,12 @@ module Google
           #       "billingAccounts/[BILLING_ACCOUNT_ID]"
           #       "folders/[FOLDER_ID]"
           #
+          #
           #   Projects listed in the `project_ids` field are added to this list.
           # @param project_ids [Array<String>]
           #   Deprecated. Use `resource_names` instead.  One or more project identifiers
           #   or project numbers from which to retrieve log entries.  Example:
-          #   `"my-project-1A"`. If present, these project identifiers are converted to
-          #   resource name format and added to the list of resources in
-          #   `resource_names`.
+          #   `"my-project-1A"`.
           # @param filter [String]
           #   Optional. A filter that chooses which log entries to return.  See [Advanced
           #   Logs Filters](/logging/docs/view/advanced_filters).  Only log entries that

data/lib/google/cloud/logging/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Logging
-      VERSION = "1.7.0".freeze
+      VERSION = "1.8.0".freeze
     end
   end
 end

data/lib/google/logging/v2/log_entry_pb.rb

@@ -4,13 +4,14 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/monitored_resource_pb'
 require 'google/logging/type/http_request_pb'
 require 'google/logging/type/log_severity_pb'
 require 'google/protobuf/any_pb'
 require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/rpc/status_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.logging.v2.LogEntry" do
     optional :log_name, :string, 12

data/lib/google/logging/v2/logging_config_pb.rb

@@ -4,10 +4,12 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
+require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.logging.v2.LogSink" do
     optional :name, :string, 1
@@ -16,14 +18,22 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :output_version_format, :enum, 6, "google.logging.v2.LogSink.VersionFormat"
     optional :writer_identity, :string, 8
     optional :include_children, :bool, 9
+    optional :create_time, :message, 13, "google.protobuf.Timestamp"
+    optional :update_time, :message, 14, "google.protobuf.Timestamp"
     optional :start_time, :message, 10, "google.protobuf.Timestamp"
     optional :end_time, :message, 11, "google.protobuf.Timestamp"
+    oneof :options do
+      optional :bigquery_options, :message, 12, "google.logging.v2.BigQueryOptions"
+    end
   end
   add_enum "google.logging.v2.LogSink.VersionFormat" do
     value :VERSION_FORMAT_UNSPECIFIED, 0
     value :V2, 1
     value :V1, 2
   end
+  add_message "google.logging.v2.BigQueryOptions" do
+    optional :use_partitioned_tables, :bool, 1
+  end
   add_message "google.logging.v2.ListSinksRequest" do
     optional :parent, :string, 1
     optional :page_token, :string, 2
@@ -55,6 +65,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :description, :string, 2
     optional :filter, :string, 3
     optional :disabled, :bool, 4
+    optional :create_time, :message, 5, "google.protobuf.Timestamp"
+    optional :update_time, :message, 6, "google.protobuf.Timestamp"
   end
   add_message "google.logging.v2.ListExclusionsRequest" do
     optional :parent, :string, 1
@@ -87,6 +99,7 @@ module Google
     module V2
       LogSink = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink").msgclass
       LogSink::VersionFormat = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.LogSink.VersionFormat").enummodule
+      BigQueryOptions = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.BigQueryOptions").msgclass
       ListSinksRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListSinksRequest").msgclass
       ListSinksResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.ListSinksResponse").msgclass
       GetSinkRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.logging.v2.GetSinkRequest").msgclass

data/lib/google/logging/v2/logging_config_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/logging/v2/logging_config.proto for package 'google.logging.v2'
 # Original file comments:
-# Copyright 2018 Google LLC.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -25,8 +25,7 @@ module Google
   module Logging
     module V2
       module ConfigServiceV2
-        # Service for configuring sinks used to export log entries out of
-        # Logging.
+        # Service for configuring sinks used to route log entries.
         class Service
 
           include GRPC::GenericService
@@ -39,13 +38,14 @@ module Google
           rpc :ListSinks, ListSinksRequest, ListSinksResponse
           # Gets a sink.
           rpc :GetSink, GetSinkRequest, LogSink
-          # Creates a sink that exports specified log entries to a destination.  The
+          # Creates a sink that exports specified log entries to a destination. The
           # export of newly-ingested log entries begins immediately, unless the sink's
-          # `writer_identity` is not permitted to write to the destination.  A sink can
+          # `writer_identity` is not permitted to write to the destination. A sink can
           # export log entries only from the resource owning the sink.
           rpc :CreateSink, CreateSinkRequest, LogSink
-          # Updates a sink.  This method replaces the following fields in the existing
+          # Updates a sink. This method replaces the following fields in the existing
           # sink with values from the new sink: `destination`, and `filter`.
+          #
           # The updated sink might also have a new `writer_identity`; see the
           # `unique_writer_identity` field.
           rpc :UpdateSink, UpdateSinkRequest, LogSink

data/lib/google/logging/v2/logging_metrics_pb.rb

@@ -4,12 +4,13 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/distribution_pb'
 require 'google/api/metric_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.logging.v2.LogMetric" do
     optional :name, :string, 1
@@ -19,6 +20,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :value_extractor, :string, 6
     map :label_extractors, :string, :string, 7
     optional :bucket_options, :message, 8, "google.api.Distribution.BucketOptions"
+    optional :create_time, :message, 9, "google.protobuf.Timestamp"
+    optional :update_time, :message, 10, "google.protobuf.Timestamp"
     optional :version, :enum, 4, "google.logging.v2.LogMetric.ApiVersion"
   end
   add_enum "google.logging.v2.LogMetric.ApiVersion" do

data/lib/google/logging/v2/logging_metrics_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/logging/v2/logging_metrics.proto for package 'google.logging.v2'
 # Original file comments:
-# Copyright 2018 Google LLC.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/google/logging/v2/logging_pb.rb

@@ -4,13 +4,15 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/monitored_resource_pb'
 require 'google/logging/v2/log_entry_pb'
+require 'google/logging/v2/logging_config_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.logging.v2.DeleteLogRequest" do
     optional :log_name, :string, 1

data/lib/google/logging/v2/logging_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/logging/v2/logging.proto for package 'google.logging.v2'
 # Original file comments:
-# Copyright 2018 Google LLC.
+# Copyright 2019 Google LLC.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -47,9 +47,9 @@ module Google
           # different resources (projects, organizations, billing accounts or
           # folders)
           rpc :WriteLogEntries, WriteLogEntriesRequest, WriteLogEntriesResponse
-          # Lists log entries.  Use this method to retrieve log entries from
-          # Logging.  For ways to export log entries, see
-          # [Exporting Logs](/logging/docs/export).
+          # Lists log entries.  Use this method to retrieve log entries that originated
+          # from a project/folder/organization/billing account.  For ways to export log
+          # entries, see [Exporting Logs](/logging/docs/export).
           rpc :ListLogEntries, ListLogEntriesRequest, ListLogEntriesResponse
           # Lists the descriptors for monitored resource types used by Logging.
           rpc :ListMonitoredResourceDescriptors, ListMonitoredResourceDescriptorsRequest, ListMonitoredResourceDescriptorsResponse

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-logging
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-23 00:00:00.000000000 Z
+date: 2019-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-cloud-core