Yandex Cloud
  • Services
  • Solutions
  • Why Yandex Cloud
  • Pricing
  • Documentation
  • Contact us
Get started
Language / Region
© 2022 Yandex.Cloud LLC
Yandex Cloud Logging
  • Getting started
  • Step-by-step instructions
    • All instructions
    • Adding records
    • Reading records
    • Managing log groups
      • Creating a log group
      • Managing rights to access log groups
      • Updating the record retention period
      • Getting a list of log groups
      • Monitoring
      • Deleting a log group
  • Practical guidelines
    • All tutorials
    • Transmitting the Managed Service for Kubernetes cluster logs to Cloud Logging
    • Transferring logs from a VM instance to Cloud Logging
    • Transferring logs from COI to Cloud Logging
  • Concepts
    • Log group
    • Filter expression language
    • Quotas and limits
  • Access management
  • Pricing policy
  • API reference
    • Authentication in the API
    • gRPC
      • Overview
      • LogGroupService
      • LogIngestionService
      • LogReadingService
      • OperationService
    • REST
      • Overview
      • LogGroup
        • Overview
        • create
        • delete
        • get
        • list
        • listAccessBindings
        • listOperations
        • listResources
        • setAccessBindings
        • stats
        • update
        • updateAccessBindings
  • Questions and answers
  1. API reference
  2. gRPC
  3. LogIngestionService

LogIngestionService

Written by
Yandex Cloud
  • Calls LogIngestionService
  • Write
    • WriteRequest
    • Destination
    • LogEntryResource
    • IncomingLogEntry
    • LogEntryDefaults
    • WriteResponse

A set of methods for writing to log groups. To make a request use ingester.logging.yandexcloud.net.

Call Description
Write Write log entries to specified destination.

Calls LogIngestionService

Write

Write log entries to specified destination.

rpc Write (WriteRequest) returns (WriteResponse)

WriteRequest

Field Description
destination Destination
Required. Log entries destination.
See Destination for details.
resource LogEntryResource
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.

Destination

Field Description
destination oneof: log_group_id or folder_id
Entry destination.
  log_group_id string
Entry should be written to log group resolved by ID. Value must match the regular expression ([a-zA-Z][-a-zA-Z0-9_.]{0,63})?.
  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})?.

LogEntryResource

Field Description
type string
Resource type, i.e., serverless.function Value must match the regular expression ([a-zA-Z][-a-zA-Z0-9_.]{0,63})?.
id string
Resource ID, i.e., ID of the function producing logs. Value must match the regular expression ([a-zA-Z0-9][-a-zA-Z0-9_.]{0,63})?.

IncomingLogEntry

Field Description
timestamp google.protobuf.Timestamp
Required. Timestamp of the entry.
level LogLevel.Level
Entry severity.
See LogLevel.Level for details.
message string
Entry text message.
json_payload google.protobuf.Struct
Entry annotation.
stream_name string
Entry stream name. Value must match the regular expression |[a-zA-Z][-a-zA-Z0-9_.]{0,63}.

LogEntryDefaults

Field Description
level LogLevel.Level
Default entry severity. Will be applied if entry level is unspecified.
See LogLevel.Level for details.
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. Value must match the regular expression |[a-zA-Z][-a-zA-Z0-9_.]{0,63}.

WriteResponse

Field Description
errors map<int64,google.rpc.Status>
Map<idx, status> of ingest failures.
If entry with idx N is absent, it was ingested successfully.

Was the article helpful?

Language / Region
© 2022 Yandex.Cloud LLC
In this article:
  • Calls LogIngestionService
  • Write
  • WriteRequest
  • Destination
  • LogEntryResource
  • IncomingLogEntry
  • LogEntryDefaults
  • WriteResponse