Skip to content

Add CP30 runbook: EKS Auto Mode component logging - #8550

Open
masrafp-moj wants to merge 1 commit into
mainfrom
cp30-auto-mode-logging-runbook
Open

masrafp-moj wants to merge 1 commit into
mainfrom
cp30-auto-mode-logging-runbook

Conversation

@masrafp-moj

Copy link
Copy Markdown
Contributor

What this adds

A customer-facing runbook page explaining the EKS Auto Mode component logging that runs on every CP30 cluster: what it captures, where the logs are, how to view them, and the one behaviour worth knowing (log types enable one at a time). Part of #8430.

Why

Auto Mode component logging (Karpenter, EBS CSI, Load Balancer Controller, VPC CNI) is enabled on all clusters but was undocumented for engineers. This gives them a single page answering "where are my Auto Mode logs and how do I read them", matching the runbook added for private cluster access.

Files

  • source/cp30/eks-auto-mode-logging.html.md.erb — new page
  • source/cp30/index.html.md.erb — linked from the CP30 index, next to the EKS Auto Mode page

What the page covers

  • The four log types and what each is useful for troubleshooting
  • Log group naming (/aws/vendedlogs/eks/cluster/<LOG_TYPE>/<cluster>) and 30-day retention
  • How to view logs (console and CLI)
  • How it works, grounded in the real Terraform (cluster/eks-cluster.tf and the gate script)
  • The "one update at a time" sequencing behaviour, explained gently
  • Cost, troubleshooting, and links to related pages

Notes for reviewers

  • S3 archive is marked "in progress", not live. The S3 delivery destination is in a separate open PR (#19252) and not yet on main, so the page flags it as coming rather than documenting it as deployed. The S3 section gets fleshed out once #19252 merges — this page is intentionally ahead of that.
  • Grounded in the merged code on main (eks-cluster.tf uses the EKS Auto Mode logging: sequence log type enablement reliably #8501 update gate; four log types at 30-day retention).
  • Please confirm it renders in the docs preview before merge — not previewed with the Middleman build locally.

Related

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant