Связаться с намиПодключиться

Managed Service for MongoDB API, REST: Cluster.ListLogs

Статья создана
Обновлена 17 декабря 2024 г.

Retrieves logs for the specified MongoDB cluster.
See the Logs section in the developers guide for detailed logs description.

HTTP request

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

Path parameters

Field

Description

clusterId

string

Required field. ID of the MongoDB cluster to request logs for.
To get the MongoDB cluster ID use a ClusterService.List request.

Query parameters

Field

Description

columnFilter[]

string

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

serviceType

enum (ServiceType)

Type of the service to request logs about.

  • SERVICE_TYPE_UNSPECIFIED
  • MONGOD: Logs of MongoDB activity.
  • MONGOS
  • MONGOCFG
  • AUDIT: MongoDB Enterprise audit logs

fromTime

string (date-time)

Start timestamp for the logs request, in RFC3339 text format.

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, in RFC3339 text format.

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.
Acceptable values are 0 to 1000, inclusive. Default value: 100.

pageToken

string

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

Response

HTTP Code: 200 - OK

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

Field

Description

logs[]

LogRecord

Requested log records.

nextPageToken

string

This token allows you to get the next page of results for list requests. If the number of results
is larger than ListClusterLogsRequest.pageSize, use the 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 next_record_token from StreamLogs method.

LogRecord

Field

Description

timestamp

string (date-time)

Log record timestamp in RFC3339 text format.

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.
Предыдущая
RescheduleMaintenance
Следующая
StreamLogs