콘텐츠로 이동

/logs

/logs 스킬은 AI 기반 로그 조회 도구입니다. 찾고 있는 내용을 설명하면 에이전트가 올바른 파드를 찾고, 적절한 기간을 선택하며, 가장 좋은 grep 필터를 사용하여 중요한 라인만 가져옵니다.

로그를 효율적으로 가져오기 위해 이 스킬은 에이전트에게 Kubetail 사용 방법을 가르칩니다. Kubetail은 각 노드에서 실행되는 Rust 기반 클러스터 에이전트(AI 에이전트가 아닌 클래식 K8s 에이전트)를 사용하여 로컬이 아닌 원격으로 필터링을 수행합니다. 이를 통해 기가바이트의 데이터를 먼저 전송하지 않고도 많은 파드와 긴 기간에 걸쳐 빠르게 검색하는 것이 실용적입니다.

스트림은 사용자와 에이전트가 동시에 연결된 tmux 창 내에서 실행됩니다. 에이전트는 창에서 읽어 질문에 답하며, 사용자는 실시간으로 스크롤, 검색하거나 라이브 테일을 계속 볼 수 있습니다.

/logs                                     # prompts for a target
/logs api                                 # recent logs from the api workload
/logs errors from the last hour on api    # natural-language scoping
/logs checkout for "timeout" in last 15m

자연어 범위 지정(네임스페이스, 레이블 셀렉터, 워크로드 이름, 기간, grep 패턴)이 지원됩니다(개요 참조). 에이전트는 설명을 적절한 Kubetail 쿼리로 변환합니다.

요구 사항

섹션 제목: “요구 사항”
  • tmux가 에이전트의 $PATH에서 사용 가능해야 합니다. 없으면 스킬이 실행되지 않습니다.
  • Kubetail이 클러스터에 설치되어 있어야 합니다. 설치되어 있지 않으면 스킬이 Kubetail의 Helm 차트를 사용하여 설치하도록 제안합니다 (수동 경로는 설치 가이드 참조).

에이전트가 로깅 세션을 여는 방법

섹션 제목: “에이전트가 로깅 세션을 여는 방법”

에이전트가 대상을 확인하고 Kubetail 쿼리를 구성한 후:

  1. 설명적인 이름(예: kstack-logs-api-server)으로 분리된 tmux 세션을 시작합니다.
  2. 데스크탑에서 새 터미널 창을 열고 해당 세션에 연결을 시도합니다 — 스트림이 바로 앞에 나타납니다.
  3. 채팅에 정확한 tmux attach 명령을 출력하여 어느 터미널에서도 수동으로 연결할 수 있습니다 (SSH, 원격 에디터, 또는 창 생성 실패 시 유용).
Session ready.
  Target: pod/api-5f9c-bnt4m (container: server)
  tmux:   tmux attach -t kstack-logs-api-server

사용자와 에이전트는 같은 창을 공유합니다. 에이전트는 토큰 절약을 위해 창에서 보수적으로 읽으므로 최신 출력을 따라잡도록 유도해야 할 수 있습니다. 에이전트에게 세션을 종료하도록 지시하면 기본 테일을 중단하고 tmux 세션을 종료합니다.

에이전트에게 전달되는 내용

섹션 제목: “에이전트에게 전달되는 내용”

스트림을 여는 것 외에도 스킬은 에이전트에게 어떻게 동작해야 하는지 안내합니다:

  • 사용자의 설명을 가장 좁게 실행 가능한 Kubetail 쿼리(특정 워크로드, 짧은 기간, 대상화된 grep)로 변환하고, 스트림이 시작되기 전에 사용자가 더 좁힐 수 있도록 확인된 쿼리를 표시합니다.
  • 토큰 절약을 위해 tmux 창에서 보수적으로 읽습니다; 프롬프트 없이 큰 버퍼를 재읽는 대신 사용자가 스크롤하도록 유도합니다.
  • 로그 내용을 잠재적으로 민감한 것으로 처리합니다 — 사용자가 명시적으로 요청하지 않는 한 토큰, 요청 본문, PII처럼 보이는 라인을 채팅에 다시 표시하지 않습니다.
  • 사용자가 로그에 대한 근본 원인 컨텍스트를 원하면 /investigate로, 로그 패턴이 리소스 급증과 상관관계가 있으면 /metrics로 전달합니다.
  • 사용자가 완료 신호를 보내면 테일을 중단하고 tmux 세션을 종료합니다.

옵션

섹션 제목: “옵션”
--attach
새 세션을 시작하는 대신 기존 kstack tmux 세션에 에이전트를 연결합니다.
--detach
분리된 상태로 새 세션을 시작합니다 — 터미널 창이 열리지 않으며 수동으로 연결합니다.

개요의 글로벌 플래그도 적용됩니다.