Cloud Logging Service, gRPC: LogIngestionService.Write

Field

Description

destination

Destination

Required field. Log entries destination.
See Destination for details.

resource

LogEntryResource

Required field. Common resource (type, ID) specification for log entries.

entries[]

IncomingLogEntry

List of log entries.

The number of elements must be in the range 1-100.

defaults

LogEntryDefaults

Log entries defaults.
See LogEntryDefaults for details.

Field

Description

log_group_id

string

Entry should be written to log group resolved by ID.

The maximum string length in characters is 63. Value must match the regular expression ([a-zA-Z][-a-zA-Z0-9_.]{0,63})?.

Includes only one of the fields log_group_id, folder_id.

Entry destination.

folder_id

string

Entry should be written to default log group for the folder.

Value must match the regular expression ([a-zA-Z][-a-zA-Z0-9_.]{0,63})?.

Includes only one of the fields log_group_id, folder_id.

Entry destination.

Field

Description

type

string

Resource type, i.e., serverless.function

The maximum string length in characters is 63.

id

string

Resource ID, i.e., ID of the function producing logs.

The maximum string length in characters is 63.

Field

Description

timestamp

google.protobuf.Timestamp

Required field. Timestamp of the entry.

level

enum Level

Entry severity.
See LogLevel.Level for details.

• TRACE: Trace log level.
  Possible use case: verbose logging of some business logic.
• DEBUG: Debug log level.
  Possible use case: debugging special cases in application logic.
• INFO: Info log level.
  Mostly used for information messages.
• WARN: Warn log level.
  May be used to alert about significant events.
• ERROR: Error log level.
  May be used to alert about errors in infrastructure, logic, etc.
• FATAL: Fatal log level.
  May be used to alert about unrecoverable failures and events.

message

string

Entry text message.

json_payload

google.protobuf.Struct

Entry annotation.

stream_name

string

Entry stream name.

The maximum string length in characters is 71.

Field

Description

level

enum Level

Default entry severity.
Will be applied if entry level is unspecified.
See LogLevel.Level for details.

• TRACE: Trace log level.
  Possible use case: verbose logging of some business logic.
• DEBUG: Debug log level.
  Possible use case: debugging special cases in application logic.
• INFO: Info log level.
  Mostly used for information messages.
• WARN: Warn log level.
  May be used to alert about significant events.
• ERROR: Error log level.
  May be used to alert about errors in infrastructure, logic, etc.
• FATAL: Fatal log level.
  May be used to alert about unrecoverable failures and events.

json_payload

google.protobuf.Struct

Default entry annotation.
Will be merged with entry annotation.
Any conflict will be resolved in favor of entry own annotation.

stream_name

string

Entry stream name.

The maximum string length in characters is 71.

Field

Description

errors

object (map<int64, google.rpc.Status>)

The error result of the operation in case of failure or cancellation.