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.
- google/cloud/logging/__init__.py +53 -0
- google/cloud/logging/gapic_version.py +16 -0
- google/cloud/logging/handlers/__init__.py +31 -0
- google/cloud/logging/handlers/middleware/__init__.py +17 -0
- google/cloud/logging/handlers/transports/__init__.py +28 -0
- google/cloud/logging/py.typed +2 -0
- google/cloud/logging_v2/__init__.py +61 -0
- google/cloud/logging_v2/_gapic.py +647 -0
- google/cloud/logging_v2/_helpers.py +152 -0
- google/cloud/logging_v2/_http.py +549 -0
- google/cloud/logging_v2/_instrumentation.py +92 -0
- google/cloud/logging_v2/client.py +429 -0
- google/cloud/logging_v2/entries.py +358 -0
- google/cloud/logging_v2/gapic_metadata.json +481 -0
- google/cloud/logging_v2/gapic_version.py +16 -0
- google/cloud/logging_v2/handlers/__init__.py +31 -0
- google/cloud/logging_v2/handlers/_helpers.py +283 -0
- google/cloud/logging_v2/handlers/_monitored_resources.py +303 -0
- google/cloud/logging_v2/handlers/app_engine.py +139 -0
- google/cloud/logging_v2/handlers/container_engine.py +62 -0
- google/cloud/logging_v2/handlers/handlers.py +340 -0
- google/cloud/logging_v2/handlers/middleware/__init__.py +17 -0
- google/cloud/logging_v2/handlers/middleware/request.py +52 -0
- google/cloud/logging_v2/handlers/structured_log.py +150 -0
- google/cloud/logging_v2/handlers/transports/__init__.py +29 -0
- google/cloud/logging_v2/handlers/transports/background_thread.py +343 -0
- google/cloud/logging_v2/handlers/transports/base.py +61 -0
- google/cloud/logging_v2/handlers/transports/sync.py +68 -0
- google/cloud/logging_v2/logger.py +541 -0
- google/cloud/logging_v2/metric.py +180 -0
- google/cloud/logging_v2/py.typed +2 -0
- google/cloud/logging_v2/resource.py +51 -0
- google/cloud/logging_v2/services/__init__.py +15 -0
- google/cloud/logging_v2/services/config_service_v2/__init__.py +22 -0
- google/cloud/logging_v2/services/config_service_v2/async_client.py +4232 -0
- google/cloud/logging_v2/services/config_service_v2/client.py +4686 -0
- google/cloud/logging_v2/services/config_service_v2/pagers.py +820 -0
- google/cloud/logging_v2/services/config_service_v2/transports/__init__.py +33 -0
- google/cloud/logging_v2/services/config_service_v2/transports/base.py +748 -0
- google/cloud/logging_v2/services/config_service_v2/transports/grpc.py +1345 -0
- google/cloud/logging_v2/services/config_service_v2/transports/grpc_asyncio.py +1660 -0
- google/cloud/logging_v2/services/logging_service_v2/__init__.py +22 -0
- google/cloud/logging_v2/services/logging_service_v2/async_client.py +1272 -0
- google/cloud/logging_v2/services/logging_service_v2/client.py +1686 -0
- google/cloud/logging_v2/services/logging_service_v2/pagers.py +516 -0
- google/cloud/logging_v2/services/logging_service_v2/transports/__init__.py +33 -0
- google/cloud/logging_v2/services/logging_service_v2/transports/base.py +361 -0
- google/cloud/logging_v2/services/logging_service_v2/transports/grpc.py +566 -0
- google/cloud/logging_v2/services/logging_service_v2/transports/grpc_asyncio.py +703 -0
- google/cloud/logging_v2/services/metrics_service_v2/__init__.py +22 -0
- google/cloud/logging_v2/services/metrics_service_v2/async_client.py +1119 -0
- google/cloud/logging_v2/services/metrics_service_v2/client.py +1534 -0
- google/cloud/logging_v2/services/metrics_service_v2/pagers.py +196 -0
- google/cloud/logging_v2/services/metrics_service_v2/transports/__init__.py +33 -0
- google/cloud/logging_v2/services/metrics_service_v2/transports/base.py +320 -0
- google/cloud/logging_v2/services/metrics_service_v2/transports/grpc.py +520 -0
- google/cloud/logging_v2/services/metrics_service_v2/transports/grpc_asyncio.py +629 -0
- google/cloud/logging_v2/sink.py +233 -0
- google/cloud/logging_v2/types/__init__.py +178 -0
- google/cloud/logging_v2/types/log_entry.py +435 -0
- google/cloud/logging_v2/types/logging.py +602 -0
- google/cloud/logging_v2/types/logging_config.py +2418 -0
- google/cloud/logging_v2/types/logging_metrics.py +412 -0
- google_cloud_logging-3.13.0.dist-info/METADATA +143 -0
- google_cloud_logging-3.13.0.dist-info/RECORD +68 -0
- google_cloud_logging-3.13.0.dist-info/WHEEL +5 -0
- google_cloud_logging-3.13.0.dist-info/licenses/LICENSE +202 -0
- 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,,
|