google-cloud-logging 1.5.6 → 1.5.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3f0f56c213ee74340b1ad45478f47ccc2dd6679dab718127bfa4e47e5ba63a37
4
- data.tar.gz: 06d6bf7c11816f05517a7e9b2016d45baebc6dd938c50ab4c4763730481d03c0
3
+ metadata.gz: 1e2ccb4454a6582fc62db7993ea414a404812b896a638d38f5648bfc5873cb33
4
+ data.tar.gz: 4958689bf6ce20e588f13ffa5995b4c316e0ff8762d33a6a052fe2f2427c1bd1
5
5
  SHA512:
6
- metadata.gz: 8b14c0195cb3290431e10b9554d31778eecbd2380694adcf2bc6911848c6d6aff7122906960abcd15f6749c3f49c08d61900c80cdf505641275ce837438f2e9f
7
- data.tar.gz: ecffe6908619f5b2c6d9baa0f5ed785c4ccc129c58f3f5e23c31564b1cb513f28307d3de32c97daa18d74c45c83f89938ec6f6687f2aa30ddd03a26ee01e3e64
6
+ metadata.gz: ec371b02b78e6ae7f128190adfe25d8baf400e9b0dde2b9ea63143fb0df306f945b7148861bd673b09c7a4636a3371626b150773044b2422b1b591ba243164a0
7
+ data.tar.gz: b852883c7e539a9bbe74e433583885f08f585235f3cdb7b3abe842363d6b5436a73a0bbbb731f3dd9a7d0600770704fd4ea9d5383babad377e21bcb357a24fc0
data/CHANGELOG.md CHANGED
@@ -1,5 +1,10 @@
1
1
  # Release History
2
2
 
3
+ ### 1.5.7 / 2018-11-15
4
+
5
+ * Add Google::Logging::V2::LogEntry#trace_sampled.
6
+ * Update low-level documentation.
7
+
3
8
  ### 1.5.6 / 2018-10-03
4
9
 
5
10
  * Use concurrent-ruby and ThreadLocalVar in Logger.
@@ -14,7 +14,6 @@
14
14
 
15
15
 
16
16
  require "logger"
17
- require "thread"
18
17
  require "concurrent"
19
18
 
20
19
  module Google
@@ -32,8 +32,8 @@ module Google
32
32
  module Cloud
33
33
  module Logging
34
34
  module V2
35
- # Service for configuring sinks used to export log entries outside of
36
- # Stackdriver Logging.
35
+ # Service for configuring sinks used to export log entries out of
36
+ # Logging.
37
37
  #
38
38
  # @!attribute [r] config_service_v2_stub
39
39
  # @return [Google::Logging::V2::ConfigServiceV2::Stub]
@@ -401,7 +401,7 @@ module Google
401
401
  # Optional. Determines the kind of IAM identity returned as `writer_identity`
402
402
  # in the new sink. If this value is omitted or set to false, and if the
403
403
  # sink's parent is a project, then the value returned as `writer_identity` is
404
- # the same group or service account used by Stackdriver Logging before the
404
+ # the same group or service account used by Logging before the
405
405
  # addition of writer identities to this API. The sink's destination must be
406
406
  # in the same project as the sink itself.
407
407
  #
@@ -487,7 +487,7 @@ module Google
487
487
  # empty updateMask will be an error.
488
488
  #
489
489
  # For a detailed `FieldMask` definition, see
490
- # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
490
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
491
491
  #
492
492
  # Example: `updateMask=filter`.
493
493
  # A hash of the same form as `Google::Protobuf::FieldMask`
@@ -15,24 +15,25 @@
15
15
 
16
16
  module Google
17
17
  module Api
18
- # Distribution contains summary statistics for a population of values and,
19
- # optionally, a histogram representing the distribution of those values across
20
- # a specified set of histogram buckets.
18
+ # `Distribution` contains summary statistics for a population of values. It
19
+ # optionally contains a histogram representing the distribution of those values
20
+ # across a set of buckets.
21
21
  #
22
22
  # The summary statistics are the count, mean, sum of the squared deviation from
23
23
  # the mean, the minimum, and the maximum of the set of population of values.
24
- #
25
24
  # The histogram is based on a sequence of buckets and gives a count of values
26
- # that fall into each bucket. The boundaries of the buckets are given either
27
- # explicitly or by specifying parameters for a method of computing them
28
- # (buckets of fixed width or buckets of exponentially increasing width).
25
+ # that fall into each bucket. The boundaries of the buckets are given either
26
+ # explicitly or by formulas for buckets of fixed or exponentially increasing
27
+ # widths.
29
28
  #
30
29
  # Although it is not forbidden, it is generally a bad idea to include
31
30
  # non-finite values (infinities or NaNs) in the population of values, as this
32
31
  # will render the `mean` and `sum_of_squared_deviation` fields meaningless.
33
32
  # @!attribute [rw] count
34
33
  # @return [Integer]
35
- # The number of values in the population. Must be non-negative.
34
+ # The number of values in the population. Must be non-negative. This value
35
+ # must equal the sum of the values in `bucket_counts` if a histogram is
36
+ # provided.
36
37
  # @!attribute [rw] mean
37
38
  # @return [Float]
38
39
  # The arithmetic mean of the values in the population. If `count` is zero
@@ -40,7 +41,7 @@ module Google
40
41
  # @!attribute [rw] sum_of_squared_deviation
41
42
  # @return [Float]
42
43
  # The sum of squared deviations from the mean of the values in the
43
- # population. For values x_i this is:
44
+ # population. For values x_i this is:
44
45
  #
45
46
  # Sum[i=1..n](https://cloud.google.com(x_i - mean)^2)
46
47
  #
@@ -54,21 +55,28 @@ module Google
54
55
  # must not be present if the `count` is zero.
55
56
  # @!attribute [rw] bucket_options
56
57
  # @return [Google::Api::Distribution::BucketOptions]
57
- # Defines the histogram bucket boundaries.
58
+ # Defines the histogram bucket boundaries. If the distribution does not
59
+ # contain a histogram, then omit this field.
58
60
  # @!attribute [rw] bucket_counts
59
61
  # @return [Array<Integer>]
60
- # If `bucket_options` is given, then the sum of the values in `bucket_counts`
61
- # must equal the value in `count`. If `bucket_options` is not given, no
62
- # `bucket_counts` fields may be given.
63
- #
64
- # Bucket counts are given in order under the numbering scheme described
65
- # above (the underflow bucket has number 0; the finite buckets, if any,
66
- # have numbers 1 through N-2; the overflow bucket has number N-1).
62
+ # The number of values in each bucket of the histogram, as described in
63
+ # `bucket_options`. If the distribution does not have a histogram, then omit
64
+ # this field. If there is a histogram, then the sum of the values in
65
+ # `bucket_counts` must equal the value in the `count` field of the
66
+ # distribution.
67
67
  #
68
- # The size of `bucket_counts` must be no greater than N as defined in
69
- # `bucket_options`.
68
+ # If present, `bucket_counts` should contain N values, where N is the number
69
+ # of buckets specified in `bucket_options`. If you supply fewer than N
70
+ # values, the remaining values are assumed to be 0.
70
71
  #
71
- # Any suffix of trailing zero bucket_count fields may be omitted.
72
+ # The order of the values in `bucket_counts` follows the bucket numbering
73
+ # schemes described for the three bucket types. The first value must be the
74
+ # count for the underflow bucket (number 0). The next N-2 values are the
75
+ # counts for the finite buckets (number 1 through N-2). The N'th value in
76
+ # `bucket_counts` is the count for the overflow bucket (number N-1).
77
+ # @!attribute [rw] exemplars
78
+ # @return [Array<Google::Api::Distribution::Exemplar>]
79
+ # Must be in increasing order of `value` field.
72
80
  class Distribution
73
81
  # The range of the population values.
74
82
  # @!attribute [rw] min
@@ -79,29 +87,21 @@ module Google
79
87
  # The maximum of the population values.
80
88
  class Range; end
81
89
 
82
- # A Distribution may optionally contain a histogram of the values in the
83
- # population. The histogram is given in `bucket_counts` as counts of values
84
- # that fall into one of a sequence of non-overlapping buckets. The sequence
85
- # of buckets is described by `bucket_options`.
86
- #
87
- # A bucket specifies an inclusive lower bound and exclusive upper bound for
88
- # the values that are counted for that bucket. The upper bound of a bucket
89
- # is strictly greater than the lower bound.
90
+ # `BucketOptions` describes the bucket boundaries used to create a histogram
91
+ # for the distribution. The buckets can be in a linear sequence, an
92
+ # exponential sequence, or each bucket can be specified explicitly.
93
+ # `BucketOptions` does not include the number of values in each bucket.
90
94
  #
91
- # The sequence of N buckets for a Distribution consists of an underflow
92
- # bucket (number 0), zero or more finite buckets (number 1 through N - 2) and
93
- # an overflow bucket (number N - 1). The buckets are contiguous: the lower
94
- # bound of bucket i (i > 0) is the same as the upper bound of bucket i - 1.
95
- # The buckets span the whole range of finite values: lower bound of the
96
- # underflow bucket is -infinity and the upper bound of the overflow bucket is
97
- # +infinity. The finite buckets are so-called because both bounds are
98
- # finite.
99
- #
100
- # `BucketOptions` describes bucket boundaries in one of three ways. Two
101
- # describe the boundaries by giving parameters for a formula to generate
102
- # boundaries and one gives the bucket boundaries explicitly.
103
- #
104
- # If `bucket_boundaries` is not given, then no `bucket_counts` may be given.
95
+ # A bucket has an inclusive lower bound and exclusive upper bound for the
96
+ # values that are counted for that bucket. The upper bound of a bucket must
97
+ # be strictly greater than the lower bound. The sequence of N buckets for a
98
+ # distribution consists of an underflow bucket (number 0), zero or more
99
+ # finite buckets (number 1 through N - 2) and an overflow bucket (number N -
100
+ # 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the
101
+ # same as the upper bound of bucket i - 1. The buckets span the whole range
102
+ # of finite values: lower bound of the underflow bucket is -infinity and the
103
+ # upper bound of the overflow bucket is +infinity. The finite buckets are
104
+ # so-called because both bounds are finite.
105
105
  # @!attribute [rw] linear_buckets
106
106
  # @return [Google::Api::Distribution::BucketOptions::Linear]
107
107
  # The linear bucket.
@@ -112,12 +112,12 @@ module Google
112
112
  # @return [Google::Api::Distribution::BucketOptions::Explicit]
113
113
  # The explicit buckets.
114
114
  class BucketOptions
115
- # Specify a sequence of buckets that all have the same width (except
116
- # overflow and underflow). Each bucket represents a constant absolute
117
- # uncertainty on the specific value in the bucket.
115
+ # Specifies a linear sequence of buckets that all have the same width
116
+ # (except overflow and underflow). Each bucket represents a constant
117
+ # absolute uncertainty on the specific value in the bucket.
118
118
  #
119
- # Defines `num_finite_buckets + 2` (= N) buckets with these boundaries for
120
- # bucket `i`:
119
+ # There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the
120
+ # following boundaries:
121
121
  #
122
122
  # Upper bound (0 <= i < N-1): offset + (width * i).
123
123
  # Lower bound (1 <= i < N): offset + (width * (i - 1)).
@@ -132,12 +132,12 @@ module Google
132
132
  # Lower bound of the first bucket.
133
133
  class Linear; end
134
134
 
135
- # Specify a sequence of buckets that have a width that is proportional to
136
- # the value of the lower bound. Each bucket represents a constant relative
137
- # uncertainty on a specific value in the bucket.
135
+ # Specifies an exponential sequence of buckets that have a width that is
136
+ # proportional to the value of the lower bound. Each bucket represents a
137
+ # constant relative uncertainty on a specific value in the bucket.
138
138
  #
139
- # Defines `num_finite_buckets + 2` (= N) buckets with these boundaries for
140
- # bucket i:
139
+ # There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the
140
+ # following boundaries:
141
141
  #
142
142
  # Upper bound (0 <= i < N-1): scale * (growth_factor ^ i).
143
143
  # Lower bound (1 <= i < N): scale * (growth_factor ^ (i - 1)).
@@ -152,22 +152,49 @@ module Google
152
152
  # Must be greater than 0.
153
153
  class Exponential; end
154
154
 
155
- # A set of buckets with arbitrary widths.
155
+ # Specifies a set of buckets with arbitrary widths.
156
156
  #
157
- # Defines `size(bounds) + 1` (= N) buckets with these boundaries for
158
- # bucket i:
157
+ # There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following
158
+ # boundaries:
159
159
  #
160
160
  # Upper bound (0 <= i < N-1): bounds[i]
161
161
  # Lower bound (1 <= i < N); bounds[i - 1]
162
162
  #
163
- # There must be at least one element in `bounds`. If `bounds` has only one
164
- # element, there are no finite buckets, and that single element is the
165
- # common boundary of the overflow and underflow buckets.
163
+ # The `bounds` field must contain at least one element. If `bounds` has
164
+ # only one element, then there are no finite buckets, and that single
165
+ # element is the common boundary of the overflow and underflow buckets.
166
166
  # @!attribute [rw] bounds
167
167
  # @return [Array<Float>]
168
168
  # The values must be monotonically increasing.
169
169
  class Explicit; end
170
170
  end
171
+
172
+ # Exemplars are example points that may be used to annotate aggregated
173
+ # distribution values. They are metadata that gives information about a
174
+ # particular value added to a Distribution bucket, such as a trace ID that
175
+ # was active when a value was added. They may contain further information,
176
+ # such as a example values and timestamps, origin, etc.
177
+ # @!attribute [rw] value
178
+ # @return [Float]
179
+ # Value of the exemplar point. This value determines to which bucket the
180
+ # exemplar belongs.
181
+ # @!attribute [rw] timestamp
182
+ # @return [Google::Protobuf::Timestamp]
183
+ # The observation (sampling) time of the above value.
184
+ # @!attribute [rw] attachments
185
+ # @return [Array<Google::Protobuf::Any>]
186
+ # Contextual information about the example value. Examples are:
187
+ #
188
+ # Trace ID: type.googleapis.com/google.devtools.cloudtrace.v1.Trace
189
+ #
190
+ # Literal string: type.googleapis.com/google.protobuf.StringValue
191
+ #
192
+ # Labels dropped during aggregation:
193
+ # type.googleapis.com/google.monitoring.v3.DroppedLabels
194
+ #
195
+ # There may be only a single attachment of any given message type in a
196
+ # single exemplar, and this is enforced by the system.
197
+ class Exemplar; end
171
198
  end
172
199
  end
173
200
  end
@@ -64,7 +64,7 @@ module Google
64
64
  # Optional. The time the event described by the log entry occurred.
65
65
  # This time is used to compute the log entry's age and to enforce
66
66
  # the logs retention period. If this field is omitted in a new log
67
- # entry, then Stackdriver Logging assigns it the current time.
67
+ # entry, then Logging assigns it the current time.
68
68
  # Timestamps have nanosecond accuracy, but trailing zeros in the fractional
69
69
  # seconds might be omitted when the timestamp is displayed.
70
70
  #
@@ -76,7 +76,7 @@ module Google
76
76
  # [LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
77
77
  # @!attribute [rw] receive_timestamp
78
78
  # @return [Google::Protobuf::Timestamp]
79
- # Output only. The time the log entry was received by Stackdriver Logging.
79
+ # Output only. The time the log entry was received by Logging.
80
80
  # @!attribute [rw] severity
81
81
  # @return [Google::Logging::Type::LogSeverity]
82
82
  # Optional. The severity of the log entry. The default value is
@@ -84,9 +84,9 @@ module Google
84
84
  # @!attribute [rw] insert_id
85
85
  # @return [String]
86
86
  # Optional. A unique identifier for the log entry. If you provide a value,
87
- # then Stackdriver Logging considers other log entries in the same project,
87
+ # then Logging considers other log entries in the same project,
88
88
  # with the same `timestamp`, and with the same `insert_id` to be duplicates
89
- # which can be removed. If omitted in new log entries, then Stackdriver
89
+ # which can be removed. If omitted in new log entries, then
90
90
  # Logging assigns its own unique identifier. The `insert_id` is also used
91
91
  # to order log entries that have the same `timestamp` value.
92
92
  # @!attribute [rw] http_request
@@ -114,10 +114,18 @@ module Google
114
114
  # `projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824`
115
115
  # @!attribute [rw] span_id
116
116
  # @return [String]
117
- # Optional. The span ID within the trace associated with the log entry. For
118
- # Stackdriver Trace spans, this is the same format that the Stackdriver Trace
117
+ # Optional. The span ID within the trace associated with the log entry.
118
+ # For Trace spans, this is the same format that the Trace
119
119
  # API v2 uses: a 16-character hexadecimal encoding of an 8-byte array, such
120
120
  # as <code>"000000000000004a"</code>.
121
+ # @!attribute [rw] trace_sampled
122
+ # @return [true, false]
123
+ # Optional. The sampling decision of the trace associated with the log entry.
124
+ # True means that the trace resource name in the `trace` field was sampled
125
+ # for storage in a trace backend. False means that the trace was not sampled
126
+ # for storage when this log entry was written, or the sampling decision was
127
+ # unknown at the time. A non-sampled `trace` value is still useful as a
128
+ # request correlation identifier. The default is False.
121
129
  # @!attribute [rw] source_location
122
130
  # @return [Google::Logging::V2::LogEntrySourceLocation]
123
131
  # Optional. Source code location information associated with the log entry,
@@ -44,11 +44,15 @@ module Google
44
44
  # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
45
45
  # "folders/[FOLDER_ID]/logs/[LOG_ID]"
46
46
  #
47
- # `[LOG_ID]` must be URL-encoded. For example,
48
- # `"projects/my-project-id/logs/syslog"` or
49
- # `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
50
- # For more information about log names, see
51
- # {Google::Logging::V2::LogEntry LogEntry}.
47
+ # `[LOG_ID]` must be URL-encoded. For example:
48
+ #
49
+ # "projects/my-project-id/logs/syslog"
50
+ # "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
51
+ #
52
+ # The permission <code>logging.logEntries.create</code> is needed on each
53
+ # project, organization, billing account, or folder that is receiving
54
+ # new log entries, whether the resource is specified in
55
+ # <code>logName</code> or in an individual log entry.
52
56
  # @!attribute [rw] resource
53
57
  # @return [Google::Api::MonitoredResource]
54
58
  # Optional. A default monitored resource object that is assigned to all log
@@ -67,7 +71,7 @@ module Google
67
71
  # See {Google::Logging::V2::LogEntry LogEntry}.
68
72
  # @!attribute [rw] entries
69
73
  # @return [Array<Google::Logging::V2::LogEntry>]
70
- # Required. The log entries to send to Stackdriver Logging. The order of log
74
+ # Required. The log entries to send to Logging. The order of log
71
75
  # entries in this list does not matter. Values supplied in this method's
72
76
  # `log_name`, `resource`, and `labels` fields are copied into those log
73
77
  # entries in this list that do not include values for their corresponding
@@ -55,7 +55,7 @@ module Google
55
55
  # @!attribute [rw] writer_identity
56
56
  # @return [String]
57
57
  # Output only. An IAM identity&mdash;a service account or group&mdash;under
58
- # which Stackdriver Logging writes the exported log entries to the sink's
58
+ # which Logging writes the exported log entries to the sink's
59
59
  # destination. This field is set by
60
60
  # [sinks.create](https://cloud.google.com/logging/docs/api/reference/rest/v2/projects.sinks/create)
61
61
  # and
@@ -90,7 +90,7 @@ module Google
90
90
  # @return [Google::Protobuf::Timestamp]
91
91
  # Deprecated. This field is ignored when creating or updating sinks.
92
92
  class LogSink
93
- # Available log entry formats. Log entries can be written to Stackdriver
93
+ # Available log entry formats. Log entries can be written to
94
94
  # Logging in either format and can be exported in either format.
95
95
  # Version 2 is the preferred format.
96
96
  module VersionFormat
@@ -171,7 +171,7 @@ module Google
171
171
  # Optional. Determines the kind of IAM identity returned as `writer_identity`
172
172
  # in the new sink. If this value is omitted or set to false, and if the
173
173
  # sink's parent is a project, then the value returned as `writer_identity` is
174
- # the same group or service account used by Stackdriver Logging before the
174
+ # the same group or service account used by Logging before the
175
175
  # addition of writer identities to this API. The sink's destination must be
176
176
  # in the same project as the sink itself.
177
177
  #
@@ -224,7 +224,7 @@ module Google
224
224
  # empty updateMask will be an error.
225
225
  #
226
226
  # For a detailed `FieldMask` definition, see
227
- # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
227
+ # https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask
228
228
  #
229
229
  # Example: `updateMask=filter`.
230
230
  class UpdateSinkRequest; end
@@ -243,7 +243,7 @@ module Google
243
243
  # Example: `"projects/my-project-id/sinks/my-sink-id"`.
244
244
  class DeleteSinkRequest; end
245
245
 
246
- # Specifies a set of log entries that are not to be stored in Stackdriver
246
+ # Specifies a set of log entries that are not to be stored in
247
247
  # Logging. If your project receives a large volume of logs, you might be able
248
248
  # to use exclusions to reduce your chargeable logs. Exclusions are processed
249
249
  # after log sinks, so you can export log entries before they are excluded.
@@ -122,12 +122,12 @@ module Google
122
122
  # Deprecated. The API version that created or updated this metric.
123
123
  # The v2 format is used by default and cannot be changed.
124
124
  class LogMetric
125
- # Stackdriver Logging API version.
125
+ # Logging API version.
126
126
  module ApiVersion
127
- # Stackdriver Logging API v2.
127
+ # Logging API v2.
128
128
  V2 = 0
129
129
 
130
- # Stackdriver Logging API v1.
130
+ # Logging API v1.
131
131
  V1 = 1
132
132
  end
133
133
  end
@@ -300,17 +300,16 @@ module Google
300
300
  nil
301
301
  end
302
302
 
303
- # Writes log entries to Stackdriver Logging. This API method is the
304
- # only way to send log entries to Stackdriver Logging. This method
305
- # is used, directly or indirectly, by the Stackdriver Logging agent
306
- # (fluentd) and all logging libraries configured to use Stackdriver
307
- # Logging.
303
+ # Writes log entries to Logging. This API method is the
304
+ # only way to send log entries to Logging. This method
305
+ # is used, directly or indirectly, by the Logging agent
306
+ # (fluentd) and all logging libraries configured to use Logging.
308
307
  # A single request may contain log entries for a maximum of 1000
309
308
  # different resources (projects, organizations, billing accounts or
310
309
  # folders)
311
310
  #
312
311
  # @param entries [Array<Google::Logging::V2::LogEntry | Hash>]
313
- # Required. The log entries to send to Stackdriver Logging. The order of log
312
+ # Required. The log entries to send to Logging. The order of log
314
313
  # entries in this list does not matter. Values supplied in this method's
315
314
  # `log_name`, `resource`, and `labels` fields are copied into those log
316
315
  # entries in this list that do not include values for their corresponding
@@ -344,11 +343,15 @@ module Google
344
343
  # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
345
344
  # "folders/[FOLDER_ID]/logs/[LOG_ID]"
346
345
  #
347
- # `[LOG_ID]` must be URL-encoded. For example,
348
- # `"projects/my-project-id/logs/syslog"` or
349
- # `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`.
350
- # For more information about log names, see
351
- # {Google::Logging::V2::LogEntry LogEntry}.
346
+ # `[LOG_ID]` must be URL-encoded. For example:
347
+ #
348
+ # "projects/my-project-id/logs/syslog"
349
+ # "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
350
+ #
351
+ # The permission <code>logging.logEntries.create</code> is needed on each
352
+ # project, organization, billing account, or folder that is receiving
353
+ # new log entries, whether the resource is specified in
354
+ # <code>logName</code> or in an individual log entry.
352
355
  # @param resource [Google::Api::MonitoredResource | Hash]
353
356
  # Optional. A default monitored resource object that is assigned to all log
354
357
  # entries in `entries` that do not specify a value for `resource`. Example:
@@ -414,7 +417,7 @@ module Google
414
417
  end
415
418
 
416
419
  # Lists log entries. Use this method to retrieve log entries from
417
- # Stackdriver Logging. For ways to export log entries, see
420
+ # Logging. For ways to export log entries, see
418
421
  # [Exporting Logs](https://cloud.google.com/logging/docs/export).
419
422
  #
420
423
  # @param resource_names [Array<String>]
@@ -506,8 +509,7 @@ module Google
506
509
  @list_log_entries.call(req, options, &block)
507
510
  end
508
511
 
509
- # Lists the descriptors for monitored resource types used by Stackdriver
510
- # Logging.
512
+ # Lists the descriptors for monitored resource types used by Logging.
511
513
  #
512
514
  # @param page_size [Integer]
513
515
  # The maximum number of resources contained in the underlying API
@@ -16,7 +16,7 @@
16
16
  module Google
17
17
  module Cloud
18
18
  module Logging
19
- VERSION = "1.5.6".freeze
19
+ VERSION = "1.5.7".freeze
20
20
  end
21
21
  end
22
22
  end
@@ -25,6 +25,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
25
25
  optional :operation, :message, 15, "google.logging.v2.LogEntryOperation"
26
26
  optional :trace, :string, 22
27
27
  optional :span_id, :string, 27
28
+ optional :trace_sampled, :bool, 30
28
29
  optional :source_location, :message, 23, "google.logging.v2.LogEntrySourceLocation"
29
30
  oneof :payload do
30
31
  optional :proto_payload, :message, 2, "google.protobuf.Any"
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/logging/v2/logging_config.proto for package 'google.logging.v2'
3
3
  # Original file comments:
4
- # Copyright 2018 Google Inc.
4
+ # Copyright 2018 Google LLC.
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
15
15
  # See the License for the specific language governing permissions and
16
16
  # limitations under the License.
17
17
  #
18
+ #
18
19
 
19
20
 
20
21
  require 'grpc'
@@ -24,8 +25,8 @@ module Google
24
25
  module Logging
25
26
  module V2
26
27
  module ConfigServiceV2
27
- # Service for configuring sinks used to export log entries outside of
28
- # Stackdriver Logging.
28
+ # Service for configuring sinks used to export log entries out of
29
+ # Logging.
29
30
  class Service
30
31
 
31
32
  include GRPC::GenericService
@@ -9,6 +9,7 @@ require 'google/api/distribution_pb'
9
9
  require 'google/api/metric_pb'
10
10
  require 'google/protobuf/empty_pb'
11
11
  require 'google/protobuf/field_mask_pb'
12
+ require 'google/protobuf/timestamp_pb'
12
13
  Google::Protobuf::DescriptorPool.generated_pool.build do
13
14
  add_message "google.logging.v2.LogMetric" do
14
15
  optional :name, :string, 1
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/logging/v2/logging_metrics.proto for package 'google.logging.v2'
3
3
  # Original file comments:
4
- # Copyright 2018 Google Inc.
4
+ # Copyright 2018 Google LLC.
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
15
15
  # See the License for the specific language governing permissions and
16
16
  # limitations under the License.
17
17
  #
18
+ #
18
19
 
19
20
 
20
21
  require 'grpc'
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/logging/v2/logging.proto for package 'google.logging.v2'
3
3
  # Original file comments:
4
- # Copyright 2018 Google Inc.
4
+ # Copyright 2018 Google LLC.
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
15
15
  # See the License for the specific language governing permissions and
16
16
  # limitations under the License.
17
17
  #
18
+ #
18
19
 
19
20
 
20
21
  require 'grpc'
@@ -38,21 +39,19 @@ module Google
38
39
  # Log entries written shortly before the delete operation might not be
39
40
  # deleted.
40
41
  rpc :DeleteLog, DeleteLogRequest, Google::Protobuf::Empty
41
- # Writes log entries to Stackdriver Logging. This API method is the
42
- # only way to send log entries to Stackdriver Logging. This method
43
- # is used, directly or indirectly, by the Stackdriver Logging agent
44
- # (fluentd) and all logging libraries configured to use Stackdriver
45
- # Logging.
42
+ # Writes log entries to Logging. This API method is the
43
+ # only way to send log entries to Logging. This method
44
+ # is used, directly or indirectly, by the Logging agent
45
+ # (fluentd) and all logging libraries configured to use Logging.
46
46
  # A single request may contain log entries for a maximum of 1000
47
47
  # different resources (projects, organizations, billing accounts or
48
48
  # folders)
49
49
  rpc :WriteLogEntries, WriteLogEntriesRequest, WriteLogEntriesResponse
50
50
  # Lists log entries. Use this method to retrieve log entries from
51
- # Stackdriver Logging. For ways to export log entries, see
51
+ # Logging. For ways to export log entries, see
52
52
  # [Exporting Logs](/logging/docs/export).
53
53
  rpc :ListLogEntries, ListLogEntriesRequest, ListLogEntriesResponse
54
- # Lists the descriptors for monitored resource types used by Stackdriver
55
- # Logging.
54
+ # Lists the descriptors for monitored resource types used by Logging.
56
55
  rpc :ListMonitoredResourceDescriptors, ListMonitoredResourceDescriptorsRequest, ListMonitoredResourceDescriptorsResponse
57
56
  # Lists the logs in projects, organizations, folders, or billing accounts.
58
57
  # Only logs that have entries are listed.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-logging
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.5.6
4
+ version: 1.5.7
5
5
  platform: ruby
6
6
  authors:
7
7
  - Mike Moore
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: bin
11
11
  cert_chain: []
12
- date: 2018-10-03 00:00:00.000000000 Z
12
+ date: 2018-11-15 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: google-cloud-core
@@ -171,14 +171,14 @@ dependencies:
171
171
  requirements:
172
172
  - - "~>"
173
173
  - !ruby/object:Gem::Version
174
- version: 0.50.0
174
+ version: 0.59.2
175
175
  type: :development
176
176
  prerelease: false
177
177
  version_requirements: !ruby/object:Gem::Requirement
178
178
  requirements:
179
179
  - - "~>"
180
180
  - !ruby/object:Gem::Version
181
- version: 0.50.0
181
+ version: 0.59.2
182
182
  - !ruby/object:Gem::Dependency
183
183
  name: simplecov
184
184
  requirement: !ruby/object:Gem::Requirement