InfoGrab DocsInfoGrab Docs

세션 녹화 검색

요약

세션 녹화 검색을 사용하면 세션 녹화의 요약과 세션 메타데이터를 검색하여 필요한 세션 녹화를 찾을 수 있습니다. 세션 녹화 검색은 원본 녹화 데이터가 아니라 세션 요약을 검색합니다. 이 가이드에서는 Teleport 세션 요약을 구성하고, 세션에서 요약을 생성한 다음, 세션 녹화 검색을 사용하여 생성한 요약을 찾습니다.

세션 녹화 검색을 사용하면 세션 녹화의 요약과 세션 메타데이터를 검색하여 필요한 세션 녹화를 찾을 수 있습니다. 자연어 설명, 정확한 키워드, 또는 사용자, 역할, 리소스, 라벨, 세션 종류, 시간 범위, 심각도 같은 필터로 검색할 수 있습니다.

세션 녹화 검색은 원본 녹화 데이터가 아니라 세션 요약을 검색합니다. Teleport가 해당 세션에 대해 세션 녹화 요약을 성공적으로 생성한 후에만 녹화가 검색 결과에 나타납니다.

이 가이드에서는 Teleport 세션 요약을 구성하고, 세션에서 요약을 생성한 다음, 세션 녹화 검색을 사용하여 생성한 요약을 찾습니다.

작동 방식#

세션 요약이 생성되면 Teleport는 요약과 관련 세션 메타데이터를 Identity Security에 인덱싱합니다. 또한 Teleport는 구성된 retrieval_model 리소스를 사용하여 요약 청크에 대한 벡터 임베딩을 생성합니다. 사용자가 검색을 실행하면 Teleport Auth Service가 검색 쿼리를 임베딩하고, Identity Security에서 일치하는 요약을 조회하고, Teleport RBAC 검사를 적용한 다음, 사용자가 볼 수 있도록 허용된 세션만 반환합니다.

기본 검색 모드는 키워드 검색과 벡터 유사도 검색을 결합한 하이브리드 검색입니다. 키워드 전용 또는 임베딩 전용 검색을 실행할 수도 있습니다.

AI and embeddings

세션 녹화 검색은 세션 요약 텍스트와 사용자 검색 쿼리를 retrieval_model 리소스에 구성된 임베딩 제공자에게 전송합니다. 세션 녹화 요약에 적용되는 것과 동일한 데이터 처리 및 제공자 관련 고려 사항을 검토하십시오.

사전 요구사항#

  • Identity Security가 활성화된 Teleport Enterprise 클러스터 v18.8.0 이상.
  • 세션 녹화 요약이 활성화되어 있고 요약이 성공적으로 생성되고 있어야 합니다.
  • 자체 호스팅 배포의 경우 Access Graph v1.30.0 이상.
  • 자체 호스팅 배포의 경우, 다음 확장을 사용할 수 있는 Access Graph용 PostgreSQL v14 이상 데이터베이스:
    • 키워드 검색에 필요한 pg_trgm.
    • 벡터 유사도 검색에 필요한 pgvector. PostgreSQL 확장 이름은 vector입니다.
  • 검색하려는 세션 녹화를 읽을 수 있는 권한. 검색 결과는 세션 녹화 및 요약에 사용되는 것과 동일한 session RBAC 규칙으로 필터링됩니다.
  • 세션 녹화를 생성하기 위해 Teleport에 연결된 SSH 노드, 쿠버네티스 클러스터 또는 PostgreSQL 데이터베이스 중 하나 이상.

Teleport cluster에 연결할 수 있는지 확인하려면 tsh login으로 로그인한 다음, 현재 자격 증명으로 tctl 명령을 실행할 수 있는지 확인합니다.

예를 들어, teleport.example.com에 cluster 내 Teleport Proxy Service의 도메인 이름을, email@example.com에 Teleport 사용자 이름을 지정하여 다음 명령을 실행합니다:

$ tsh login --proxy=teleport.example.com --user=email@example.com
$ tctl status
# Cluster  (=teleport.url=)
# Version  (=teleport.version=)
# CA pin   (=presets.ca_pin=)

cluster에 연결하여 tctl status 명령을 실행할 수 있다면, 현재 자격 증명을 사용하여 워크스테이션에서 이후의 tctl 명령을 실행할 수 있습니다. 자체 Teleport cluster를 호스팅하는 경우, 전체 권한을 얻기 위해 Teleport Auth Service를 호스팅하는 컴퓨터에서 tctl 명령을 실행할 수도 있습니다.

Teleport Enterprise Cloud는 Access Graph와 그 백엔드 데이터베이스를 관리합니다. 자체 호스팅 클러스터의 경우 Docker 또는 Helm Access Graph 배포 가이드를 따르고 Access Graph v1.30.0 이상을 실행하십시오.

Access Graph는 필요한 PostgreSQL 확장을 자동으로 활성화하고 관리하므로 CREATE EXTENSION을 직접 실행할 필요가 없습니다.

1/3단계. 검색 모델 구성#

retrieval_model 리소스는 retrieval-model이라는 이름의 클러스터 전체 싱글톤입니다. 이 리소스는 세션 녹화 검색에 사용할 임베딩 제공자와, 자연어 검색 쿼리를 API 요청으로 변환하고 세션 요약에서 산문을 생성하는 데 사용할 추론 모델을 Teleport에 알려 줍니다.

사전 설정된 editor 역할은 retrieval_model 리소스를 관리할 수 있습니다. 사용자 지정 관리 역할을 사용하는 경우 retrieval_model에 대해 read, list, create, update, delete 권한을 부여하십시오.

예를 들어 다음 내용으로 session-search-admin.yaml 파일을 생성합니다.

kind: role
metadata:
  name: session-search-admin
spec:
  allow:
    rules:
    - resources: [retrieval_model]
      verbs: [read, list, create, update, delete]
version: v7

세션 녹화 검색에는 임베딩 제공자와 추론 모델이 모두 필요합니다. 임베딩 제공자는 세션 요약과 검색 쿼리를 의미 기반 매칭을 위한 벡터로 변환합니다. inference_model_name 필드는 Teleport가 자연어 검색 쿼리를 API 요청으로 변환하고 세션 요약에서 산문을 생성하는 데 사용하는 기존 inference_model 리소스를 가리킵니다. 대부분의 배포에서는 세션 녹화 요약에 이미 구성한 추론 모델을 그대로 사용할 수 있습니다.

사용하려는 임베딩 제공자에 맞는 탭을 선택하십시오.

OpenAI 또는 OpenAI 호환 API 키가 들어 있는 기존 inference_secret을 재사용할 수 있습니다. 다음 예시는 세션 녹화 요약 설정의 openai-key 시크릿과 shell-summary-model 추론 모델을 사용합니다.

세션 녹화 검색은 OpenAI 임베딩 모델 text-embedding-3-large와 text-embedding-3-small을 지원합니다.

kind: retrieval_model
version: v1
metadata:
  name: retrieval-model
spec:
  openai:
    openai_model_id: text-embedding-3-large
    api_key_secret_ref: openai-key
  inference_model_name: shell-summary-model

다음 예시는 Amazon Titan Text Embeddings를 사용합니다. 리전은 AWS 계정에서 사용할 수 있는 리전으로 바꾸십시오. 세션 녹화 검색은 Bedrock 임베딩 모델 amazon.titan-embed-text-v2:0만 지원합니다.

kind: retrieval_model
version: v1
metadata:
  name: retrieval-model
spec:
  bedrock:
    region: us-east-1
    bedrock_model_id: amazon.titan-embed-text-v2:0
  inference_model_name: shell-summary-model

구성을 retrieval-model.yaml로 저장한 다음 적용합니다.

$ tctl create -f retrieval-model.yaml

인프라 코드(IaC) 워크플로는 teleport_retrieval_model Terraform 리소스 또는 TeleportRetrievalModelV1 쿠버네티스 오퍼레이터 리소스를 참조하십시오.

2/3단계. 검색 가능한 요약 생성#

세션 요약 추론 정책 중 하나와 일치하는 새 SSH, 쿠버네티스 또는 데이터베이스 세션을 수행합니다. 세션이 끝난 후 Teleport가 요약을 생성할 때까지 기다립니다. 성공적으로 생성된 새 요약은 세션 녹화 검색을 위해 인덱싱됩니다.

tsh로 리소스에 연결하는 방법을 보려면 리소스 유형을 선택하십시오.

tsh ssh 명령을 실행하여 서버에 연결하고, 연결하려는 서버에서 사용할 로그인을 지정합니다. 다음 명령은 사용자 root로 서버 mynode에 연결합니다.

$ tsh ssh root@mynode

Teleport 웹 UI의 Resources 탭으로 이동하여 SSH 서버를 선택해서 서버에 연결할 수도 있습니다.

Teleport에 연결된 쿠버네티스 클러스터에 접근하려면 다음 명령을 실행하여 Teleport가 서명한 인증서로 kubeconfig를 업데이트합니다. 다음 명령은 mycluster 클러스터에 로그인합니다.

$ tsh kube login mycluster

클러스터에 로그인한 후 tsh kubectl을 실행하여 kubectl 명령을 실행합니다. Teleport는 특정 쿠버네티스 클러스터 리소스에 대한 접근을 허용하거나 거부할 수 있습니다. tsh kubectl은 권한 부족으로 명령이 실패했는지 감지하고, 실패한 경우 대상 쿠버네티스 리소스에 대한 접근 요청을 제출합니다.

예를 들어 다음 명령은 my-pod Pod에서 sh 명령으로 인터랙티브 세션을 생성합니다.

$ kubectl exec -it my-pod -- sh

Teleport 웹 UI의 Resources 탭으로 이동하여 쿠버네티스 클러스터를 선택해서 쿠버네티스 리소스에 연결할 수도 있습니다.

PostgreSQL 데이터베이스에 연결하고 세션 녹화를 생성하려면 Teleport 웹 UI를 사용합니다. Resources 탭으로 이동하여 PostgreSQL 데이터베이스를 선택하고 인터랙티브 세션을 시작합니다.

3/3단계. 녹화 검색#

tctl recordings search를 사용하여 요약된 녹화를 검색합니다. 기본적으로 이 명령은 최근 24시간을 검색하고 인터랙티브 터미널 UI를 엽니다.

$ tctl recordings search "SSH sessions downloading archives from production"

필터를 사용하여 검색합니다.

$ tctl recordings search \
    --from=2026-05-01 \
    --to=2026-05-04 \
    --kind=ssh \
    --username=alice \
    --label=env=prod \
    --severity=high \
    "external endpoint"

자동화에는 JSON 또는 YAML 출력을 사용합니다.

$ tctl recordings search --format=json --limit=25 "DROP TABLE"

검색 모드를 선택합니다.

$ tctl recordings search --search-mode=keyword "rm -rf"
$ tctl recordings search --search-mode=embeddings "credential harvesting"

지원되는 검색 모드는 다음과 같습니다.

모드 설명
hybrid 기본값입니다. 키워드 검색과 벡터 유사도 검색을 결합합니다.
keyword 키워드 매칭만 사용합니다.
embeddings 벡터 유사도 검색만 사용합니다.

일반적인 필터는 다음과 같습니다.

플래그 설명
--from, --to YYYY-MM-DD 형식의 검색 시간 범위입니다.
--kind ssh, k8s, db 같은 세션 종류입니다. 반복해서 지정할 수 있습니다.
--username 세션을 시작한 Teleport 사용자입니다.
--role 세션 중 사용자가 보유한 역할입니다. 반복해서 지정할 수 있습니다.
--access-request 세션과 연관된 접근 요청 ID입니다. 반복해서 지정할 수 있습니다.
--resource-kind node, kube_cluster, db 같은 Teleport 리소스 종류입니다.
--resource-name 접근한 리소스의 이름입니다.
--label key=value 형식의 리소스 라벨입니다.
--severity 최소 요약 심각도입니다. low, medium, high, critical 중 하나입니다.

다음 단계#

AI 에이전트와 함께 세션 녹화 검색 사용#

AI 에이전트가 이 명령을 실행하도록 하려면 해당 Agent Skill을 설치합니다.

$ npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-session-review

문제 해결#

Session Recording Search requires Access Graph to be enabled with session recording support#

클러스터가 Access Graph에 연결되어 있는지 확인하고, 자체 호스팅 배포에서는 Access Graph v1.30.0 이상을 실행하고 있는지 확인하십시오.

PostgreSQL 확장 사용 가능 여부 확인#

Access Graph가 사용하는 PostgreSQL 데이터베이스에 연결하여 pg_available_extensions를 조회합니다.

SELECT name, default_version, installed_version
FROM pg_available_extensions
WHERE name IN ('pg_trgm', 'vector')
ORDER BY name;

pg_trgm은 pg_trgm으로 표시되어야 합니다. pgvector는 PostgreSQL 확장 이름인 vector로 표시되어야 합니다. 행이 없으면 해당 확장을 PostgreSQL 인스턴스에서 사용할 수 없다는 뜻입니다. installed_version이 비어 있으면 확장은 사용할 수 있지만 현재 데이터베이스에서 아직 활성화되지 않은 것입니다. Access Graph는 데이터베이스를 초기화할 때 필요한 확장을 자동으로 활성화합니다.

Session Recording Search requires the pg_trgm PostgreSQL extension#

Access Graph 데이터베이스에서 pg_trgm을 사용할 수 있는 PostgreSQL 인스턴스를 사용하십시오. Access Graph가 해당 확장을 자동으로 활성화합니다.

Session Recording Search requires the pgvector PostgreSQL extension#

Access Graph 데이터베이스에서 pgvector를 사용할 수 있는 PostgreSQL 인스턴스를 사용하십시오. Access Graph가 vector 확장을 자동으로 활성화합니다.

세션을 찾을 수 없음#

검색 시간 범위에 해당 세션이 포함되어 있는지, 세션에 성공적으로 생성된 요약이 있는지, Teleport 역할이 해당 녹화를 읽도록 허용하는지 확인하십시오. 세션 녹화 검색은 요약되지 않은 녹화를 반환하지 않습니다.

세션 녹화 검색

Teleport v18.11
원문 보기

요약

세션 녹화 검색을 사용하면 세션 녹화의 요약과 세션 메타데이터를 검색하여 필요한 세션 녹화를 찾을 수 있습니다. 세션 녹화 검색은 원본 녹화 데이터가 아니라 세션 요약을 검색합니다. 이 가이드에서는 Teleport 세션 요약을 구성하고, 세션에서 요약을 생성한 다음, 세션 녹화 검색을 사용하여 생성한 요약을 찾습니다.

세션 녹화 검색을 사용하면 세션 녹화의 요약과 세션 메타데이터를 검색하여 필요한 세션 녹화를 찾을 수 있습니다. 자연어 설명, 정확한 키워드, 또는 사용자, 역할, 리소스, 라벨, 세션 종류, 시간 범위, 심각도 같은 필터로 검색할 수 있습니다.

세션 녹화 검색은 원본 녹화 데이터가 아니라 세션 요약을 검색합니다. Teleport가 해당 세션에 대해 세션 녹화 요약을 성공적으로 생성한 후에만 녹화가 검색 결과에 나타납니다.

이 가이드에서는 Teleport 세션 요약을 구성하고, 세션에서 요약을 생성한 다음, 세션 녹화 검색을 사용하여 생성한 요약을 찾습니다.

작동 방식#

세션 요약이 생성되면 Teleport는 요약과 관련 세션 메타데이터를 Identity Security에 인덱싱합니다. 또한 Teleport는 구성된 retrieval_model 리소스를 사용하여 요약 청크에 대한 벡터 임베딩을 생성합니다. 사용자가 검색을 실행하면 Teleport Auth Service가 검색 쿼리를 임베딩하고, Identity Security에서 일치하는 요약을 조회하고, Teleport RBAC 검사를 적용한 다음, 사용자가 볼 수 있도록 허용된 세션만 반환합니다.

기본 검색 모드는 키워드 검색과 벡터 유사도 검색을 결합한 하이브리드 검색입니다. 키워드 전용 또는 임베딩 전용 검색을 실행할 수도 있습니다.

AI and embeddings

세션 녹화 검색은 세션 요약 텍스트와 사용자 검색 쿼리를 retrieval_model 리소스에 구성된 임베딩 제공자에게 전송합니다. 세션 녹화 요약에 적용되는 것과 동일한 데이터 처리 및 제공자 관련 고려 사항을 검토하십시오.

사전 요구사항#

  • Identity Security가 활성화된 Teleport Enterprise 클러스터 v18.8.0 이상.
  • 세션 녹화 요약이 활성화되어 있고 요약이 성공적으로 생성되고 있어야 합니다.
  • 자체 호스팅 배포의 경우 Access Graph v1.30.0 이상.
  • 자체 호스팅 배포의 경우, 다음 확장을 사용할 수 있는 Access Graph용 PostgreSQL v14 이상 데이터베이스:
    • 키워드 검색에 필요한 pg_trgm.
    • 벡터 유사도 검색에 필요한 pgvector. PostgreSQL 확장 이름은 vector입니다.
  • 검색하려는 세션 녹화를 읽을 수 있는 권한. 검색 결과는 세션 녹화 및 요약에 사용되는 것과 동일한 session RBAC 규칙으로 필터링됩니다.
  • 세션 녹화를 생성하기 위해 Teleport에 연결된 SSH 노드, 쿠버네티스 클러스터 또는 PostgreSQL 데이터베이스 중 하나 이상.

Teleport cluster에 연결할 수 있는지 확인하려면 tsh login으로 로그인한 다음, 현재 자격 증명으로 tctl 명령을 실행할 수 있는지 확인합니다.

예를 들어, teleport.example.com에 cluster 내 Teleport Proxy Service의 도메인 이름을, email@example.com에 Teleport 사용자 이름을 지정하여 다음 명령을 실행합니다:

$ tsh login --proxy=teleport.example.com --user=email@example.com
$ tctl status
# Cluster  (=teleport.url=)
# Version  (=teleport.version=)
# CA pin   (=presets.ca_pin=)

cluster에 연결하여 tctl status 명령을 실행할 수 있다면, 현재 자격 증명을 사용하여 워크스테이션에서 이후의 tctl 명령을 실행할 수 있습니다. 자체 Teleport cluster를 호스팅하는 경우, 전체 권한을 얻기 위해 Teleport Auth Service를 호스팅하는 컴퓨터에서 tctl 명령을 실행할 수도 있습니다.

Teleport Enterprise Cloud는 Access Graph와 그 백엔드 데이터베이스를 관리합니다. 자체 호스팅 클러스터의 경우 Docker 또는 Helm Access Graph 배포 가이드를 따르고 Access Graph v1.30.0 이상을 실행하십시오.

Access Graph는 필요한 PostgreSQL 확장을 자동으로 활성화하고 관리하므로 CREATE EXTENSION을 직접 실행할 필요가 없습니다.

1/3단계. 검색 모델 구성#

retrieval_model 리소스는 retrieval-model이라는 이름의 클러스터 전체 싱글톤입니다. 이 리소스는 세션 녹화 검색에 사용할 임베딩 제공자와, 자연어 검색 쿼리를 API 요청으로 변환하고 세션 요약에서 산문을 생성하는 데 사용할 추론 모델을 Teleport에 알려 줍니다.

사전 설정된 editor 역할은 retrieval_model 리소스를 관리할 수 있습니다. 사용자 지정 관리 역할을 사용하는 경우 retrieval_model에 대해 read, list, create, update, delete 권한을 부여하십시오.

예를 들어 다음 내용으로 session-search-admin.yaml 파일을 생성합니다.

kind: role
metadata:
  name: session-search-admin
spec:
  allow:
    rules:
    - resources: [retrieval_model]
      verbs: [read, list, create, update, delete]
version: v7

세션 녹화 검색에는 임베딩 제공자와 추론 모델이 모두 필요합니다. 임베딩 제공자는 세션 요약과 검색 쿼리를 의미 기반 매칭을 위한 벡터로 변환합니다. inference_model_name 필드는 Teleport가 자연어 검색 쿼리를 API 요청으로 변환하고 세션 요약에서 산문을 생성하는 데 사용하는 기존 inference_model 리소스를 가리킵니다. 대부분의 배포에서는 세션 녹화 요약에 이미 구성한 추론 모델을 그대로 사용할 수 있습니다.

사용하려는 임베딩 제공자에 맞는 탭을 선택하십시오.

OpenAI 또는 OpenAI 호환 API 키가 들어 있는 기존 inference_secret을 재사용할 수 있습니다. 다음 예시는 세션 녹화 요약 설정의 openai-key 시크릿과 shell-summary-model 추론 모델을 사용합니다.

세션 녹화 검색은 OpenAI 임베딩 모델 text-embedding-3-large와 text-embedding-3-small을 지원합니다.

kind: retrieval_model
version: v1
metadata:
  name: retrieval-model
spec:
  openai:
    openai_model_id: text-embedding-3-large
    api_key_secret_ref: openai-key
  inference_model_name: shell-summary-model

다음 예시는 Amazon Titan Text Embeddings를 사용합니다. 리전은 AWS 계정에서 사용할 수 있는 리전으로 바꾸십시오. 세션 녹화 검색은 Bedrock 임베딩 모델 amazon.titan-embed-text-v2:0만 지원합니다.

kind: retrieval_model
version: v1
metadata:
  name: retrieval-model
spec:
  bedrock:
    region: us-east-1
    bedrock_model_id: amazon.titan-embed-text-v2:0
  inference_model_name: shell-summary-model

구성을 retrieval-model.yaml로 저장한 다음 적용합니다.

$ tctl create -f retrieval-model.yaml

인프라 코드(IaC) 워크플로는 teleport_retrieval_model Terraform 리소스 또는 TeleportRetrievalModelV1 쿠버네티스 오퍼레이터 리소스를 참조하십시오.

2/3단계. 검색 가능한 요약 생성#

세션 요약 추론 정책 중 하나와 일치하는 새 SSH, 쿠버네티스 또는 데이터베이스 세션을 수행합니다. 세션이 끝난 후 Teleport가 요약을 생성할 때까지 기다립니다. 성공적으로 생성된 새 요약은 세션 녹화 검색을 위해 인덱싱됩니다.

tsh로 리소스에 연결하는 방법을 보려면 리소스 유형을 선택하십시오.

tsh ssh 명령을 실행하여 서버에 연결하고, 연결하려는 서버에서 사용할 로그인을 지정합니다. 다음 명령은 사용자 root로 서버 mynode에 연결합니다.

$ tsh ssh root@mynode

Teleport 웹 UI의 Resources 탭으로 이동하여 SSH 서버를 선택해서 서버에 연결할 수도 있습니다.

Teleport에 연결된 쿠버네티스 클러스터에 접근하려면 다음 명령을 실행하여 Teleport가 서명한 인증서로 kubeconfig를 업데이트합니다. 다음 명령은 mycluster 클러스터에 로그인합니다.

$ tsh kube login mycluster

클러스터에 로그인한 후 tsh kubectl을 실행하여 kubectl 명령을 실행합니다. Teleport는 특정 쿠버네티스 클러스터 리소스에 대한 접근을 허용하거나 거부할 수 있습니다. tsh kubectl은 권한 부족으로 명령이 실패했는지 감지하고, 실패한 경우 대상 쿠버네티스 리소스에 대한 접근 요청을 제출합니다.

예를 들어 다음 명령은 my-pod Pod에서 sh 명령으로 인터랙티브 세션을 생성합니다.

$ kubectl exec -it my-pod -- sh

Teleport 웹 UI의 Resources 탭으로 이동하여 쿠버네티스 클러스터를 선택해서 쿠버네티스 리소스에 연결할 수도 있습니다.

PostgreSQL 데이터베이스에 연결하고 세션 녹화를 생성하려면 Teleport 웹 UI를 사용합니다. Resources 탭으로 이동하여 PostgreSQL 데이터베이스를 선택하고 인터랙티브 세션을 시작합니다.

3/3단계. 녹화 검색#

tctl recordings search를 사용하여 요약된 녹화를 검색합니다. 기본적으로 이 명령은 최근 24시간을 검색하고 인터랙티브 터미널 UI를 엽니다.

$ tctl recordings search "SSH sessions downloading archives from production"

필터를 사용하여 검색합니다.

$ tctl recordings search \
    --from=2026-05-01 \
    --to=2026-05-04 \
    --kind=ssh \
    --username=alice \
    --label=env=prod \
    --severity=high \
    "external endpoint"

자동화에는 JSON 또는 YAML 출력을 사용합니다.

$ tctl recordings search --format=json --limit=25 "DROP TABLE"

검색 모드를 선택합니다.

$ tctl recordings search --search-mode=keyword "rm -rf"
$ tctl recordings search --search-mode=embeddings "credential harvesting"

지원되는 검색 모드는 다음과 같습니다.

모드 설명
hybrid 기본값입니다. 키워드 검색과 벡터 유사도 검색을 결합합니다.
keyword 키워드 매칭만 사용합니다.
embeddings 벡터 유사도 검색만 사용합니다.

일반적인 필터는 다음과 같습니다.

플래그 설명
--from, --to YYYY-MM-DD 형식의 검색 시간 범위입니다.
--kind ssh, k8s, db 같은 세션 종류입니다. 반복해서 지정할 수 있습니다.
--username 세션을 시작한 Teleport 사용자입니다.
--role 세션 중 사용자가 보유한 역할입니다. 반복해서 지정할 수 있습니다.
--access-request 세션과 연관된 접근 요청 ID입니다. 반복해서 지정할 수 있습니다.
--resource-kind node, kube_cluster, db 같은 Teleport 리소스 종류입니다.
--resource-name 접근한 리소스의 이름입니다.
--label key=value 형식의 리소스 라벨입니다.
--severity 최소 요약 심각도입니다. low, medium, high, critical 중 하나입니다.

다음 단계#

AI 에이전트와 함께 세션 녹화 검색 사용#

AI 에이전트가 이 명령을 실행하도록 하려면 해당 Agent Skill을 설치합니다.

$ npx skills add https://github.com/gravitational/teleport/tree/master/skills/teleport-session-review

문제 해결#

Session Recording Search requires Access Graph to be enabled with session recording support#

클러스터가 Access Graph에 연결되어 있는지 확인하고, 자체 호스팅 배포에서는 Access Graph v1.30.0 이상을 실행하고 있는지 확인하십시오.

PostgreSQL 확장 사용 가능 여부 확인#

Access Graph가 사용하는 PostgreSQL 데이터베이스에 연결하여 pg_available_extensions를 조회합니다.

SELECT name, default_version, installed_version
FROM pg_available_extensions
WHERE name IN ('pg_trgm', 'vector')
ORDER BY name;

pg_trgm은 pg_trgm으로 표시되어야 합니다. pgvector는 PostgreSQL 확장 이름인 vector로 표시되어야 합니다. 행이 없으면 해당 확장을 PostgreSQL 인스턴스에서 사용할 수 없다는 뜻입니다. installed_version이 비어 있으면 확장은 사용할 수 있지만 현재 데이터베이스에서 아직 활성화되지 않은 것입니다. Access Graph는 데이터베이스를 초기화할 때 필요한 확장을 자동으로 활성화합니다.

Session Recording Search requires the pg_trgm PostgreSQL extension#

Access Graph 데이터베이스에서 pg_trgm을 사용할 수 있는 PostgreSQL 인스턴스를 사용하십시오. Access Graph가 해당 확장을 자동으로 활성화합니다.

Session Recording Search requires the pgvector PostgreSQL extension#

Access Graph 데이터베이스에서 pgvector를 사용할 수 있는 PostgreSQL 인스턴스를 사용하십시오. Access Graph가 vector 확장을 자동으로 활성화합니다.

세션을 찾을 수 없음#

검색 시간 범위에 해당 세션이 포함되어 있는지, 세션에 성공적으로 생성된 요약이 있는지, Teleport 역할이 해당 녹화를 읽도록 허용하는지 확인하십시오. 세션 녹화 검색은 요약되지 않은 녹화를 반환하지 않습니다.