Managed Service for MySQL API, gRPC: ClusterService.StreamLogs

Field

Description

cluster_id

string

Required field. ID of the cluster to stream logs for.

To get this ID, make a ClusterService.List request.

column_filter[]

string

Columns from the logs table to request.
If no columns are specified, complete log records are returned.

service_type

enum ServiceType

The log type.

• SERVICE_TYPE_UNSPECIFIED
• MYSQL_ERROR: MySQL error log.
• MYSQL_GENERAL: MySQL general query log.
• MYSQL_SLOW_QUERY: MySQL slow query log.
• MYSQL_AUDIT: MySQL audit log.

from_time

google.protobuf.Timestamp

Start timestamp for the logs request.

to_time

google.protobuf.Timestamp

End timestamp for the logs request.
If this field is not set, all existing log records beginning from from_time will be returned first, and then the new records will be returned as they appear.

In essence it has tail -f command semantics.

record_token

string

Record token that can be used to control logs streaming.

Set record_token to the StreamLogRecord.next_record_token, returned by the previous ClusterService.StreamLogs request to start streaming from the next log record.

filter

string

A filter expression that selects clusters logs listed in the response.

The expression must specify:

1. The field name. Currently filtering can be applied to the [LogRecord.logs.hostname] field.
2. An = operator.
3. The value in double quotes ("). Must be 3-63 characters long and match the regular expression [a-z][-a-z0-9]{1,61}[a-z0-9].
   Examples of a filter: message.hostname='node1.db.cloud.yandex.net'

Field

Description

record

LogRecord

One of the requested log records.

next_record_token

string

The token that can be used to continue streaming logs starting from the exact same record.
To continue streaming, specify value of next_record_token as the StreamClusterLogsRequest.record_token value in the next ClusterService.StreamLogs request.

This value is interchangeable with ListClusterLogsResponse.next_page_token from ClusterService.ListLogs method.

Field

Description

timestamp

google.protobuf.Timestamp

Timestamp of the log record.

message

object (map<string, string>)

Contents of the log record.