세션 레코딩 및 재생

브라우저 세션 레코딩 및 재생은 디버깅, 감사 또는 훈련 목적으로 포괄적인 관찰성을 제공합니다. 세션 레코딩이 활성화된 브라우저를 생성하면 Amazon Bedrock AgentCore는 브라우저 상호 작용을 자동으로 캡처하여 나중에 분석할 수 있도록 지정된 Amazon S3 버킷에 저장합니다.

세션 재생은 재생을 보고 브라우저 세션 중에 발생한 작업을 이해할 수 있는 포괄적인 브라우저 상호 작용 데이터를 캡처합니다. 이 기능은 브라우저 동작에 대한 자세한 인사이트를 제공하여 오류를 해결하고 향후 호출을 개선하는 데 도움이 됩니다.

세션 재생 중에 수집되는 정보는 다음과 같습니다.

세션 기록을 위한 사전 조건

세션 기록을 활성화하려면 다음이 필요합니다.

레코딩을 위한 IAM 역할 구성

세션 레코딩을 활성화하려면 Amazon S3에 레코딩 데이터를 쓰고 CloudWatch에 활동을 기록할 수 있는 권한이 있는 IAM 실행 역할이 필요합니다. 권한 설정에 대한 자세한 지침은 권한을 참조하세요.

실행 역할에는 표준 브라우저 권한 이외의 추가 권한이 필요합니다.

{
    "Sid": "S3Permissions",
    "Effect": "Allow",
    "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:ListBucket",
        "s3:ListMultipartUploadParts",
        "s3:AbortMultipartUpload"
    ],
    "Resource": [
        "arn:aws:s3:::your-recording-bucket",
        "arn:aws:s3:::your-recording-bucket/*"
    ]
},
{
    "Sid": "CloudWatchLogsPermissions",
    "Effect": "Allow",
    "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
    ],
    "Resource": "*"
}

your-recording-bucket를 실제 Amazon S3 버킷 이름으로 바꿉니다.

1단계: 레코딩을 사용하여 브라우저 도구 생성

녹음이 활성화된 사용자 지정 브라우저 도구를 생성합니다. 브라우저 도구 생성에 대한 자세한 지침은 AgentCore 브라우저 생성을 참조하세요.

브라우저 도구를 생성할 때 다음을 확인하세요.

Python SDK 사용 예제:

import boto3
import uuid

region = "us-west-2"
bucket = "your-recording-bucket"

client = boto3.client("bedrock-agentcore-control", region_name=region)

response = client.create_browser(
    name="MyRecordingBrowser",
    description="Browser with session recording enabled",
    networkConfiguration={"networkMode": "PUBLIC"},
    executionRoleArn="arn:aws:iam::123456789012:role/AgentCoreBrowserRecordingRole",
    clientToken=str(uuid.uuid4()),
    recording={
        "enabled": True,
        "s3Location": {
            "bucket": bucket,
            "prefix": "browser-recordings"
        }
    }
)

browser_identifier = response.get("browserId") or response.get("browserIdentifier")
print(f"Created browser with recording: {browser_identifier}")
print(f"Recordings will be stored at: s3://{bucket}/browser-recordings/")

2단계: 레코딩 지원 브라우저 사용

모든 자동화 프레임워크에서 레코딩이 활성화된 브라우저를 사용합니다. 모든 브라우저 상호 작용이 자동으로 기록됩니다. Strands 사용 예제:

from strands import Agent
from strands_tools.browser import AgentCoreBrowser

# Use the browser created with recording
browser_identifier = "your-browser-identifier"
region = "us-west-2"
browser_tool = AgentCoreBrowser(region=region, identifier=browser_identifier)

agent = Agent(tools=[browser_tool.browser])
prompt = (
    "Navigate to https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html "
    "and summarize the key features of AgentCore."
)

response = agent(prompt)
print("Agent Response:")
print(response.message["content"][0]["text"])

이 세션 중 모든 상호 작용은 세션이 종료될 때 자동으로 기록되고 Amazon S3 버킷에 업로드됩니다.

3단계: 라이브 세션 모니터링 및 레코딩 재생

AWS 콘솔은 실시간 모니터링과 기록된 세션 분석을 위한 포괄적인 도구를 제공합니다.

라이브 뷰 모니터링

브라우저 세션을 실시간으로 모니터링하고 활성 세션과 상호 작용합니다.

콘솔에서 라이브 뷰에 액세스하려면

라이브 뷰 인터페이스는 다음을 제공합니다.

세션 재생 및 분석

콘솔 재생 인터페이스를 통해 세부 세션 레코딩 및 분석에 액세스합니다.

콘솔에서 세션 재생에 액세스하려면

세션 분석 기능

콘솔은 다음과 같은 여러 분석 도구를 제공합니다.

레코딩 탐색

다음 방법을 사용하여 녹음을 탐색합니다.

4단계: 프로그래밍 방식으로 레코딩에 액세스

사용자 지정 통합 및 자동 분석을 위해 Amazon Bedrock AgentCore SDK 및 APIs에 액세스합니다.

프로그래밍 방식의 라이브 뷰 액세스

브라우저 클라이언트 및 뷰어 서버를 사용하여 라이브 브라우저 세션에 연결합니다.

import time
from rich.console import Console
from bedrock_agentcore.tools.browser_client import browser_session
from browser_viewer import BrowserViewerServer

console = Console()

def main():
    try:
        # Create browser session
        with browser_session('us-west-2') as client:
            print("✅ Browser ready!")
            ws_url, headers = client.generate_ws_headers()

            # Start viewer server
            console.print("[cyan]Starting viewer server...[/cyan]")
            viewer = BrowserViewerServer(client, port=8005)
            viewer_url = viewer.start(open_browser=True)

            # Keep running
            while True:
                time.sleep(1)

    except KeyboardInterrupt:
        console.print("[yellow]Shutting down...[/yellow]")
        if 'client' in locals():
            client.stop()
            console.print("✅ Browser session terminated")

if __name__ == "__main__":
    main()

프로그래밍 방식 레코딩 액세스

사용자 지정 분석 워크플로를 위해 Amazon S3에서 직접 기록 데이터에 액세스합니다.

import boto3

s3_client = boto3.client('s3', region_name='us-west-2')

# List recordings in your bucket
bucket_name = "your-recording-bucket"
prefix = "browser-recordings/"

response = s3_client.list_objects_v2(Bucket=bucket_name, Prefix=prefix)

print(f"Recordings in s3://{bucket_name}/{prefix}:")
for obj in response.get('Contents', []):
    print(f"  {obj['Key']} ({obj['Size']} bytes)")
    print(f"    Last Modified: {obj['LastModified']}")
    print()

데이터 구조 기록:

s3://your-recording-bucket/browser-recordings/
  └── session-id/
      ├── batch_1.ndjson.gz
      ├── batch_2.ndjson.gz
      └── batch_3.ndjson.gz

각 세션은 세션 ID로 폴더를 생성하고 세션이 진행됨에 따라 기록 데이터가 청크로 업로드됩니다.

세션 재생 프로그래밍 방식 예제

고급 사용 사례의 경우 사용자 지정 세션 재생 뷰어를 구축하고 기록 데이터를 자체 분석 워크플로에 통합할 수 있습니다.

다음 GitHub 예제에서는 독립 실행형 세션 재생 뷰어와 브라우저 세션 재생 기능을 사용할 때의 전체 브라우저 환경을 보여줍니다.

추가 예제는 GitHub의 AgentCore 브라우저 예제를 참조하세요.

# View the latest recording in a bucket
python view_recordings.py --bucket session-record-test-123456789012 --prefix replay-data

# View a specific recording
python view_recordings.py --bucket session-record-test-123456789012 --prefix replay-data --session 01JZVDG02M8MXZY2N7P3PKDQ74

# Use a specific AWS profile
python view_recordings.py --bucket session-record-test-123456789012 --prefix replay-data --profile my-profile

# View the latest recording in a bucket
python -m live_view_sessionreplay.browser_interactive_session