google-cloud-logging 1.5.6 → 1.5.7

Sign up to get free protection for your applications and to get access to all the features.
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