google-cloud-logging 1.10.4 → 1.10.9

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.
Files changed (21) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +30 -0
  3. data/TROUBLESHOOTING.md +2 -8
  4. data/lib/google/cloud/logging/async_writer.rb +17 -9
  5. data/lib/google/cloud/logging/v2/config_service_v2_client.rb +191 -191
  6. data/lib/google/cloud/logging/v2/config_service_v2_client_config.json +26 -21
  7. data/lib/google/cloud/logging/v2/doc/google/api/metric.rb +49 -7
  8. data/lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb +40 -7
  9. data/lib/google/cloud/logging/v2/logging_service_v2_client.rb +121 -121
  10. data/lib/google/cloud/logging/v2/logging_service_v2_client_config.json +19 -14
  11. data/lib/google/cloud/logging/v2/metrics_service_v2_client.rb +93 -93
  12. data/lib/google/cloud/logging/v2/metrics_service_v2_client_config.json +13 -8
  13. data/lib/google/cloud/logging/version.rb +1 -1
  14. data/lib/google/logging/v2/log_entry_pb.rb +5 -5
  15. data/lib/google/logging/v2/logging_config_pb.rb +27 -27
  16. data/lib/google/logging/v2/logging_config_services_pb.rb +83 -83
  17. data/lib/google/logging/v2/logging_metrics_pb.rb +10 -10
  18. data/lib/google/logging/v2/logging_metrics_services_pb.rb +23 -23
  19. data/lib/google/logging/v2/logging_pb.rb +12 -12
  20. data/lib/google/logging/v2/logging_services_pb.rb +35 -35
  21. metadata +5 -5
data/lib/google/cloud/logging/v2/config_service_v2_client_config.json CHANGED
@@ -4,9 +4,14 @@
4
4
  "retry_codes": {
5
5
  "idempotent": [
6
6
  "DEADLINE_EXCEEDED",
7
+ "INTERNAL",
7
8
  "UNAVAILABLE"
8
9
  ],
9
- "non_idempotent": []
10
+ "non_idempotent": [],
11
+ "idempotent2": [
12
+ "DEADLINE_EXCEEDED",
13
+ "UNAVAILABLE"
14
+ ]
10
15
  },
11
16
  "retry_params": {
12
17
  "default": {
@@ -20,54 +25,59 @@
20
25
  }
21
26
  },
22
27
  "methods": {
23
- "ListBuckets": {
28
+ "DeleteSink": {
24
29
  "timeout_millis": 60000,
25
30
  "retry_codes_name": "idempotent",
26
31
  "retry_params_name": "default"
27
32
  },
28
- "GetBucket": {
33
+ "UpdateSink": {
29
34
  "timeout_millis": 60000,
30
35
  "retry_codes_name": "idempotent",
31
36
  "retry_params_name": "default"
32
37
  },
33
- "UpdateBucket": {
38
+ "DeleteExclusion": {
34
39
  "timeout_millis": 60000,
35
- "retry_codes_name": "non_idempotent",
40
+ "retry_codes_name": "idempotent",
36
41
  "retry_params_name": "default"
37
42
  },
38
- "ListSinks": {
43
+ "ListBuckets": {
39
44
  "timeout_millis": 60000,
40
- "retry_codes_name": "idempotent",
45
+ "retry_codes_name": "idempotent2",
41
46
  "retry_params_name": "default"
42
47
  },
43
- "GetSink": {
48
+ "GetBucket": {
44
49
  "timeout_millis": 60000,
45
- "retry_codes_name": "idempotent",
50
+ "retry_codes_name": "idempotent2",
46
51
  "retry_params_name": "default"
47
52
  },
48
- "CreateSink": {
53
+ "UpdateBucket": {
49
54
  "timeout_millis": 60000,
50
55
  "retry_codes_name": "non_idempotent",
51
56
  "retry_params_name": "default"
52
57
  },
53
- "UpdateSink": {
58
+ "ListSinks": {
54
59
  "timeout_millis": 60000,
55
- "retry_codes_name": "non_idempotent",
60
+ "retry_codes_name": "idempotent2",
56
61
  "retry_params_name": "default"
57
62
  },
58
- "DeleteSink": {
63
+ "GetSink": {
64
+ "timeout_millis": 60000,
65
+ "retry_codes_name": "idempotent2",
66
+ "retry_params_name": "default"
67
+ },
68
+ "CreateSink": {
59
69
  "timeout_millis": 60000,
60
70
  "retry_codes_name": "non_idempotent",
61
71
  "retry_params_name": "default"
62
72
  },
63
73
  "ListExclusions": {
64
74
  "timeout_millis": 60000,
65
- "retry_codes_name": "idempotent",
75
+ "retry_codes_name": "idempotent2",
66
76
  "retry_params_name": "default"
67
77
  },
68
78
  "GetExclusion": {
69
79
  "timeout_millis": 60000,
70
- "retry_codes_name": "idempotent",
80
+ "retry_codes_name": "idempotent2",
71
81
  "retry_params_name": "default"
72
82
  },
73
83
  "CreateExclusion": {
@@ -80,14 +90,9 @@
80
90
  "retry_codes_name": "non_idempotent",
81
91
  "retry_params_name": "default"
82
92
  },
83
- "DeleteExclusion": {
84
- "timeout_millis": 60000,
85
- "retry_codes_name": "non_idempotent",
86
- "retry_params_name": "default"
87
- },
88
93
  "GetCmekSettings": {
89
94
  "timeout_millis": 60000,
90
- "retry_codes_name": "idempotent",
95
+ "retry_codes_name": "idempotent2",
91
96
  "retry_params_name": "default"
92
97
  },
93
98
  "UpdateCmekSettings": {
data/lib/google/cloud/logging/v2/doc/google/api/metric.rb CHANGED
@@ -18,15 +18,41 @@ module Google
18
18
  # Defines a metric type and its schema. Once a metric descriptor is created,
19
19
  # deleting or altering it stops data collection and makes the metric type's
20
20
  # existing data unusable.
21
+ #
22
+ # The following are specific rules for service defined Monitoring metric
23
+ # descriptors:
24
+ #
25
+ # * `type`, `metric_kind`, `value_type`, `description`, `display_name`,
26
+ # `launch_stage` fields are all required. The `unit` field must be specified
27
+ # if the `value_type` is any of DOUBLE, INT64, DISTRIBUTION.
28
+ # * Maximum of default 500 metric descriptors per service is allowed.
29
+ # * Maximum of default 10 labels per metric descriptor is allowed.
30
+ #
31
+ # The default maximum limit can be overridden. Please follow
32
+ # https://cloud.google.com/monitoring/quotas
21
33
  # @!attribute [rw] name
22
34
  # @return [String]
23
35
  # The resource name of the metric descriptor.
24
36
  # @!attribute [rw] type
25
37
  # @return [String]
26
38
  # The metric type, including its DNS name prefix. The type is not
27
- # URL-encoded. All user-defined metric types have the DNS name
28
- # `custom.googleapis.com` or `external.googleapis.com`. Metric types should
29
- # use a natural hierarchical grouping. For example:
39
+ # URL-encoded.
40
+ #
41
+ # All service defined metrics must be prefixed with the service name, in the
42
+ # format of `{service name}/{relative metric name}`, such as
43
+ # `cloudsql.googleapis.com/database/cpu/utilization`. The relative metric
44
+ # name must follow:
45
+ #
46
+ # * Only upper and lower-case letters, digits, '/' and underscores '_' are
47
+ # allowed.
48
+ # * The maximum number of characters allowed for the relative_metric_name is
49
+ # 100.
50
+ #
51
+ # All user-defined metric types have the DNS name
52
+ # `custom.googleapis.com`, `external.googleapis.com`, or
53
+ # `logging.googleapis.com/user/`.
54
+ #
55
+ # Metric types should use a natural hierarchical grouping. For example:
30
56
  #
31
57
  # "custom.googleapis.com/invoice/paid/amount"
32
58
  # "external.googleapis.com/prometheus/up"
@@ -34,7 +60,16 @@ module Google
34
60
  # @!attribute [rw] labels
35
61
  # @return [Array<Google::Api::LabelDescriptor>]
36
62
  # The set of labels that can be used to describe a specific
37
- # instance of this metric type. For example, the
63
+ # instance of this metric type.
64
+ #
65
+ # The label key name must follow:
66
+ #
67
+ # * Only upper and lower-case letters, digits and underscores (_) are
68
+ # allowed.
69
+ # * Label name must start with a letter or digit.
70
+ # * The maximum length of a label name is 100 characters.
71
+ #
72
+ # For example, the
38
73
  # `appengine.googleapis.com/http/server/response_latencies` metric
39
74
  # type has a label for the HTTP response code, `response_code`, so
40
75
  # you can look at latencies for successful responses or just
@@ -64,7 +99,7 @@ module Google
64
99
  # `s{CPU}` (or equivalently `1s{CPU}` or just `s`). If the job uses 12,005
65
100
  # CPU-seconds, then the value is written as `12005`.
66
101
  #
67
- # Alternatively, if you want a custome metric to record data in a more
102
+ # Alternatively, if you want a custom metric to record data in a more
68
103
  # granular way, you can create a `DOUBLE CUMULATIVE` metric whose `unit` is
69
104
  # `ks{CPU}`, and then write the value `12.005` (which is `12005/1000`),
70
105
  # or use `Kis{CPU}` and write `11.723` (which is `12005/1024`).
@@ -80,6 +115,7 @@ module Google
80
115
  # * `min` minute
81
116
  # * `h` hour
82
117
  # * `d` day
118
+ # * `1` dimensionless
83
119
  #
84
120
  # **Prefixes (PREFIX)**
85
121
  #
@@ -165,12 +201,18 @@ module Google
165
201
  # @!attribute [rw] launch_stage
166
202
  # @return [Google::Api::LaunchStage]
167
203
  # Optional. The launch stage of the metric definition.
204
+ # @!attribute [rw] monitored_resource_types
205
+ # @return [Array<String>]
206
+ # Read-only. If present, then a [time
207
+ # series][google.monitoring.v3.TimeSeries], which is identified partially by
208
+ # a metric type and a {Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor}, that is associated
209
+ # with this metric type can only be associated with one of the monitored
210
+ # resource types listed here.
168
211
  class MetricDescriptor
169
212
  # Additional annotations that can be used to guide the usage of a metric.
170
213
  # @!attribute [rw] launch_stage
171
214
  # @return [Google::Api::LaunchStage]
172
- # Deprecated. Please use the MetricDescriptor.launch_stage instead.
173
- # The launch stage of the metric definition.
215
+ # Deprecated. Must use the {Google::Api::MetricDescriptor#launch_stage MetricDescriptor#launch_stage} instead.
174
216
  # @!attribute [rw] sample_period
175
217
  # @return [Google::Protobuf::Duration]
176
218
  # The sampling period of metric data points. For metrics which are written
data/lib/google/cloud/logging/v2/doc/google/api/monitored_resource.rb CHANGED
@@ -21,9 +21,23 @@ module Google
21
21
  # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
22
22
  # `"zone"` to identify particular VM instances.
23
23
  #
24
- # Different APIs can support different monitored resource types. APIs generally
25
- # provide a `list` method that returns the monitored resource descriptors used
26
- # by the API.
24
+ # Different services can support different monitored resource types.
25
+ #
26
+ # The following are specific rules to service defined monitored resources for
27
+ # Monitoring and Logging:
28
+ #
29
+ # * The `type`, `display_name`, `description`, `labels` and `launch_stage`
30
+ # fields are all required.
31
+ # * The first label of the monitored resource descriptor must be
32
+ # `resource_container`. There are legacy monitored resource descritptors
33
+ # start with `project_id`.
34
+ # * It must include a `location` label.
35
+ # * Maximum of default 5 service defined monitored resource descriptors
36
+ # is allowed per service.
37
+ # * Maximum of default 10 labels per monitored resource is allowed.
38
+ #
39
+ # The default maximum limit can be overridden. Please follow
40
+ # https://cloud.google.com/monitoring/quotas
27
41
  # @!attribute [rw] name
28
42
  # @return [String]
29
43
  # Optional. The resource name of the monitored resource descriptor:
@@ -35,8 +49,19 @@ module Google
35
49
  # @!attribute [rw] type
36
50
  # @return [String]
37
51
  # Required. The monitored resource type. For example, the type
38
- # `"cloudsql_database"` represents databases in Google Cloud SQL.
39
- # The maximum length of this value is 256 characters.
52
+ # `cloudsql_database` represents databases in Google Cloud SQL.
53
+ #
54
+ # All service defined monitored resource types must be prefixed with the
55
+ # service name, in the format of `{service name}/{relative resource name}`.
56
+ # The relative resource name must follow:
57
+ #
58
+ # * Only upper and lower-case letters and digits are allowed.
59
+ # * It must start with upper case character and is recommended to use Upper
60
+ # Camel Case style.
61
+ # * The maximum number of characters allowed for the relative_resource_name
62
+ # is 100.
63
+ #
64
+ # Note there are legacy service monitored resources not following this rule.
40
65
  # @!attribute [rw] display_name
41
66
  # @return [String]
42
67
  # Optional. A concise name for the monitored resource type that might be
@@ -50,8 +75,16 @@ module Google
50
75
  # @!attribute [rw] labels
51
76
  # @return [Array<Google::Api::LabelDescriptor>]
52
77
  # Required. A set of labels used to describe instances of this monitored
53
- # resource type. For example, an individual Google Cloud SQL database is
54
- # identified by values for the labels `"database_id"` and `"zone"`.
78
+ # resource type.
79
+ # The label key name must follow:
80
+ #
81
+ # * Only upper and lower-case letters, digits and underscores (_) are
82
+ # allowed.
83
+ # * Label name must start with a letter or digit.
84
+ # * The maximum length of a label name is 100 characters.
85
+ #
86
+ # For example, an individual Google Cloud SQL database is
87
+ # identified by values for the labels `database_id` and `location`.
55
88
  # @!attribute [rw] launch_stage
56
89
  # @return [Google::Api::LaunchStage]
57
90
  # Optional. The launch stage of the monitored resource definition.
data/lib/google/cloud/logging/v2/logging_service_v2_client.rb CHANGED
@@ -282,11 +282,6 @@ module Google
282
282
  &Google::Logging::V2::LoggingServiceV2::Stub.method(:new)
283
283
  )
284
284
 
285
- @write_log_entries = Google::Gax.create_api_call(
286
- @logging_service_v2_stub.method(:write_log_entries),
287
- defaults["write_log_entries"],
288
- exception_transformer: exception_transformer
289
- )
290
285
  @delete_log = Google::Gax.create_api_call(
291
286
  @logging_service_v2_stub.method(:delete_log),
292
287
  defaults["delete_log"],
@@ -300,6 +295,11 @@ module Google
300
295
  defaults["list_log_entries"],
301
296
  exception_transformer: exception_transformer
302
297
  )
298
+ @write_log_entries = Google::Gax.create_api_call(
299
+ @logging_service_v2_stub.method(:write_log_entries),
300
+ defaults["write_log_entries"],
301
+ exception_transformer: exception_transformer
302
+ )
303
303
  @list_monitored_resource_descriptors = Google::Gax.create_api_call(
304
304
  @logging_service_v2_stub.method(:list_monitored_resource_descriptors),
305
305
  defaults["list_monitored_resource_descriptors"],
@@ -317,122 +317,6 @@ module Google
317
317
 
318
318
  # Service calls
319
319
 
320
- # Writes log entries to Logging. This API method is the
321
- # only way to send log entries to Logging. This method
322
- # is used, directly or indirectly, by the Logging agent
323
- # (fluentd) and all logging libraries configured to use Logging.
324
- # A single request may contain log entries for a maximum of 1000
325
- # different resources (projects, organizations, billing accounts or
326
- # folders)
327
- #
328
- # @param entries [Array<Google::Logging::V2::LogEntry | Hash>]
329
- # Required. The log entries to send to Logging. The order of log
330
- # entries in this list does not matter. Values supplied in this method's
331
- # `log_name`, `resource`, and `labels` fields are copied into those log
332
- # entries in this list that do not include values for their corresponding
333
- # fields. For more information, see the
334
- # {Google::Logging::V2::LogEntry LogEntry} type.
335
- #
336
- # If the `timestamp` or `insert_id` fields are missing in log entries, then
337
- # this method supplies the current time or a unique identifier, respectively.
338
- # The supplied values are chosen so that, among the log entries that did not
339
- # supply their own values, the entries earlier in the list will sort before
340
- # the entries later in the list. See the `entries.list` method.
341
- #
342
- # Log entries with timestamps that are more than the
343
- # [logs retention period](https://cloud.google.com/logging/quota-policy) in the past or more than
344
- # 24 hours in the future will not be available when calling `entries.list`.
345
- # However, those log entries can still be
346
- # [exported with LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
347
- #
348
- # To improve throughput and to avoid exceeding the
349
- # [quota limit](https://cloud.google.com/logging/quota-policy) for calls to `entries.write`,
350
- # you should try to include several log entries in this list,
351
- # rather than calling this method for each individual log entry.
352
- # A hash of the same form as `Google::Logging::V2::LogEntry`
353
- # can also be provided.
354
- # @param log_name [String]
355
- # Optional. A default log resource name that is assigned to all log entries
356
- # in `entries` that do not specify a value for `log_name`:
357
- #
358
- # "projects/[PROJECT_ID]/logs/[LOG_ID]"
359
- # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
360
- # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
361
- # "folders/[FOLDER_ID]/logs/[LOG_ID]"
362
- #
363
- # `[LOG_ID]` must be URL-encoded. For example:
364
- #
365
- # "projects/my-project-id/logs/syslog"
366
- # "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
367
- #
368
- # The permission `logging.logEntries.create` is needed on each project,
369
- # organization, billing account, or folder that is receiving new log
370
- # entries, whether the resource is specified in `logName` or in an
371
- # individual log entry.
372
- # @param resource [Google::Api::MonitoredResource | Hash]
373
- # Optional. A default monitored resource object that is assigned to all log
374
- # entries in `entries` that do not specify a value for `resource`. Example:
375
- #
376
- # { "type": "gce_instance",
377
- # "labels": {
378
- # "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
379
- #
380
- # See {Google::Logging::V2::LogEntry LogEntry}.
381
- # A hash of the same form as `Google::Api::MonitoredResource`
382
- # can also be provided.
383
- # @param labels [Hash{String => String}]
384
- # Optional. Default labels that are added to the `labels` field of all log
385
- # entries in `entries`. If a log entry already has a label with the same key
386
- # as a label in this parameter, then the log entry's label is not changed.
387
- # See {Google::Logging::V2::LogEntry LogEntry}.
388
- # @param partial_success [true, false]
389
- # Optional. Whether valid entries should be written even if some other
390
- # entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
391
- # entry is not written, then the response status is the error associated
392
- # with one of the failed entries and the response includes error details
393
- # keyed by the entries' zero-based index in the `entries.write` method.
394
- # @param dry_run [true, false]
395
- # Optional. If true, the request should expect normal response, but the
396
- # entries won't be persisted nor exported. Useful for checking whether the
397
- # logging API endpoints are working properly before sending valuable data.
398
- # @param options [Google::Gax::CallOptions]
399
- # Overrides the default settings for this call, e.g, timeout,
400
- # retries, etc.
401
- # @yield [result, operation] Access the result along with the RPC operation
402
- # @yieldparam result [Google::Logging::V2::WriteLogEntriesResponse]
403
- # @yieldparam operation [GRPC::ActiveCall::Operation]
404
- # @return [Google::Logging::V2::WriteLogEntriesResponse]
405
- # @raise [Google::Gax::GaxError] if the RPC is aborted.
406
- # @example
407
- # require "google/cloud/logging/v2"
408
- #
409
- # logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
410
- #
411
- # # TODO: Initialize `entries`:
412
- # entries = []
413
- # response = logging_client.write_log_entries(entries)
414
-
415
- def write_log_entries \
416
- entries,
417
- log_name: nil,
418
- resource: nil,
419
- labels: nil,
420
- partial_success: nil,
421
- dry_run: nil,
422
- options: nil,
423
- &block
424
- req = {
425
- entries: entries,
426
- log_name: log_name,
427
- resource: resource,
428
- labels: labels,
429
- partial_success: partial_success,
430
- dry_run: dry_run
431
- }.delete_if { |_, v| v.nil? }
432
- req = Google::Gax::to_proto(req, Google::Logging::V2::WriteLogEntriesRequest)
433
- @write_log_entries.call(req, options, &block)
434
- end
435
-
436
320
  # Deletes all the log entries in a log. The log reappears if it receives new
437
321
  # entries. Log entries written shortly before the delete operation might not
438
322
  # be deleted. Entries received after the delete operation with a timestamp
@@ -565,6 +449,122 @@ module Google
565
449
  @list_log_entries.call(req, options, &block)
566
450
  end
567
451
 
452
+ # Writes log entries to Logging. This API method is the
453
+ # only way to send log entries to Logging. This method
454
+ # is used, directly or indirectly, by the Logging agent
455
+ # (fluentd) and all logging libraries configured to use Logging.
456
+ # A single request may contain log entries for a maximum of 1000
457
+ # different resources (projects, organizations, billing accounts or
458
+ # folders)
459
+ #
460
+ # @param entries [Array<Google::Logging::V2::LogEntry | Hash>]
461
+ # Required. The log entries to send to Logging. The order of log
462
+ # entries in this list does not matter. Values supplied in this method's
463
+ # `log_name`, `resource`, and `labels` fields are copied into those log
464
+ # entries in this list that do not include values for their corresponding
465
+ # fields. For more information, see the
466
+ # {Google::Logging::V2::LogEntry LogEntry} type.
467
+ #
468
+ # If the `timestamp` or `insert_id` fields are missing in log entries, then
469
+ # this method supplies the current time or a unique identifier, respectively.
470
+ # The supplied values are chosen so that, among the log entries that did not
471
+ # supply their own values, the entries earlier in the list will sort before
472
+ # the entries later in the list. See the `entries.list` method.
473
+ #
474
+ # Log entries with timestamps that are more than the
475
+ # [logs retention period](https://cloud.google.com/logging/quota-policy) in the past or more than
476
+ # 24 hours in the future will not be available when calling `entries.list`.
477
+ # However, those log entries can still be
478
+ # [exported with LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs).
479
+ #
480
+ # To improve throughput and to avoid exceeding the
481
+ # [quota limit](https://cloud.google.com/logging/quota-policy) for calls to `entries.write`,
482
+ # you should try to include several log entries in this list,
483
+ # rather than calling this method for each individual log entry.
484
+ # A hash of the same form as `Google::Logging::V2::LogEntry`
485
+ # can also be provided.
486
+ # @param log_name [String]
487
+ # Optional. A default log resource name that is assigned to all log entries
488
+ # in `entries` that do not specify a value for `log_name`:
489
+ #
490
+ # "projects/[PROJECT_ID]/logs/[LOG_ID]"
491
+ # "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]"
492
+ # "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]"
493
+ # "folders/[FOLDER_ID]/logs/[LOG_ID]"
494
+ #
495
+ # `[LOG_ID]` must be URL-encoded. For example:
496
+ #
497
+ # "projects/my-project-id/logs/syslog"
498
+ # "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"
499
+ #
500
+ # The permission `logging.logEntries.create` is needed on each project,
501
+ # organization, billing account, or folder that is receiving new log
502
+ # entries, whether the resource is specified in `logName` or in an
503
+ # individual log entry.
504
+ # @param resource [Google::Api::MonitoredResource | Hash]
505
+ # Optional. A default monitored resource object that is assigned to all log
506
+ # entries in `entries` that do not specify a value for `resource`. Example:
507
+ #
508
+ # { "type": "gce_instance",
509
+ # "labels": {
510
+ # "zone": "us-central1-a", "instance_id": "00000000000000000000" }}
511
+ #
512
+ # See {Google::Logging::V2::LogEntry LogEntry}.
513
+ # A hash of the same form as `Google::Api::MonitoredResource`
514
+ # can also be provided.
515
+ # @param labels [Hash{String => String}]
516
+ # Optional. Default labels that are added to the `labels` field of all log
517
+ # entries in `entries`. If a log entry already has a label with the same key
518
+ # as a label in this parameter, then the log entry's label is not changed.
519
+ # See {Google::Logging::V2::LogEntry LogEntry}.
520
+ # @param partial_success [true, false]
521
+ # Optional. Whether valid entries should be written even if some other
522
+ # entries fail due to INVALID_ARGUMENT or PERMISSION_DENIED errors. If any
523
+ # entry is not written, then the response status is the error associated
524
+ # with one of the failed entries and the response includes error details
525
+ # keyed by the entries' zero-based index in the `entries.write` method.
526
+ # @param dry_run [true, false]
527
+ # Optional. If true, the request should expect normal response, but the
528
+ # entries won't be persisted nor exported. Useful for checking whether the
529
+ # logging API endpoints are working properly before sending valuable data.
530
+ # @param options [Google::Gax::CallOptions]
531
+ # Overrides the default settings for this call, e.g, timeout,
532
+ # retries, etc.
533
+ # @yield [result, operation] Access the result along with the RPC operation
534
+ # @yieldparam result [Google::Logging::V2::WriteLogEntriesResponse]
535
+ # @yieldparam operation [GRPC::ActiveCall::Operation]
536
+ # @return [Google::Logging::V2::WriteLogEntriesResponse]
537
+ # @raise [Google::Gax::GaxError] if the RPC is aborted.
538
+ # @example
539
+ # require "google/cloud/logging/v2"
540
+ #
541
+ # logging_client = Google::Cloud::Logging::V2::LoggingServiceV2Client.new
542
+ #
543
+ # # TODO: Initialize `entries`:
544
+ # entries = []
545
+ # response = logging_client.write_log_entries(entries)
546
+
547
+ def write_log_entries \
548
+ entries,
549
+ log_name: nil,
550
+ resource: nil,
551
+ labels: nil,
552
+ partial_success: nil,
553
+ dry_run: nil,
554
+ options: nil,
555
+ &block
556
+ req = {
557
+ entries: entries,
558
+ log_name: log_name,
559
+ resource: resource,
560
+ labels: labels,
561
+ partial_success: partial_success,
562
+ dry_run: dry_run
563
+ }.delete_if { |_, v| v.nil? }
564
+ req = Google::Gax::to_proto(req, Google::Logging::V2::WriteLogEntriesRequest)
565
+ @write_log_entries.call(req, options, &block)
566
+ end
567
+
568
568
  # Lists the descriptors for monitored resource types used by Logging.
569
569
  #
570
570
  # @param page_size [Integer]