google-cloud-logging 0.24.2 → 1.0.0

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

@@ -22,6 +22,8 @@ module Google
       #
       #         "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"+,
@@ -38,6 +40,8 @@ module Google
       #
       #         "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"+ or
@@ -62,10 +66,16 @@ module Google
       #     See LogEntry.
       # @!attribute [rw] entries
       #   @return [Array<Google::Logging::V2::LogEntry>]
-      #     Required. The log entries to write. Values supplied for the fields
+      #     Required.  The log entries to write. Values supplied for the fields
       #     +log_name+, +resource+, and +labels+ in this +entries.write+ request are
-      #     added to those log entries that do not provide their own values for the
-      #     fields.
+      #     inserted into those log entries in this list that do not provide their own
+      #     values.
+      #
+      #     Stackdriver Logging also creates and inserts values for +timestamp+ and
+      #     +insert_id+ if the entries do not provide them. The created +insert_id+ for
+      #     the N'th entry in this list will be greater than earlier entries and less
+      #     than later entries.  Otherwise, the order of log entries in this list does
+      #     not matter.
       #
       #     To improve throughput and to avoid exceeding the
       #     {quota limit}[https://cloud.google.com/logging/quota-policy] for calls to +entries.write+,
@@ -75,9 +85,9 @@ module Google
       #   @return [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, the response status will be the error associated
-      #     with one of the failed entries and include error details in the form of
-      #     WriteLogEntriesPartialErrors.
+      #     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.
       class WriteLogEntriesRequest; end
 
       # Result returned from WriteLogEntries.
@@ -94,11 +104,13 @@ module Google
       #     +resource_names+.
       # @!attribute [rw] resource_names
       #   @return [Array<String>]
-      #     Required. Names of one or more resources from which to retrieve log
-      #     entries:
+      #     Required. Names of one or more parent resources from which to
+      #     retrieve log entries:
       #
       #         "projects/[PROJECT_ID]"
       #         "organizations/[ORGANIZATION_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]"
+      #         "folders/[FOLDER_ID]"
       #
       #     Projects listed in the +project_ids+ field are added to this list.
       # @!attribute [rw] filter
@@ -117,17 +129,17 @@ module Google
       #     option returns entries in order of increasing values of
       #     +LogEntry.timestamp+ (oldest first), and the second option returns entries
       #     in order of decreasing timestamps (newest first).  Entries with equal
-      #     timestamps are returned in order of +LogEntry.insertId+.
+      #     timestamps are returned in order of their +insert_id+ values.
       # @!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 +next_page_token+ in the
       #     response indicates that more results might be available.
       # @!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.  +page_token+ must be the value of
+      #     +next_page_token+ from the previous response.  The values of other method
       #     parameters should be identical to those in the previous call.
       class ListLogEntriesRequest; end
 
@@ -181,6 +193,8 @@ module Google
       #
       #         "projects/[PROJECT_ID]"
       #         "organizations/[ORGANIZATION_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]"
+      #         "folders/[FOLDER_ID]"
       # @!attribute [rw] page_size
       #   @return [Integer]
       #     Optional. The maximum number of results to return from this request.

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

@@ -18,7 +18,8 @@ module Google
       # 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 or organization.
+      # 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
@@ -102,8 +103,12 @@ module Google
       # The parameters to +ListSinks+.
       # @!attribute [rw] parent
       #   @return [String]
-      #     Required. The parent resource whose sinks are to be listed.
-      #     Examples: +"projects/my-logging-project"+, +"organizations/123456789"+.
+      #     Required. The parent resource whose sinks are to be listed:
+      #
+      #         "projects/[PROJECT_ID]"
+      #         "organizations/[ORGANIZATION_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]"
+      #         "folders/[FOLDER_ID]"
       # @!attribute [rw] page_token
       #   @return [String]
       #     Optional. If present, then retrieve the next batch of results from the
@@ -131,10 +136,12 @@ module Google
       # The parameters to +GetSink+.
       # @!attribute [rw] sink_name
       #   @return [String]
-      #     Required. The parent resource name of the sink:
+      #     Required. The resource name of the sink:
       #
       #         "projects/[PROJECT_ID]/sinks/[SINK_ID]"
       #         "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+      #         "folders/[FOLDER_ID]/sinks/[SINK_ID]"
       #
       #     Example: +"projects/my-project-id/sinks/my-sink-id"+.
       class GetSinkRequest; end
@@ -146,6 +153,8 @@ module Google
       #
       #         "projects/[PROJECT_ID]"
       #         "organizations/[ORGANIZATION_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]"
+      #         "folders/[FOLDER_ID]"
       #
       #     Examples: +"projects/my-logging-project"+, +"organizations/123456789"+.
       # @!attribute [rw] sink
@@ -157,9 +166,9 @@ module Google
       #     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
       #     sink's parent is a project, then the value returned as +writer_identity+ is
-      #     +cloud-logs@google.com+, the same identity used 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 Stackdriver 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
@@ -175,6 +184,8 @@ module Google
       #
       #         "projects/[PROJECT_ID]/sinks/[SINK_ID]"
       #         "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+      #         "folders/[FOLDER_ID]/sinks/[SINK_ID]"
       #
       #     Example: +"projects/my-project-id/sinks/my-sink-id"+.
       # @!attribute [rw] sink
@@ -192,9 +203,9 @@ module Google
       #
       #     +   If the old and new values of this field are both false or both true,
       #         then there is no change to the sink's +writer_identity+.
-      #     +   If the old value was false and the new value is true, then
+      #     +   If the old value is false and the new value is true, then
       #         +writer_identity+ is changed to a unique service account.
-      #     +   It is an error if the old value was true and the new value is false.
+      #     +   It is an error if the old value is true and the new value is false.
       class UpdateSinkRequest; end
 
       # The parameters to +DeleteSink+.
@@ -205,10 +216,10 @@ module Google
       #
       #         "projects/[PROJECT_ID]/sinks/[SINK_ID]"
       #         "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]"
+      #         "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]"
+      #         "folders/[FOLDER_ID]/sinks/[SINK_ID]"
       #
-      #     It is an error if the sink does not exist.  Example:
-      #     +"projects/my-project-id/sinks/my-sink-id"+.  It is an error if
-      #     the sink does not exist.
+      #     Example: +"projects/my-project-id/sinks/my-sink-id"+.
       class DeleteSinkRequest; end
     end
   end

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

@@ -39,6 +39,16 @@ module Google
     #       foo = any.unpack(Foo.class);
     #     }
     #
+    #  Example 3: Pack and unpack a message in Python.
+    #
+    #     foo = Foo(...)
+    #     any = Any()
+    #     any.Pack(foo)
+    #     ...
+    #     if any.Is(Foo.DESCRIPTOR):
+    #       any.Unpack(foo)
+    #       ...
+    #
     # The pack methods provided by protobuf library will by default use
     # 'type.googleapis.com/full.type.name' as the type URL and the unpack
     # methods only use the fully qualified type name after the last '/'
@@ -78,10 +88,10 @@ module Google
     #     A URL/resource name whose content describes the type of the
     #     serialized protocol buffer message.
     #
-    #     For URLs which use the schema +http+, +https+, or no schema, the
+    #     For URLs which use the scheme +http+, +https+, or no scheme, the
     #     following restrictions and interpretations apply:
     #
-    #     * If no schema is provided, +https+ is assumed.
+    #     * If no scheme is provided, +https+ is assumed.
     #     * The last segment of the URL's path must represent the fully
     #       qualified name of the type (as in +path/google.protobuf.Duration+).
     #       The name should be in a canonical form (e.g., leading "." is
@@ -94,7 +104,7 @@ module Google
     #       on changes to types. (Use versioned type names to manage
     #       breaking changes.)
     #
-    #     Schemas other than +http+, +https+ (or the empty schema) might be
+    #     Schemes other than +http+, +https+ (or the empty scheme) might be
     #     used with implementation specific semantics.
     # @!attribute [rw] value
     #   @return [String]

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

@@ -54,6 +54,12 @@ module Google
     #       end.seconds += 1;
     #       end.nanos -= 1000000000;
     #     }
+    #
+    # Example 3: Compute Duration from datetime.timedelta in Python.
+    #
+    #     td = datetime.timedelta(days=3, minutes=10)
+    #     duration = Duration()
+    #     duration.FromTimedelta(td)
     # @!attribute [rw] seconds
     #   @return [Integer]
     #     Signed seconds of the span of time. Must be from -315,576,000,000

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

@@ -63,14 +63,12 @@ module Google
     #
     # Example 5: Compute Timestamp from current time in Python.
     #
-    #     now = time.time()
-    #     seconds = int(now)
-    #     nanos = int((now - seconds) * 10**9)
-    #     timestamp = Timestamp(seconds=seconds, nanos=nanos)
+    #     timestamp = Timestamp()
+    #     timestamp.GetCurrentTime()
     # @!attribute [rw] seconds
     #   @return [Integer]
     #     Represents seconds of UTC time since Unix epoch
-    #     1970-01-01T00:00:00Z. Must be from from 0001-01-01T00:00:00Z to
+    #     1970-01-01T00:00:00Z. Must be from 0001-01-01T00:00:00Z to
     #     9999-12-31T23:59:59Z inclusive.
     # @!attribute [rw] nanos
     #   @return [Integer]

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

@@ -1,10 +1,10 @@
-# Copyright 2016 Google Inc. All rights reserved.
+# Copyright 2017, Google Inc. All rights reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -26,6 +26,7 @@ require "json"
 require "pathname"
 
 require "google/gax"
+
 require "google/logging/v2/logging_pb"
 
 module Google
@@ -235,12 +236,16 @@ module Google
 
           # 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.
           #
           # @param log_name [String]
           #   Required. The resource name of the log to delete:
           #
           #       "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"+,
@@ -270,15 +275,32 @@ module Google
             nil
           end
 
-          # Writes log entries to Stackdriver Logging.  All log entries are
-          # written by this method.
+          # Writes log entries to Stackdriver Logging.
+          #
+          # @param entries [Array<Google::Logging::V2::LogEntry>]
+          #   Required.  The log entries to write. Values supplied for the fields
+          #   +log_name+, +resource+, and +labels+ in this +entries.write+ request are
+          #   inserted into those log entries in this list that do not provide their own
+          #   values.
           #
+          #   Stackdriver Logging also creates and inserts values for +timestamp+ and
+          #   +insert_id+ if the entries do not provide them. The created +insert_id+ for
+          #   the N'th entry in this list will be greater than earlier entries and less
+          #   than later entries.  Otherwise, the order of log entries in this list does
+          #   not matter.
+          #
+          #   To improve throughput and to avoid exceeding the
+          #   {quota limit}[https://cloud.google.com/logging/quota-policy] for calls to +entries.write+,
+          #   you should write multiple log entries at once rather than
+          #   calling this method for each individual log entry.
           # @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"+ or
@@ -299,22 +321,12 @@ module Google
           #   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 LogEntry.
-          # @param entries [Array<Google::Logging::V2::LogEntry>]
-          #   Required. The log entries to write. Values supplied for the fields
-          #   +log_name+, +resource+, and +labels+ in this +entries.write+ request are
-          #   added to those log entries that do not provide their own values for the
-          #   fields.
-          #
-          #   To improve throughput and to avoid exceeding the
-          #   {quota limit}[https://cloud.google.com/logging/quota-policy] for calls to +entries.write+,
-          #   you should write multiple log entries at once rather than
-          #   calling this method for each individual log entry.
           # @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, the response status will be the error associated
-          #   with one of the failed entries and include error details in the form of
-          #   WriteLogEntriesPartialErrors.
+          #   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 options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -350,20 +362,22 @@ module Google
           # Stackdriver Logging.  For ways to export log entries, see
           # {Exporting Logs}[https://cloud.google.com/logging/docs/export].
           #
-          # @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+.
           # @param resource_names [Array<String>]
-          #   Required. Names of one or more resources from which to retrieve log
-          #   entries:
+          #   Required. Names of one or more parent resources from which to
+          #   retrieve log entries:
           #
           #       "projects/[PROJECT_ID]"
           #       "organizations/[ORGANIZATION_ID]"
+          #       "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+.
           # @param filter [String]
           #   Optional. A filter that chooses which log entries to return.  See {Advanced
           #   Logs Filters}[https://cloud.google.com/logging/docs/view/advanced_filters].  Only log entries that
@@ -378,7 +392,7 @@ module Google
           #   option returns entries in order of increasing values of
           #   +LogEntry.timestamp+ (oldest first), and the second option returns entries
           #   in order of decreasing timestamps (newest first).  Entries with equal
-          #   timestamps are returned in order of +LogEntry.insertId+.
+          #   timestamps are returned in order of their +insert_id+ values.
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -479,7 +493,7 @@ module Google
             @list_monitored_resource_descriptors.call(req, options)
           end
 
-          # Lists the logs in projects or organizations.
+          # Lists the logs in projects, organizations, folders, or billing accounts.
           # Only logs that have entries are listed.
           #
           # @param parent [String]
@@ -487,6 +501,8 @@ module Google
           #
           #       "projects/[PROJECT_ID]"
           #       "organizations/[ORGANIZATION_ID]"
+          #       "billingAccounts/[BILLING_ACCOUNT_ID]"
+          #       "folders/[FOLDER_ID]"
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this

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

@@ -6,7 +6,9 @@
           "DEADLINE_EXCEEDED",
           "UNAVAILABLE"
         ],
-        "non_idempotent": []
+        "non_idempotent": [
+          "UNAVAILABLE"
+        ]
       },
       "retry_params": {
         "default": {
@@ -39,9 +41,9 @@
           "retry_codes_name": "non_idempotent",
           "retry_params_name": "default",
           "bundling": {
-            "element_count_threshold": 100,
-            "request_byte_threshold": 1024,
-            "delay_threshold_millis": 10
+            "element_count_threshold": 1000,
+            "request_byte_threshold": 1048576,
+            "delay_threshold_millis": 50
           }
         },
         "ListLogEntries": {

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

@@ -1,10 +1,10 @@
-# Copyright 2016 Google Inc. All rights reserved.
+# Copyright 2017, Google Inc. All rights reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-# http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -26,6 +26,7 @@ require "json"
 require "pathname"
 
 require "google/gax"
+
 require "google/logging/v2/logging_metrics_pb"
 
 module Google