Module entries (3.5.0)

Log entries within the Google Cloud Logging API.

Classes

LogEntry

LogEntry(
 log_name=None,
 labels=None,
 insert_id=None,
 severity=None,
 http_request=None,
 timestamp=None,
 resource=Resource(type="global", labels={}),
 trace=None,
 span_id=None,
 trace_sampled=None,
 source_location=None,
 operation=None,
 logger=None,
 payload=None,
)

Log entry.

Parameters
Name	Description
`log_name`	`str` The name of the logger used to post the entry.
`labels`	`Optional[dict]` Mapping of labels for the entry
`insert_id`	`Optional[str]` The ID used to identify an entry uniquely.
`severity`	`Optional[str]` The severity of the event being logged.
`http_request`	`Optional[dict]` Info about HTTP request associated with the entry.
`timestamp`	`Optional[datetime.datetime]` Timestamp for the entry.
`resource`	`Optional[google.cloud.logging_v2.resource.Resource]` Monitored resource of the entry.
`trace`	`Optional[str]` Trace ID to apply to the entry.
`span_id`	`Optional[str]` Span ID within the trace for the log entry. Specify the trace parameter if `span_id` is set.
`trace_sampled`	`Optional[bool]` The sampling decision of the trace associated with the log entry.
`source_location`	`Optional[dict]` Location in source code from which the entry was emitted.
`operation`	`Optional[dict]` Additional information about a potentially long-running operation associated with the log entry.
`logger`	`logging_v2.logger.Logger See: https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry` the logger used to write the entry.

ProtobufEntry

ProtobufEntry(
 log_name=None,
 labels=None,
 insert_id=None,
 severity=None,
 http_request=None,
 timestamp=None,
 resource=Resource(type="global", labels={}),
 trace=None,
 span_id=None,
 trace_sampled=None,
 source_location=None,
 operation=None,
 logger=None,
 payload=None,
)

Log entry with protobuf message payload.

Parameters
Name	Description
`log_name`	`str` The name of the logger used to post the entry.
`labels`	`Optional[dict]` Mapping of labels for the entry
`insert_id`	`Optional[str]` The ID used to identify an entry uniquely.
`severity`	`Optional[str]` The severity of the event being logged.
`http_request`	`Optional[dict]` Info about HTTP request associated with the entry.
`timestamp`	`Optional[datetime.datetime]` Timestamp for the entry.
`resource`	`Optional[google.cloud.logging_v2.resource.Resource]` Monitored resource of the entry.
`trace`	`Optional[str]` Trace ID to apply to the entry.
`span_id`	`Optional[str]` Span ID within the trace for the log entry. Specify the trace parameter if `span_id` is set.
`trace_sampled`	`Optional[bool]` The sampling decision of the trace associated with the log entry.
`source_location`	`Optional[dict]` Location in source code from which the entry was emitted.
`operation`	`Optional[dict]` Additional information about a potentially long-running operation associated with the log entry.
`logger`	`logging_v2.logger.Logger` the logger used to write the entry.
`payload`	`google.protobuf.Message See: https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry` payload for the log entry.

StructEntry

StructEntry(
 log_name=None,
 labels=None,
 insert_id=None,
 severity=None,
 http_request=None,
 timestamp=None,
 resource=Resource(type="global", labels={}),
 trace=None,
 span_id=None,
 trace_sampled=None,
 source_location=None,
 operation=None,
 logger=None,
 payload=None,
)

Log entry with JSON payload.

Parameters
Name	Description
`log_name`	`str` The name of the logger used to post the entry.
`labels`	`Optional[dict]` Mapping of labels for the entry
`insert_id`	`Optional[str]` The ID used to identify an entry uniquely.
`severity`	`Optional[str]` The severity of the event being logged.
`http_request`	`Optional[dict]` Info about HTTP request associated with the entry.
`timestamp`	`Optional[datetime.datetime]` Timestamp for the entry.
`resource`	`Optional[google.cloud.logging_v2.resource.Resource]` Monitored resource of the entry.
`trace`	`Optional[str]` Trace ID to apply to the entry.
`span_id`	`Optional[str]` Span ID within the trace for the log entry. Specify the trace parameter if `span_id` is set.
`trace_sampled`	`Optional[bool]` The sampling decision of the trace associated with the log entry.
`source_location`	`Optional[dict]` Location in source code from which the entry was emitted.
`operation`	`Optional[dict]` Additional information about a potentially long-running operation associated with the log entry.
`logger`	`logging_v2.logger.Logger` the logger used to write the entry.
`payload`	`dict See: https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry` payload for the log entry.

TextEntry

TextEntry(
 log_name=None,
 labels=None,
 insert_id=None,
 severity=None,
 http_request=None,
 timestamp=None,
 resource=Resource(type="global", labels={}),
 trace=None,
 span_id=None,
 trace_sampled=None,
 source_location=None,
 operation=None,
 logger=None,
 payload=None,
)

Log entry with text payload.

Parameters
Name	Description
`log_name`	`str` The name of the logger used to post the entry.
`labels`	`Optional[dict]` Mapping of labels for the entry
`insert_id`	`Optional[str]` The ID used to identify an entry uniquely.
`severity`	`Optional[str]` The severity of the event being logged.
`http_request`	`Optional[dict]` Info about HTTP request associated with the entry.
`timestamp`	`Optional[datetime.datetime]` Timestamp for the entry.
`resource`	`Optional[google.cloud.logging_v2.resource.Resource]` Monitored resource of the entry.
`trace`	`Optional[str]` Trace ID to apply to the entry.
`span_id`	`Optional[str]` Span ID within the trace for the log entry. Specify the trace parameter if `span_id` is set.
`trace_sampled`	`Optional[bool]` The sampling decision of the trace associated with the log entry.
`source_location`	`Optional[dict]` Location in source code from which the entry was emitted.
`operation`	`Optional[dict]` Additional information about a potentially long-running operation associated with the log entry.
`logger`	`logging_v2.logger.Logger` the logger used to write the entry.
`payload`	`str See: https://cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry` payload for the log entry.

Modules Functions

logger_name_from_path

logger_name_from_path(path, project=None)

Validate a logger URI path and get the logger name.

Parameters
Name	Description
`path`	`str` URI path for a logger API request
`project`	`str` The project the path is expected to belong to

Exceptions
Type	Description
`ValueError`	If the `path` is ill-formed of if the project from `path` does not agree with the `project` passed in.

Returns
Type	Description
`str`	Logger name parsed from `path`.

Module entries (3.5.0) Stay organized with collections Save and categorize content based on your preferences.