Contact UsGet started

Managed Service for Apache Kafka® API, REST: Cluster.ListLogs

Written by
Updated at December 17, 2024

Retrieves logs for the specified Apache Kafka® cluster.

For more information about logs, see the Logs section in the documentation.

HTTP request

GET https://mdb.api.cloud.yandex.net/managed-kafka/v1/clusters/{clusterId}:logs

Path parameters

Field

Description

clusterId

string

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

To get the Apache Kafka® cluster ID, make a ClusterService.List request.

Query parameters

Field

Description

columnFilter[]

string

Columns from the logs table to request.

If no columns are specified, full log records are returned.

fromTime

string (date-time)

Start timestamp for the logs request.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

toTime

string (date-time)

End timestamp for the logs request.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

pageSize

string (int64)

The maximum number of results per page to return.

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

pageToken

string

Page token.

To get the next page of results, set pageToken to the ListClusterLogsResponse.nextPageToken returned by the previous list request.

alwaysNextPageToken

boolean

The flag that defines behavior of providing the next page token.

If this flag is set to true, this API method will always return ListClusterLogsResponse.nextPageToken, even if current page is empty.

filter

string

A filter expression that filters resources listed in the response.

The expression must specify:

  1. The field name to filter by. Currently filtering can be applied to the hostname field.
  2. An = operator.
  3. The value in double quotes ("). Must be 1-63 characters long and match the regular expression [a-z0-9.-]{1,61}.

Example of a filter: message.hostname='node1.db.cloud.yandex.net'

Response

HTTP Code: 200 - OK

{
  "logs": [
    {
      "timestamp": "string",
      "message": "object"
    }
  ],
  "nextPageToken": "string"
}

Field

Description

logs[]

LogRecord

Requested log records.

nextPageToken

string

Token that allows you to get the next page of results for list requests.

If the number of results is larger than ListClusterLogsRequest.pageSize, use nextPageToken as the value for the ListClusterLogsRequest.pageToken query parameter in the next list request.
Each subsequent list request will have its own nextPageToken to continue paging through the results.
This value is interchangeable with StreamLogRecord.nextRecordToken from StreamLogs method.

LogRecord

A single log record.

Field

Description

timestamp

string (date-time)

Log record timestamp.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

message

object (map<string, string>)

Contents of the log record.
Previous
RescheduleMaintenance
Next
StreamLogs