Batch
(
logger
,
client
,
*
,
resource
=
None
)
Context manager: collect entries to log via a single API call.
Helper returned by Logger.batch
Parameters
logger
logging_v2.logger.Logger
the logger to which entries will be logged.
client
logging_V2.client.Cilent
The client to use.
resource
Optional[ logging_v2.resource.Resource
]
Monitored resource of the batch, defaults to None, which requires that every entry should have a resource specified. Since the methods used to write entries default the entry's resource to the global resource type, this parameter is only required if explicitly set to None. If no entries' resource are set to None, this parameter will be ignored on the server.
Methods
commit
commit
(
*
,
client
=
None
)
Send saved log entries as a single API call.
client
Optional[ logging_v2.client.Client
]
The client to use. If not passed, falls back to the client
stored on the current batch.
log
log
(
message
=
None
,
**
kw
)
Add an arbitrary message to be logged during commit
.
Type will be inferred based on the input message.
kw
Optional[dict]
Additional keyword arguments for the entry. See logging_v2.entries.LogEntry
.
message
Optional[str or dict or google.protobuf.Message]
The message. to log
log_empty
log_empty
(
**
kw
)
Add a entry without payload to be logged during commit
.
kw
Optional[dict]
Additional keyword arguments for the entry. See logging_v2.entries.LogEntry
.
log_proto
log_proto
(
message
,
**
kw
)
Add a protobuf entry to be logged during commit
.
kw
Optional[dict]
Additional keyword arguments for the entry. See logging_v2.entries.LogEntry
.
message
google.protobuf.Message
The protobuf entry.
log_struct
log_struct
(
info
,
**
kw
)
Add a struct entry to be logged during commit
.
kw
Optional[dict]
Additional keyword arguments for the entry. See logging_v2.entries.LogEntry
.
info
dict
The struct entry,
log_text
log_text
(
text
,
**
kw
)
Add a text entry to be logged during commit
.
kw
Optional[dict]
Additional keyword arguments for the entry. See logging_v2.entries.LogEntry
.
text
str
the text entry
