쿠버네티스 클러스터에서 어느 노드나 파드에 문제가 생겼는지 한 화면에서 살펴보려면 srelens를 사용할 수 있습니다. 공식 GitHub 릴리스에서 Windows x64 설치 파일을 무료로 받을 수 있으며, 0.16.0을 기준으로 설치와 첫 점검 순서를 설명합니다. 기존 클러스터 접속 설정인 kubeconfig가 있어야 실제 상태를 볼 수 있습니다.
srelens는 클러스터를 새로 만드는 프로그램이 아닙니다. 이미 접속할 수 있는 Kubernetes 환경과 권한을 이용해 Overview에서 상태를 읽고, 문제가 보이는 파드의 상세 정보와 로그로 이어지는 도구입니다. 이 글에서는 화면의 숫자를 보기만 하고 끝내지 않고, 준비되지 않은 파드를 찾아 로그에서 원인을 좁히는 순서를 다룹니다.
srelens로 클러스터 상태를 읽는 방식
srelens는 데스크톱 GUI와 터미널 도구를 제공하는 무료 오픈소스 Kubernetes 클라이언트입니다. 이 글은 Windows 데스크톱 GUI를 기준으로 합니다. 공식 문서에 따르면 앱은 기본 kubeconfig와 KUBECONFIG 환경 변수에 지정된 파일을 읽습니다. 첫 실행 목록에서 접속할 context를 고르면 해당 클러스터의 상태를 볼 수 있습니다. 계정을 새로 만들거나 클러스터에 별도 프로그램을 설치할 필요는 없지만, 기존 자격 증명과 API 서버 연결은 정상이어야 합니다.
Overview에는 노드 준비 상태, 파드 수, 네임스페이스, CPU와 메모리 같은 요약이 모입니다. 공식 화면 예시처럼 Not ready 항목이 보이면 클러스터 전체가 막연히 고장 났다고 추측하기보다, 해당 작업과 파드 이름을 먼저 확인하는 편이 좋습니다. 오른쪽의 요약과 왼쪽의 탐색 목록을 함께 보면 어느 네임스페이스의 어떤 리소스를 살펴볼지 정할 수 있습니다.
Workloads 아래에서 Pods나 Deployments를 열어 범위를 네임스페이스로 좁힐 수 있습니다. 리소스를 선택하면 Overview, YAML, Events와 재시작 횟수 등을 볼 수 있고, 로그 화면으로 이동해 실제 출력도 살필 수 있습니다. 다만 보이는 항목과 수행할 수 있는 작업은 클러스터의 RBAC 권한, 메트릭 서버 제공 여부, 접속 상태에 따라 달라집니다. 상태 조회만 필요하다면 먼저 읽기 권한으로 시작하세요.
srelens 공식 GUI에서 보는 클러스터·로그·파드 상세 화면
첫 화면은 노드와 파드 상태가 한눈에 보이는 Overview입니다. 다음 화면은 연결 오류가 표시된 로그, 마지막 화면은 파드의 준비 상태와 재시작 횟수를 보여 줍니다. 세 화면은 공식 저장소의 데모 클러스터 예시이며 실제 운영 환경의 수치가 아닙니다.
| 프로그램 | srelens |
| 개발 | srelens 오픈소스 프로젝트 |
| 확인 버전 | 0.16.0 |
| 선택 파일 | srelens_0.16.0_x64-setup.exe |
| 가격 | 무료 · MIT 라이선스 |
| 지원 환경 | Windows 10 이상 x64 · macOS · Linux |
Windows에서 무료 설치 파일을 고르고 첫 실행하기
공식 v0.16.0 릴리스에는 Windows x64용 setup.exe와 MSI가 따로 있습니다. 일반적인 설치 과정을 원한다면 srelens_0.16.0_x64-setup.exe를 선택하세요. Windows 10 이상 x64가 공식 다운로드 페이지의 지원 범위입니다. ARM 기기나 다른 운영체제라면 이 Windows 파일을 그대로 사용하지 말고 해당 플랫폼의 배포 파일을 확인해야 합니다.
파일 이름과 릴리스 페이지의 발행자를 확인한 뒤 Windows의 설치 안내를 따릅니다. 운영체제의 첫 실행 확인 창이 나타날 수 있으므로 출처가 공식 GitHub 릴리스인지 다시 살펴보세요. 설치한 앱을 시작 메뉴에서 열고 첫 실행 목록이 나타나는지 확인합니다. 목록이 비었다면 앱을 다시 받기 전에 로컬 kubeconfig의 존재와 KUBECONFIG 설정을 확인하는 것이 순서입니다.
공식 다운로드 페이지에는 여러 운영체제의 파일이 섞여 있고, 웹페이지의 버전 소개 문구가 현재 GitHub 릴리스보다 오래될 수 있습니다. 이 글은 버전을 GitHub의 실제 0.16.0 릴리스와 파일명으로 확인했습니다. 다른 버전을 받았다면 화면과 메뉴가 달라질 수 있으니, 사용 중인 앱의 버전을 먼저 확인하세요. 설치 파일을 받는 비용은 없지만 접속할 Kubernetes 클러스터가 자동으로 제공되지는 않습니다.
- 공식 srelens-v0.16.0 릴리스에서 Windows x64 setup.exe 파일을 확인합니다.
- 설치 후 srelens를 열고 기존 kubeconfig의 context 목록이 표시되는지 봅니다.
- 접속할 context를 선택한 다음 Overview가 열리는지 확인합니다.
준비되지 않은 파드를 찾아 로그까지 확인하기
먼저 첫 실행 목록에서 조사할 클러스터의 context를 선택하세요. 비슷한 이름이 여러 개라면 로컬 개발용인지 원격 운영용인지 구분해야 합니다. 공식 문서는 Settings → Contexts에서 kubeconfig 소스와 표시 이름을 관리할 수 있다고 안내합니다. 화면 위쪽과 상태 표시줄에 선택한 클러스터가 맞는지 확인한 다음 Overview를 엽니다.
Overview에서 Nodes와 Pods의 준비 상태를 살펴보세요. 화면에 Not ready 목록이 나타나면 그 안의 작업 이름과 네임스페이스를 적어 둡니다. Workloads → Pods로 이동해 같은 네임스페이스로 범위를 좁히고 해당 파드를 선택합니다. 파드 상세 화면의 Overview에서는 준비 상태, 재시작 횟수, 노드, 컨테이너 상태를 차례로 봅니다. 숫자 하나만으로 원인을 단정하지 말고 Events와 상태 변화도 함께 확인하세요.
파드 상세 화면의 Logs를 열어 오류가 발생한 시점의 메시지를 읽습니다. 공식 데모에서는 데이터베이스 연결 거부 메시지가 나오지만, 실제 환경에서는 이미지 가져오기 실패나 권한 문제처럼 다른 이유가 보일 수 있습니다. 필요한 경우 이전 컨테이너 실행의 로그를 보는 Previous instance 기능을 사용하고, 여러 줄이 많다면 화면의 필터와 시간 범위를 조정하세요. 로그를 확인하면 어떤 리소스와 메시지를 운영자에게 전달할지 정리할 수 있습니다.
Events와 Logs는 같은 내용을 다른 이름으로 보여 주는 메뉴가 아닙니다. Events에서는 파드가 배치되고 시작되는 과정에 어떤 경고가 기록됐는지 살피고, Logs에서는 컨테이너가 실제로 출력한 메시지를 읽습니다. 예를 들어 파드가 아예 시작되지 않았다면 앱 로그가 비어 있을 수 있으므로 Events와 상태부터 확인하세요. 반대로 파드가 시작됐다가 반복해서 종료된다면 현재 로그만 보지 말고 Previous instance에서 직전 실행의 마지막 메시지를 확인하는 편이 원인을 찾는 데 도움이 됩니다. 화면에서 확인한 시각과 파드 이름을 함께 적어 두면 같은 네임스페이스에 파드가 여러 개 있을 때 기록을 섞지 않을 수 있습니다.
이 과정은 상태를 읽는 작업으로 마칠 수 있습니다. srelens에는 Edit, Drain 같은 변경 기능도 있으나 조회 중에 시험 삼아 누르지 마세요. 실제 설정 변경은 대상 클러스터와 권한, 영향 범위를 확인한 뒤 진행해야 합니다. 공식 문서는 변경 전에 dry-run diff와 확인 절차를 제공한다고 설명합니다. 처음에는 문제 파드의 이름, 네임스페이스, 재시작 횟수와 로그 몇 줄을 확보하는 것을 결과로 삼으세요.
- 첫 실행에서 올바른 context를 선택하고 Overview의 Not ready 항목을 찾습니다.
- Workloads → Pods에서 네임스페이스와 파드를 선택해 상세 상태를 봅니다.
- Logs와 Events를 확인해 실제 오류 메시지와 발생 시점을 기록합니다.
접속이 안 되거나 숫자가 비어 있을 때
context가 목록에 없다면 먼저 kubeconfig 파일이 현재 Windows 계정의 기본 위치에 있는지, 별도 파일을 쓴다면 KUBECONFIG에 지정됐는지 확인하세요. srelens의 Settings → Contexts에서는 파일을 추가하거나 YAML을 붙여 넣을 수도 있습니다. 다만 접속 정보를 다른 출처에서 임의로 내려받아 넣지 말고, 본인이 관리하는 클러스터의 설정만 사용하세요. context 이름이 중복되면 공식 문서처럼 소스 파일 표시를 보고 구분합니다.
클러스터가 보이는데 연결이 실패하면 API 서버에 닿는지와 인증에 필요한 외부 도구가 준비됐는지를 확인하세요. 공식 문서는 Toolbox의 context-health 화면에서 빠진 exec-auth 플러그인이나 클라우드 CLI를 확인할 수 있다고 설명합니다. 회사 네트워크나 VPN이 필요한 클러스터라면 연결 환경을 먼저 점검하고, 인증 오류가 있다면 관리자에게 발급받은 계정 권한을 확인해야 합니다.
노드와 파드는 보이지만 CPU·메모리 수치가 비어 있다면 프로그램 설치를 반복하기 전에 클러스터의 Metrics Server와 자신의 RBAC 접근 권한을 살펴보세요. 공식 도움말은 두 조건이 충족되지 않으면 메트릭이 보이지 않을 수 있다고 안내합니다. 로그를 열 수 없는 경우에도 해당 네임스페이스와 파드의 로그 조회 권한을 확인하는 편이 정확합니다. 상태 목록은 보이는데 메트릭만 비어 있다면 접속 전체가 실패했다고 단정하지 마세요. 조회 권한과 메트릭 제공 여부를 나눠 점검해야 담당자에게 필요한 요청을 정확히 전달할 수 있습니다.
예상치 못한 앱 오류가 반복되면 Settings → Application logs에서 관련 시각의 메시지를 찾아보세요. 오류를 공유할 때는 토큰, API 서버 주소, 서비스 내부 이름처럼 공개해서는 안 되는 정보를 먼저 가립니다. 재현 가능한 문제라면 공식 GitHub 이슈에 환경과 증상을 전달할 수 있습니다. 조회 화면의 예시와 실제 클러스터 상태를 구분하면 불필요한 설정 변경을 피하기 쉽습니다.
설치 전에 알아둘 파일과 기능의 차이
같은 릴리스에는 데스크톱 앱 외에 srectl, srelens-tui 같은 터미널용 묶음도 있습니다. Windows에서 마우스로 클러스터 화면을 보려는 목적이라면 이름에 srelens_0.16.0_x64-setup.exe가 적힌 데스크톱 설치 프로그램을 고르세요. 터미널용 ZIP을 받아 실행해도 이 글의 데스크톱 화면이 나타나는 것은 아닙니다. MSI는 관리자가 배포 방식에 맞게 선택할 수 있는 별도 Windows 설치 형식입니다.
0.16.0 릴리스 노트는 확장 앱 플랫폼 변경도 다룹니다. 이전 0.15.0에서 Flux나 Argo CD 확장을 쓰고 있었다면 구 API용 앱이 격리될 수 있으므로 업그레이드 안내를 먼저 읽어야 합니다. 처음 설치해 기본 클러스터 상태와 로그를 보는 독자라면 우선 기존 kubeconfig로 접속이 되는지 확인하세요. 확장 기능과 AI 연동은 기본적인 노드·파드 점검을 끝낸 뒤 필요한 경우에만 살펴보면 됩니다.
자주 묻는 질문
srelens는 무료인가요?
공식 사이트가 무료 오픈소스라고 안내하고 저장소는 MIT 라이선스입니다. Windows 설치 파일도 공개 릴리스에서 받을 수 있습니다.
로그인 계정을 새로 만들어야 하나요?
공식 문서는 별도 계정 없이 기존 kubeconfig의 자격 증명으로 Kubernetes API 서버에 접속한다고 설명합니다.
첫 실행에서 클러스터가 보이지 않으면 어떻게 하나요?
기본 kubeconfig 파일과 KUBECONFIG 설정을 확인하고, 필요한 경우 Settings → Contexts에서 자신이 관리하는 설정 파일을 추가하세요.
파드가 Not ready로 나오면 어디부터 보나요?
Overview에서 네임스페이스와 이름을 확인하고 Workloads → Pods의 상세 상태, Events, Logs를 차례로 살펴보세요.
CPU와 메모리 수치가 비어 있는 이유는 무엇인가요?
공식 도움말은 Metrics Server가 없거나 메트릭을 읽을 RBAC 권한이 부족한 경우를 점검하라고 안내합니다.
srelens에서 첫 클러스터 점검을 마치세요
Windows x64에서는 공식 0.16.0 설치 파일로 프로그램을 열고 기존 kubeconfig의 올바른 context를 선택합니다. Overview에서 준비되지 않은 파드를 찾은 뒤 Workloads → Pods의 상세 화면과 Logs로 이동하면 단순한 경고 숫자를 실제 오류 메시지와 연결할 수 있습니다.
문제가 보이면 변경 버튼을 바로 누르기보다 네임스페이스, 파드 이름, 재시작 횟수, 로그와 Events의 시각을 먼저 기록하세요. 클러스터 접속이나 메트릭이 막혀 있다면 설정 파일과 권한을 확인한 다음 같은 경로로 다시 점검하면 됩니다.
공식 자료와 확인일
srelens 공식 0.16.0 릴리스와 Windows 파일 · srelens 공식 설치·접속·작업 문서 · srelens 공식 무료 배포와 지원 환경 · srelens 공식 저장소와 이미지 | 2026-10-22T14:59:54.379951+00:00
