eks.clusters.logs

Control-plane logs: the Kubernetes audit log, API server, authenticator, controller manager, scheduler

GET /eks/api/clusters/{cluster}/logsIAM eks:GetClusterLogsRead

Kept 7 days. Only the types turned on in the cluster’s logging (audit by default; change it with `clusters update --logging`) are collected. The audit log leaves out reads by the cluster’s own components that succeeded; every write, every refusal and every request by a person or a workload is in it.

Request syntax

GET /eks/api/clusters/{cluster}/logs

Path parameters

  • clusterRequired

    string

    Constraints: /^(ewk-[0-9a-f]{12}|[a-z]([a-z0-9-]{0,38}[a-z0-9])?)$/

Query parameters

  • typeOptional

    enum

    Only this log type: api, audit, authenticator, controllerManager or scheduler. Default: every type

    One of: api, audit, authenticator, controllerManager, scheduler

  • sinceOptional

    string

    ISO time, inclusive. Default: one hour before `until`

  • untilOptional

    string

    ISO time, inclusive. Default: now

  • containsOptional

    string

    Only lines whose message contains this text, ignoring case; at most 200 characters

    Constraints: max 200 chars

  • limitOptional

    number

    At most this many lines, newest first, 1–1000; default 200

    Constraints: integer, 1-1000

Response

200 with { enabled (the log types collected now), retentionDays: 7, events (newest first: ts, type, machine, message) }. 404 when no cluster has that id or name, 403 without the permission on it (eks:GetClusterLogs).

A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.

Errors

  • 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
  • 401No credentials, or an access key that is unknown, revoked or expired.
  • 403The caller's policies do not allow eks:GetClusterLogs on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
  • 404The resource does not exist in your organization.

Examples

The required parameters only, with example values. Replace id and the other placeholders with your own.

dcloud eks clusters logs cluster

Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_eks_clusters_logs.