Managed Service for Greenplum® API, gRPC: ClusterService.ListLogs

Field

Description

cluster_id

string

Required field. ID of the Greenplum® cluster to request logs for.

To get the Greenplum® cluster ID, use a ClusterService.List request.

column_filter[]

string

Columns from log table to request.
If no columns are specified, entire log records are returned.

service_type

enum ServiceType

Type of the service to request logs about.

• SERVICE_TYPE_UNSPECIFIED: Type is not specified.
• GREENPLUM: Greenplum® activity logs.
• GREENPLUM_POOLER: Greenplum® pooler logs.
• GREENPLUM_PXF: Greenplum® PXF service logs.

from_time

google.protobuf.Timestamp

Start timestamp for the logs request.

to_time

google.protobuf.Timestamp

End timestamp for the logs request.

page_size

int64

The maximum number of results per page to return.

If the number of available results is larger than page_size, the service returns a ListClusterLogsResponse.next_page_token that can be used to get the next page of results in subsequent list requests.

page_token

string

Page token. To get the next page of results, set page_token to the ListClusterLogsResponse.next_page_token returned by the previous list request.

always_next_page_token

bool

The service always returns a ListClusterLogsResponse.next_page_token, even if the current page is empty.

filter

string

A filter expression that filters resources listed in the response.

The expression must specify:

1. A field name. Currently filtering can be applied to the [LogRecord.logs.message.hostname], [LogRecord.logs.message.error_severity] (for GREENPLUM service) and [LogRecord.logs.message.level] (for GREENPLUM_POOLER service) fields.

2. A conditional operator. Can be either = or != for single values, IN or NOT IN for lists of values.

3. A value. Must be 1-63 characters long and match the regular expression ^[a-z0-9.-]{1,61}$.

Examples of a filter:

• message.hostname='node1.db.cloud.yandex.net';
• message.error_severity IN ("ERROR", "FATAL", "PANIC") AND message.hostname = "node1.db.cloud.yandex.net".

Field

Description

logs[]

LogRecord

Requested log records.

next_page_token

string

This token allows you to get the next page of results for list requests.

If the number of results is larger than ListClusterLogsRequest.page_size, use the next_page_token as the value for the ListClusterLogsRequest.page_token query parameter in the next list request.

Each subsequent list request has its own next_page_token to continue paging through the results.

This value is interchangeable with the StreamLogRecord.next_record_token from StreamLogs method.

Field

Description

timestamp

google.protobuf.Timestamp

Time when the log was recorded.

message

object (map<string, string>)

Contents of the log record.