google-cloud-logging 3.13.0__py3-none-any.whl

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 (68) hide show
  1. google/cloud/logging/__init__.py +53 -0
  2. google/cloud/logging/gapic_version.py +16 -0
  3. google/cloud/logging/handlers/__init__.py +31 -0
  4. google/cloud/logging/handlers/middleware/__init__.py +17 -0
  5. google/cloud/logging/handlers/transports/__init__.py +28 -0
  6. google/cloud/logging/py.typed +2 -0
  7. google/cloud/logging_v2/__init__.py +61 -0
  8. google/cloud/logging_v2/_gapic.py +647 -0
  9. google/cloud/logging_v2/_helpers.py +152 -0
  10. google/cloud/logging_v2/_http.py +549 -0
  11. google/cloud/logging_v2/_instrumentation.py +92 -0
  12. google/cloud/logging_v2/client.py +429 -0
  13. google/cloud/logging_v2/entries.py +358 -0
  14. google/cloud/logging_v2/gapic_metadata.json +481 -0
  15. google/cloud/logging_v2/gapic_version.py +16 -0
  16. google/cloud/logging_v2/handlers/__init__.py +31 -0
  17. google/cloud/logging_v2/handlers/_helpers.py +283 -0
  18. google/cloud/logging_v2/handlers/_monitored_resources.py +303 -0
  19. google/cloud/logging_v2/handlers/app_engine.py +139 -0
  20. google/cloud/logging_v2/handlers/container_engine.py +62 -0
  21. google/cloud/logging_v2/handlers/handlers.py +340 -0
  22. google/cloud/logging_v2/handlers/middleware/__init__.py +17 -0
  23. google/cloud/logging_v2/handlers/middleware/request.py +52 -0
  24. google/cloud/logging_v2/handlers/structured_log.py +150 -0
  25. google/cloud/logging_v2/handlers/transports/__init__.py +29 -0
  26. google/cloud/logging_v2/handlers/transports/background_thread.py +343 -0
  27. google/cloud/logging_v2/handlers/transports/base.py +61 -0
  28. google/cloud/logging_v2/handlers/transports/sync.py +68 -0
  29. google/cloud/logging_v2/logger.py +541 -0
  30. google/cloud/logging_v2/metric.py +180 -0
  31. google/cloud/logging_v2/py.typed +2 -0
  32. google/cloud/logging_v2/resource.py +51 -0
  33. google/cloud/logging_v2/services/__init__.py +15 -0
  34. google/cloud/logging_v2/services/config_service_v2/__init__.py +22 -0
  35. google/cloud/logging_v2/services/config_service_v2/async_client.py +4232 -0
  36. google/cloud/logging_v2/services/config_service_v2/client.py +4686 -0
  37. google/cloud/logging_v2/services/config_service_v2/pagers.py +820 -0
  38. google/cloud/logging_v2/services/config_service_v2/transports/__init__.py +33 -0
  39. google/cloud/logging_v2/services/config_service_v2/transports/base.py +748 -0
  40. google/cloud/logging_v2/services/config_service_v2/transports/grpc.py +1345 -0
  41. google/cloud/logging_v2/services/config_service_v2/transports/grpc_asyncio.py +1660 -0
  42. google/cloud/logging_v2/services/logging_service_v2/__init__.py +22 -0
  43. google/cloud/logging_v2/services/logging_service_v2/async_client.py +1272 -0
  44. google/cloud/logging_v2/services/logging_service_v2/client.py +1686 -0
  45. google/cloud/logging_v2/services/logging_service_v2/pagers.py +516 -0
  46. google/cloud/logging_v2/services/logging_service_v2/transports/__init__.py +33 -0
  47. google/cloud/logging_v2/services/logging_service_v2/transports/base.py +361 -0
  48. google/cloud/logging_v2/services/logging_service_v2/transports/grpc.py +566 -0
  49. google/cloud/logging_v2/services/logging_service_v2/transports/grpc_asyncio.py +703 -0
  50. google/cloud/logging_v2/services/metrics_service_v2/__init__.py +22 -0
  51. google/cloud/logging_v2/services/metrics_service_v2/async_client.py +1119 -0
  52. google/cloud/logging_v2/services/metrics_service_v2/client.py +1534 -0
  53. google/cloud/logging_v2/services/metrics_service_v2/pagers.py +196 -0
  54. google/cloud/logging_v2/services/metrics_service_v2/transports/__init__.py +33 -0
  55. google/cloud/logging_v2/services/metrics_service_v2/transports/base.py +320 -0
  56. google/cloud/logging_v2/services/metrics_service_v2/transports/grpc.py +520 -0
  57. google/cloud/logging_v2/services/metrics_service_v2/transports/grpc_asyncio.py +629 -0
  58. google/cloud/logging_v2/sink.py +233 -0
  59. google/cloud/logging_v2/types/__init__.py +178 -0
  60. google/cloud/logging_v2/types/log_entry.py +435 -0
  61. google/cloud/logging_v2/types/logging.py +602 -0
  62. google/cloud/logging_v2/types/logging_config.py +2418 -0
  63. google/cloud/logging_v2/types/logging_metrics.py +412 -0
  64. google_cloud_logging-3.13.0.dist-info/METADATA +143 -0
  65. google_cloud_logging-3.13.0.dist-info/RECORD +68 -0
  66. google_cloud_logging-3.13.0.dist-info/WHEEL +5 -0
  67. google_cloud_logging-3.13.0.dist-info/licenses/LICENSE +202 -0
  68. google_cloud_logging-3.13.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,412 @@
1
+ # -*- coding: utf-8 -*-
2
+ # Copyright 2025 Google LLC
3
+ #
4
+ # Licensed under the Apache License, Version 2.0 (the "License");
5
+ # you may not use this file except in compliance with the License.
6
+ # You may obtain a copy of the License at
7
+ #
8
+ # http://www.apache.org/licenses/LICENSE-2.0
9
+ #
10
+ # Unless required by applicable law or agreed to in writing, software
11
+ # distributed under the License is distributed on an "AS IS" BASIS,
12
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ # See the License for the specific language governing permissions and
14
+ # limitations under the License.
15
+ #
16
+ from __future__ import annotations
17
+
18
+ from typing import MutableMapping, MutableSequence
19
+
20
+ import proto # type: ignore
21
+
22
+ from google.api import distribution_pb2 # type: ignore
23
+ from google.api import metric_pb2 # type: ignore
24
+ from google.protobuf import timestamp_pb2 # type: ignore
25
+
26
+
27
+ __protobuf__ = proto.module(
28
+ package="google.logging.v2",
29
+ manifest={
30
+ "LogMetric",
31
+ "ListLogMetricsRequest",
32
+ "ListLogMetricsResponse",
33
+ "GetLogMetricRequest",
34
+ "CreateLogMetricRequest",
35
+ "UpdateLogMetricRequest",
36
+ "DeleteLogMetricRequest",
37
+ },
38
+ )
39
+
40
+
41
+ class LogMetric(proto.Message):
42
+ r"""Describes a logs-based metric. The value of the metric is the
43
+ number of log entries that match a logs filter in a given time
44
+ interval.
45
+
46
+ Logs-based metrics can also be used to extract values from logs
47
+ and create a distribution of the values. The distribution
48
+ records the statistics of the extracted values along with an
49
+ optional histogram of the values as specified by the bucket
50
+ options.
51
+
52
+ Attributes:
53
+ name (str):
54
+ Required. The client-assigned metric identifier. Examples:
55
+ ``"error_count"``, ``"nginx/requests"``.
56
+
57
+ Metric identifiers are limited to 100 characters and can
58
+ include only the following characters: ``A-Z``, ``a-z``,
59
+ ``0-9``, and the special characters ``_-.,+!*',()%/``. The
60
+ forward-slash character (``/``) denotes a hierarchy of name
61
+ pieces, and it cannot be the first character of the name.
62
+
63
+ This field is the ``[METRIC_ID]`` part of a metric resource
64
+ name in the format
65
+ "projects/[PROJECT_ID]/metrics/[METRIC_ID]". Example: If the
66
+ resource name of a metric is
67
+ ``"projects/my-project/metrics/nginx%2Frequests"``, this
68
+ field's value is ``"nginx/requests"``.
69
+ description (str):
70
+ Optional. A description of this metric, which
71
+ is used in documentation. The maximum length of
72
+ the description is 8000 characters.
73
+ filter (str):
74
+ Required. An `advanced logs
75
+ filter <https://cloud.google.com/logging/docs/view/advanced_filters>`__
76
+ which is used to match log entries. Example:
77
+
78
+ ::
79
+
80
+ "resource.type=gae_app AND severity>=ERROR"
81
+
82
+ The maximum length of the filter is 20000 characters.
83
+ bucket_name (str):
84
+ Optional. The resource name of the Log Bucket that owns the
85
+ Log Metric. Only Log Buckets in projects are supported. The
86
+ bucket has to be in the same project as the metric.
87
+
88
+ For example:
89
+
90
+ ``projects/my-project/locations/global/buckets/my-bucket``
91
+
92
+ If empty, then the Log Metric is considered a non-Bucket Log
93
+ Metric.
94
+ disabled (bool):
95
+ Optional. If set to True, then this metric is
96
+ disabled and it does not generate any points.
97
+ metric_descriptor (google.api.metric_pb2.MetricDescriptor):
98
+ Optional. The metric descriptor associated with the
99
+ logs-based metric. If unspecified, it uses a default metric
100
+ descriptor with a DELTA metric kind, INT64 value type, with
101
+ no labels and a unit of "1". Such a metric counts the number
102
+ of log entries matching the ``filter`` expression.
103
+
104
+ The ``name``, ``type``, and ``description`` fields in the
105
+ ``metric_descriptor`` are output only, and is constructed
106
+ using the ``name`` and ``description`` field in the
107
+ LogMetric.
108
+
109
+ To create a logs-based metric that records a distribution of
110
+ log values, a DELTA metric kind with a DISTRIBUTION value
111
+ type must be used along with a ``value_extractor``
112
+ expression in the LogMetric.
113
+
114
+ Each label in the metric descriptor must have a matching
115
+ label name as the key and an extractor expression as the
116
+ value in the ``label_extractors`` map.
117
+
118
+ The ``metric_kind`` and ``value_type`` fields in the
119
+ ``metric_descriptor`` cannot be updated once initially
120
+ configured. New labels can be added in the
121
+ ``metric_descriptor``, but existing labels cannot be
122
+ modified except for their description.
123
+ value_extractor (str):
124
+ Optional. A ``value_extractor`` is required when using a
125
+ distribution logs-based metric to extract the values to
126
+ record from a log entry. Two functions are supported for
127
+ value extraction: ``EXTRACT(field)`` or
128
+ ``REGEXP_EXTRACT(field, regex)``. The arguments are:
129
+
130
+ 1. field: The name of the log entry field from which the
131
+ value is to be extracted.
132
+ 2. regex: A regular expression using the Google RE2 syntax
133
+ (https://github.com/google/re2/wiki/Syntax) with a single
134
+ capture group to extract data from the specified log
135
+ entry field. The value of the field is converted to a
136
+ string before applying the regex. It is an error to
137
+ specify a regex that does not include exactly one capture
138
+ group.
139
+
140
+ The result of the extraction must be convertible to a double
141
+ type, as the distribution always records double values. If
142
+ either the extraction or the conversion to double fails,
143
+ then those values are not recorded in the distribution.
144
+
145
+ Example:
146
+ ``REGEXP_EXTRACT(jsonPayload.request, ".*quantity=(\d+).*")``
147
+ label_extractors (MutableMapping[str, str]):
148
+ Optional. A map from a label key string to an extractor
149
+ expression which is used to extract data from a log entry
150
+ field and assign as the label value. Each label key
151
+ specified in the LabelDescriptor must have an associated
152
+ extractor expression in this map. The syntax of the
153
+ extractor expression is the same as for the
154
+ ``value_extractor`` field.
155
+
156
+ The extracted value is converted to the type defined in the
157
+ label descriptor. If either the extraction or the type
158
+ conversion fails, the label will have a default value. The
159
+ default value for a string label is an empty string, for an
160
+ integer label its 0, and for a boolean label its ``false``.
161
+
162
+ Note that there are upper bounds on the maximum number of
163
+ labels and the number of active time series that are allowed
164
+ in a project.
165
+ bucket_options (google.api.distribution_pb2.BucketOptions):
166
+ Optional. The ``bucket_options`` are required when the
167
+ logs-based metric is using a DISTRIBUTION value type and it
168
+ describes the bucket boundaries used to create a histogram
169
+ of the extracted values.
170
+ create_time (google.protobuf.timestamp_pb2.Timestamp):
171
+ Output only. The creation timestamp of the
172
+ metric.
173
+ This field may not be present for older metrics.
174
+ update_time (google.protobuf.timestamp_pb2.Timestamp):
175
+ Output only. The last update timestamp of the
176
+ metric.
177
+ This field may not be present for older metrics.
178
+ version (google.cloud.logging_v2.types.LogMetric.ApiVersion):
179
+ Deprecated. The API version that created or
180
+ updated this metric. The v2 format is used by
181
+ default and cannot be changed.
182
+ """
183
+
184
+ class ApiVersion(proto.Enum):
185
+ r"""Logging API version.
186
+
187
+ Values:
188
+ V2 (0):
189
+ Logging API v2.
190
+ V1 (1):
191
+ Logging API v1.
192
+ """
193
+ V2 = 0
194
+ V1 = 1
195
+
196
+ name: str = proto.Field(
197
+ proto.STRING,
198
+ number=1,
199
+ )
200
+ description: str = proto.Field(
201
+ proto.STRING,
202
+ number=2,
203
+ )
204
+ filter: str = proto.Field(
205
+ proto.STRING,
206
+ number=3,
207
+ )
208
+ bucket_name: str = proto.Field(
209
+ proto.STRING,
210
+ number=13,
211
+ )
212
+ disabled: bool = proto.Field(
213
+ proto.BOOL,
214
+ number=12,
215
+ )
216
+ metric_descriptor: metric_pb2.MetricDescriptor = proto.Field(
217
+ proto.MESSAGE,
218
+ number=5,
219
+ message=metric_pb2.MetricDescriptor,
220
+ )
221
+ value_extractor: str = proto.Field(
222
+ proto.STRING,
223
+ number=6,
224
+ )
225
+ label_extractors: MutableMapping[str, str] = proto.MapField(
226
+ proto.STRING,
227
+ proto.STRING,
228
+ number=7,
229
+ )
230
+ bucket_options: distribution_pb2.Distribution.BucketOptions = proto.Field(
231
+ proto.MESSAGE,
232
+ number=8,
233
+ message=distribution_pb2.Distribution.BucketOptions,
234
+ )
235
+ create_time: timestamp_pb2.Timestamp = proto.Field(
236
+ proto.MESSAGE,
237
+ number=9,
238
+ message=timestamp_pb2.Timestamp,
239
+ )
240
+ update_time: timestamp_pb2.Timestamp = proto.Field(
241
+ proto.MESSAGE,
242
+ number=10,
243
+ message=timestamp_pb2.Timestamp,
244
+ )
245
+ version: ApiVersion = proto.Field(
246
+ proto.ENUM,
247
+ number=4,
248
+ enum=ApiVersion,
249
+ )
250
+
251
+
252
+ class ListLogMetricsRequest(proto.Message):
253
+ r"""The parameters to ListLogMetrics.
254
+
255
+ Attributes:
256
+ parent (str):
257
+ Required. The name of the project containing the metrics:
258
+
259
+ ::
260
+
261
+ "projects/[PROJECT_ID]".
262
+ page_token (str):
263
+ Optional. If present, then retrieve the next batch of
264
+ results from the preceding call to this method.
265
+ ``pageToken`` must be the value of ``nextPageToken`` from
266
+ the previous response. The values of other method parameters
267
+ should be identical to those in the previous call.
268
+ page_size (int):
269
+ Optional. The maximum number of results to return from this
270
+ request. Non-positive values are ignored. The presence of
271
+ ``nextPageToken`` in the response indicates that more
272
+ results might be available.
273
+ """
274
+
275
+ parent: str = proto.Field(
276
+ proto.STRING,
277
+ number=1,
278
+ )
279
+ page_token: str = proto.Field(
280
+ proto.STRING,
281
+ number=2,
282
+ )
283
+ page_size: int = proto.Field(
284
+ proto.INT32,
285
+ number=3,
286
+ )
287
+
288
+
289
+ class ListLogMetricsResponse(proto.Message):
290
+ r"""Result returned from ListLogMetrics.
291
+
292
+ Attributes:
293
+ metrics (MutableSequence[google.cloud.logging_v2.types.LogMetric]):
294
+ A list of logs-based metrics.
295
+ next_page_token (str):
296
+ If there might be more results than appear in this response,
297
+ then ``nextPageToken`` is included. To get the next set of
298
+ results, call this method again using the value of
299
+ ``nextPageToken`` as ``pageToken``.
300
+ """
301
+
302
+ @property
303
+ def raw_page(self):
304
+ return self
305
+
306
+ metrics: MutableSequence["LogMetric"] = proto.RepeatedField(
307
+ proto.MESSAGE,
308
+ number=1,
309
+ message="LogMetric",
310
+ )
311
+ next_page_token: str = proto.Field(
312
+ proto.STRING,
313
+ number=2,
314
+ )
315
+
316
+
317
+ class GetLogMetricRequest(proto.Message):
318
+ r"""The parameters to GetLogMetric.
319
+
320
+ Attributes:
321
+ metric_name (str):
322
+ Required. The resource name of the desired metric:
323
+
324
+ ::
325
+
326
+ "projects/[PROJECT_ID]/metrics/[METRIC_ID]".
327
+ """
328
+
329
+ metric_name: str = proto.Field(
330
+ proto.STRING,
331
+ number=1,
332
+ )
333
+
334
+
335
+ class CreateLogMetricRequest(proto.Message):
336
+ r"""The parameters to CreateLogMetric.
337
+
338
+ Attributes:
339
+ parent (str):
340
+ Required. The resource name of the project in which to
341
+ create the metric:
342
+
343
+ ::
344
+
345
+ "projects/[PROJECT_ID]"
346
+
347
+ The new metric must be provided in the request.
348
+ metric (google.cloud.logging_v2.types.LogMetric):
349
+ Required. The new logs-based metric, which
350
+ must not have an identifier that already exists.
351
+ """
352
+
353
+ parent: str = proto.Field(
354
+ proto.STRING,
355
+ number=1,
356
+ )
357
+ metric: "LogMetric" = proto.Field(
358
+ proto.MESSAGE,
359
+ number=2,
360
+ message="LogMetric",
361
+ )
362
+
363
+
364
+ class UpdateLogMetricRequest(proto.Message):
365
+ r"""The parameters to UpdateLogMetric.
366
+
367
+ Attributes:
368
+ metric_name (str):
369
+ Required. The resource name of the metric to update:
370
+
371
+ ::
372
+
373
+ "projects/[PROJECT_ID]/metrics/[METRIC_ID]"
374
+
375
+ The updated metric must be provided in the request and it's
376
+ ``name`` field must be the same as ``[METRIC_ID]`` If the
377
+ metric does not exist in ``[PROJECT_ID]``, then a new metric
378
+ is created.
379
+ metric (google.cloud.logging_v2.types.LogMetric):
380
+ Required. The updated metric.
381
+ """
382
+
383
+ metric_name: str = proto.Field(
384
+ proto.STRING,
385
+ number=1,
386
+ )
387
+ metric: "LogMetric" = proto.Field(
388
+ proto.MESSAGE,
389
+ number=2,
390
+ message="LogMetric",
391
+ )
392
+
393
+
394
+ class DeleteLogMetricRequest(proto.Message):
395
+ r"""The parameters to DeleteLogMetric.
396
+
397
+ Attributes:
398
+ metric_name (str):
399
+ Required. The resource name of the metric to delete:
400
+
401
+ ::
402
+
403
+ "projects/[PROJECT_ID]/metrics/[METRIC_ID]".
404
+ """
405
+
406
+ metric_name: str = proto.Field(
407
+ proto.STRING,
408
+ number=1,
409
+ )
410
+
411
+
412
+ __all__ = tuple(sorted(__protobuf__.manifest))
@@ -0,0 +1,143 @@
1
+ Metadata-Version: 2.4
2
+ Name: google-cloud-logging
3
+ Version: 3.13.0
4
+ Summary: Stackdriver Logging API client library
5
+ Home-page: https://github.com/googleapis/python-logging
6
+ Author: Google LLC
7
+ Author-email: googleapis-packages@google.com
8
+ License: Apache 2.0
9
+ Platform: Posix; MacOS X; Windows
10
+ Classifier: Development Status :: 5 - Production/Stable
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: License :: OSI Approved :: Apache Software License
13
+ Classifier: Programming Language :: Python
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.7
16
+ Classifier: Programming Language :: Python :: 3.8
17
+ Classifier: Programming Language :: Python :: 3.9
18
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Programming Language :: Python :: 3.14
23
+ Classifier: Operating System :: OS Independent
24
+ Classifier: Topic :: Internet
25
+ Requires-Python: >=3.7
26
+ License-File: LICENSE
27
+ Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.1
28
+ Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
29
+ Requires-Dist: google-cloud-appengine-logging<2.0.0,>=0.1.3
30
+ Requires-Dist: google-cloud-audit-log<1.0.0,>=0.3.1
31
+ Requires-Dist: google-cloud-core<3.0.0,>=2.0.0
32
+ Requires-Dist: grpc-google-iam-v1<1.0.0,>=0.12.4
33
+ Requires-Dist: opentelemetry-api>=1.9.0
34
+ Requires-Dist: proto-plus<2.0.0,>=1.22.0
35
+ Requires-Dist: proto-plus<2.0.0,>=1.22.2; python_version >= "3.11"
36
+ Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
37
+ Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2
38
+ Dynamic: author
39
+ Dynamic: author-email
40
+ Dynamic: classifier
41
+ Dynamic: description
42
+ Dynamic: home-page
43
+ Dynamic: license
44
+ Dynamic: license-file
45
+ Dynamic: platform
46
+ Dynamic: requires-dist
47
+ Dynamic: requires-python
48
+ Dynamic: summary
49
+
50
+ Python Client for Cloud Logging
51
+ =====================================
52
+
53
+ |pypi| |versions|
54
+
55
+ `Cloud Logging API`_: Writes log entries and manages your Cloud
56
+ Logging configuration.
57
+
58
+ - `Client Library Documentation`_
59
+ - `Product Documentation`_
60
+
61
+ .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-logging.svg
62
+ :target: https://pypi.org/project/google-cloud-logging/
63
+ .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-logging.svg
64
+ :target: https://pypi.org/project/google-cloud-logging/
65
+ .. _Cloud Logging API: https://cloud.google.com/logging
66
+ .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/logging/latest/summary_overview
67
+ .. _Product Documentation: https://cloud.google.com/logging/docs
68
+ .. _Setting Up Cloud Logging for Python: https://cloud.google.com/logging/docs/setup/python
69
+ .. _Python's standard logging library: https://docs.python.org/2/library/logging.html
70
+
71
+ Quick Start
72
+ -----------
73
+
74
+ In order to use this library, you first need to go through the following steps:
75
+
76
+ 1. `Select or create a Cloud Platform project.`_
77
+ 2. `Enable billing for your project.`_
78
+ 3. `Enable the Cloud Logging API.`_
79
+ 4. `Setup Authentication.`_
80
+
81
+ .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
82
+ .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
83
+ .. _Enable the Cloud Logging API.: https://cloud.google.com/logging
84
+ .. _Setup Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
85
+
86
+ For an interactive walkthrough on how to use this library in a python application, click the Guide Me button below:
87
+
88
+ |guide|
89
+
90
+ .. |guide| image:: https://raw.githubusercontent.com/googleapis/python-logging/main/_static/guide-me.png
91
+ :target: https://console.cloud.google.com/?walkthrough_id=logging__logging-python
92
+
93
+ Installation
94
+ ~~~~~~~~~~~~
95
+
96
+ Install this library in a `venv`_ using pip. `venv`_ is a tool to
97
+ create isolated Python environments. The basic problem it addresses is one of
98
+ dependencies and versions, and indirectly permissions.
99
+
100
+ With `venv`_, it's possible to install this library without needing system
101
+ install permissions, and without clashing with the installed system
102
+ dependencies.
103
+
104
+ .. _`venv`: https://docs.python.org/3/library/venv.html
105
+
106
+
107
+ Supported Python Versions
108
+ ^^^^^^^^^^^^^^^^^^^^^^^^^
109
+ Python >= 3.7
110
+
111
+ Unsupported Python Versions
112
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
113
+ | Python == 2.7. The last version of the library compatible with Python 2.7 is ``google-cloud-logging==1.15.1``.
114
+ | Python == 3.6. The last version of the library compatible with Python 3.6 is ``google-cloud-logging==3.1.2``.
115
+
116
+
117
+ Mac/Linux
118
+ ^^^^^^^^^
119
+
120
+ .. code-block:: console
121
+
122
+ python -m venv <your-env>
123
+ source <your-env>/bin/activate
124
+ <your-env>/bin/pip install google-cloud-logging
125
+
126
+
127
+ Windows
128
+ ^^^^^^^
129
+
130
+ .. code-block:: console
131
+
132
+ python -m venv <your-env>
133
+ <your-env>\Scripts\activate
134
+ <your-env>\Scripts\pip.exe install google-cloud-logging
135
+
136
+ Next Steps
137
+ ~~~~~~~~~~
138
+
139
+ - Read the `Setting Up Cloud Logging for Python`_ How-to Guide
140
+ - Read the `Product documentation`_ to learn more about the product and see
141
+ other How-to Guides.
142
+ - Read the `Client Library Documentation`_ for to see other available
143
+ methods on the client.
@@ -0,0 +1,68 @@
1
+ google/cloud/logging/__init__.py,sha256=AH_NMksG3tzwuyKhX5Ab7i2kcW8uVV1xOn3k8wynb8M,1700
2
+ google/cloud/logging/gapic_version.py,sha256=jKR_T28C7uaN5Dr4ZACA6oZBWTZh9OHzFYbUYe133Ws,653
3
+ google/cloud/logging/py.typed,sha256=FMgEe54fsD3NRYC5f7cb0Tu-cP41H4DsGNcSt_hUV9M,81
4
+ google/cloud/logging/handlers/__init__.py,sha256=eGZ0QrTuQMEa6zsJMivRaxU8wZWRhXDZN_STgU1GD5c,1264
5
+ google/cloud/logging/handlers/middleware/__init__.py,sha256=RYbDZHb51RGjNuErJgnFjp54oNzUovX5cqUeOdL5K1U,711
6
+ google/cloud/logging/handlers/transports/__init__.py,sha256=MA58p6uxNMy68M_36PEa1C7RxBG5t5m8GxtMaVBMYxE,1191
7
+ google/cloud/logging_v2/__init__.py,sha256=Qg2Fsbr3DR7wbNcaqKj47C3Ul_WoI8oT8YnXjatcKV0,1947
8
+ google/cloud/logging_v2/_gapic.py,sha256=0BjwGU6vpiJLfPnOROMF1BICQjNcA1oR_6760J-O14I,24145
9
+ google/cloud/logging_v2/_helpers.py,sha256=RUKm774gaGkxXSoLn4gZ8HYb7mAqwRbBFncd7Intp40,4739
10
+ google/cloud/logging_v2/_http.py,sha256=2r7-EPtAf9tQci3Hxt52gqUzeUVf0033_sTaSzozArU,20518
11
+ google/cloud/logging_v2/_instrumentation.py,sha256=EdlxbXapTpmyK_QzRU8jl1_i2r2HdXTg8oAOt5pBkXQ,3315
12
+ google/cloud/logging_v2/client.py,sha256=SVHYwURYr_Ys6CV5WfnSavxx-Ot9mxqxobQdxU1wBOc,17364
13
+ google/cloud/logging_v2/entries.py,sha256=hdvCoZSWM5fEmcMm_lextOm6NHxgdMNydeRkpFKXysM,11759
14
+ google/cloud/logging_v2/gapic_metadata.json,sha256=oxM-TRjiSt6UhwGF7LWzLPFQwymAsC2G6VsH92QZhlA,11572
15
+ google/cloud/logging_v2/gapic_version.py,sha256=jKR_T28C7uaN5Dr4ZACA6oZBWTZh9OHzFYbUYe133Ws,653
16
+ google/cloud/logging_v2/logger.py,sha256=SS6dyIYDt4bQu9l0mG166yfchU_OGdLyjUxh4PgiNZM,21074
17
+ google/cloud/logging_v2/metric.py,sha256=9vnaz39PoOI8gyn5T3Z9t3qnVOdmZ0smLYDu0bUAHCo,6316
18
+ google/cloud/logging_v2/py.typed,sha256=FMgEe54fsD3NRYC5f7cb0Tu-cP41H4DsGNcSt_hUV9M,81
19
+ google/cloud/logging_v2/resource.py,sha256=ZYnr7lEZzXez_dikpt57yQGDcvip7ZlXqBZCUGwqQsc,1699
20
+ google/cloud/logging_v2/sink.py,sha256=8Dwy5PlNAEno2QVWFzzqUJDj9ztWgzyrsfYdDwUF_Ro,8334
21
+ google/cloud/logging_v2/handlers/__init__.py,sha256=J9nsdad0ExOqWKZ9Ug9soPc4BVuH6uBT-0xJJilSCxE,1264
22
+ google/cloud/logging_v2/handlers/_helpers.py,sha256=I358VnklS0TwLF54a3jZTVdps79ngF5QfpfXVrpp9Is,10604
23
+ google/cloud/logging_v2/handlers/_monitored_resources.py,sha256=h1FuEtsOkZ4HAOtDBS1B71fg8Eys7wni4tOfECXowI8,10609
24
+ google/cloud/logging_v2/handlers/app_engine.py,sha256=EKF6E_x24I7bhN93WGGdqUhpJWf2vcovGXJ89yv0Ki0,4772
25
+ google/cloud/logging_v2/handlers/container_engine.py,sha256=aE5B20XYO1ZopJ-YSCp2NKvjr7NvZsasBuG4a1xVKZw,2233
26
+ google/cloud/logging_v2/handlers/handlers.py,sha256=YHnG6Q6E_TTV3b7FeVYTX98D26xnnFIabrimjiPlHZ8,12689
27
+ google/cloud/logging_v2/handlers/structured_log.py,sha256=McB55oNdRt4LvMWLii7lQMVjQZs5MiIm8KS0td-JFs8,5709
28
+ google/cloud/logging_v2/handlers/middleware/__init__.py,sha256=RYbDZHb51RGjNuErJgnFjp54oNzUovX5cqUeOdL5K1U,711
29
+ google/cloud/logging_v2/handlers/middleware/request.py,sha256=22io7_-M8U8T2Tkkd7v-CARV_bMLsiRxSdqnC-Ju27w,1447
30
+ google/cloud/logging_v2/handlers/transports/__init__.py,sha256=YB4Mm5voqk_TLh9zGNVWBsHdEmUyE0OTD5C4VxFnTlc,1192
31
+ google/cloud/logging_v2/handlers/transports/background_thread.py,sha256=0n8--MAR0Y0f5wV-rlV1Nnd8SQnOc3CByScM8n5I5u4,12488
32
+ google/cloud/logging_v2/handlers/transports/base.py,sha256=VgVQYsspbo3wMSBJk834xmJxVyEOKW5xMA_RyP3Lttg,2134
33
+ google/cloud/logging_v2/handlers/transports/sync.py,sha256=CGNpfGc1B8U7LWNFM-S0m5qz8r0OnlFqChPDu5AIFgM,2503
34
+ google/cloud/logging_v2/services/__init__.py,sha256=ABnBlq63X5TtiLc0JptfQUECNGc-s0WTBlbk0_83qf0,600
35
+ google/cloud/logging_v2/services/config_service_v2/__init__.py,sha256=BKfxsC95eyIWS8mPmrmXvYJP3x8RWQKKJX6_I7y5Hoc,773
36
+ google/cloud/logging_v2/services/config_service_v2/async_client.py,sha256=IwQJzB9EM2oJRlTeTRXv5PXc6bd53e2EN602Wvh2kIA,177408
37
+ google/cloud/logging_v2/services/config_service_v2/client.py,sha256=i55etiIFgskJRvYNxi8NF-7UB76lrnLFAsiaa6Oqa4w,193674
38
+ google/cloud/logging_v2/services/config_service_v2/pagers.py,sha256=WzWHXBjG01XsW8oUI9R2CGuAIdx0n-MfEMz_I6vEJwQ,32964
39
+ google/cloud/logging_v2/services/config_service_v2/transports/__init__.py,sha256=y52EVGIJHSIROplaNxMSX10b-BG7czeuSeDbi7kSw7A,1203
40
+ google/cloud/logging_v2/services/config_service_v2/transports/base.py,sha256=1h250Vhe-0S9_DI3mMtRc7zzXo-MxB_7_spu2LZ5laI,24992
41
+ google/cloud/logging_v2/services/config_service_v2/transports/grpc.py,sha256=_ClYB-1D8X1K1cVjMWIf3tCZy8sfybfHEQ6ubtjeWZ0,58065
42
+ google/cloud/logging_v2/services/config_service_v2/transports/grpc_asyncio.py,sha256=X5U8vrSkhIqu2LqCWLtwfA3F8N9Kp612qGTwinQ_fNg,69598
43
+ google/cloud/logging_v2/services/logging_service_v2/__init__.py,sha256=9JJvlrIDfv6JmiKUbxLZNu4B26xE1A4RyXtIsR_qn7E,777
44
+ google/cloud/logging_v2/services/logging_service_v2/async_client.py,sha256=xshdaCZwgx9qEOtukxh2XKasgVtfEQOYqPm7d30RlAI,54913
45
+ google/cloud/logging_v2/services/logging_service_v2/client.py,sha256=KMD9V2yX11KWxI8wtSeKMOa4FNxMXvZqEOi1PsrZo7Y,70934
46
+ google/cloud/logging_v2/services/logging_service_v2/pagers.py,sha256=-EtZTPrPVul5krQyhe4a_-I0ZwYMdoH7oarmAT6Mv98,20921
47
+ google/cloud/logging_v2/services/logging_service_v2/transports/__init__.py,sha256=YOy1_cvuah0vzFv2UmUYX-ZEwIVXAzXJ19I6AHQltfM,1212
48
+ google/cloud/logging_v2/services/logging_service_v2/transports/base.py,sha256=VOcJEIODRz0QRkwx3j8sUvBqoHwDrruLYR6RN3lSh68,13301
49
+ google/cloud/logging_v2/services/logging_service_v2/transports/grpc.py,sha256=ocatfGDDVzCeOgyz60MVV4CuN13NR3FgxYS3z2-XdQM,25529
50
+ google/cloud/logging_v2/services/logging_service_v2/transports/grpc_asyncio.py,sha256=dlupXcX6CkgxcdGvT6H0PrddQU20E3uyq6gU0UddiC0,31099
51
+ google/cloud/logging_v2/services/metrics_service_v2/__init__.py,sha256=q6brjKIlzQx0iILc84wK8KAtS35PcvdCgQVCHN9pncc,777
52
+ google/cloud/logging_v2/services/metrics_service_v2/async_client.py,sha256=2JF1V6r47h--nFRCZWG39Qylj0ZqUXrn4D7iVdKqj2A,46514
53
+ google/cloud/logging_v2/services/metrics_service_v2/client.py,sha256=rwWDOLpF0FN_bWtbrcnaBgwPuIWkZNrJuZeA14k1jJY,62701
54
+ google/cloud/logging_v2/services/metrics_service_v2/pagers.py,sha256=1VQ79MvH5Ys8iA6SHYWoNL8z9VkhrhT4WI1OeddpfrA,7769
55
+ google/cloud/logging_v2/services/metrics_service_v2/transports/__init__.py,sha256=mN3jv65jctXm8xw6Jdgw4X7GfjS9J5NmLOok8Jf7Mvs,1212
56
+ google/cloud/logging_v2/services/metrics_service_v2/transports/base.py,sha256=xzBlhjDAPtMFKYR268u2I05xMkzPX4Nn-dta4UHbTf0,11856
57
+ google/cloud/logging_v2/services/metrics_service_v2/transports/grpc.py,sha256=QVBJJRzTJxNbo2qP1KXcHKQ1pL03ov2HtO1cUASM3Do,23178
58
+ google/cloud/logging_v2/services/metrics_service_v2/transports/grpc_asyncio.py,sha256=r9JF6OV-d56ZurGrZdaZi9pzzYaFpexJLiXT32vQyZw,27585
59
+ google/cloud/logging_v2/types/__init__.py,sha256=5yktQt0VMZz9OOukKUCcdWG8fkkl_hnNB8sx_CxQFRY,4482
60
+ google/cloud/logging_v2/types/log_entry.py,sha256=rOj3IzYbXoyouHZI4HbEP-cKRorG5J0UG1P9BdIh-84,16697
61
+ google/cloud/logging_v2/types/logging.py,sha256=n8X7iTGh4Y1fWhMrlWSFeFwXZrnPupeMSyavt6KDZ0c,23078
62
+ google/cloud/logging_v2/types/logging_config.py,sha256=JBbBFq8h4NdurloCQ7imsWAFJ3W4VkZIDYLsUAXirwk,79120
63
+ google/cloud/logging_v2/types/logging_metrics.py,sha256=JwTcikJVkryoOSGLr3WrfH_wpi0Bb9MJaYdZkIrq0ow,14083
64
+ google_cloud_logging-3.13.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
65
+ google_cloud_logging-3.13.0.dist-info/METADATA,sha256=hgniHobrqn_hjg1xramPRTN_23uS62K4UPHXM5RPuUc,5297
66
+ google_cloud_logging-3.13.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
67
+ google_cloud_logging-3.13.0.dist-info/top_level.txt,sha256=_1QvSJIhFAGfxb79D6DhB7SUw2X6T4rwnz_LLrbcD3c,7
68
+ google_cloud_logging-3.13.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (80.9.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+