동적 계측을 사용하여 애플리케이션 디버깅

동적 계측을 사용하면 다시 시작하거나 재배포하지 않고도 라이브 애플리케이션에서 런타임 상태를 캡처할 수 있습니다. 런타임 상태에는 변수 값, 메서드 인수, 반환 값 및 스택 트레이스가 포함됩니다. 코드에서 데이터를 캡처할 위치를 지정하는 계측 구성을 정의하고 실행 중인 에이전트는 런타임에 애플리케이션을 계측합니다.

개념

지원되는 언어

사전 조건

동적 계측을 사용하려면 배포 유형에 따라 계측 구성 요소를 최신 버전으로 업데이트합니다.

다음 조건도 충족되어야 합니다.

애플리케이션에 동적 계측 추가

애플리케이션을 계측한 후(사전 조건 참조) 동적 원격 분석을 적용할 코드 부분을 지정하는 계측 구성을 생성합니다. 각 구성은 다음 두 가지를 정의합니다.

AWS CLI 또는 SDK를 사용하거나 IDE의 AI 코딩 어시스턴트와 함께 Model Context Protocol(MCP) 서버를 사용하여 구성을 생성할 수 있습니다.

CLI 또는 SDK를 사용하여 구성 생성

AWS CLI 또는 AWS SDK를 사용하여 프로그래밍 방식으로 계측 구성을 생성합니다.

코드 위치 지정

위치는 코드에서 계측이 적용되는 위치를 정의합니다. 필수 필드는 언어에 따라 다릅니다.

캡처할 데이터 구성

캡처 구성은 계측이 실행될 때 수집되는 런타임 상태를 제어합니다. 사용 가능한 옵션:

구성 파라미터

구성을 생성할 때의 주요 파라미터:

예제

다음 예제에서는 Java 메서드에 중단점을 생성합니다.

aws application-signals create-instrumentation-configuration \
    --instrumentation-type BREAKPOINT \
    --service "my-service" \
    --environment "production" \
    --signal-type SNAPSHOT \
    --location '{
        "CodeLocation": {
            "Language": "Java",
            "CodeUnit": "com.example.service",
            "ClassName": "OrderController",
            "MethodName": "processOrder",
            "FilePath": "OrderController.java"
        }
    }' \
    --capture-configuration '{
        "CodeCapture": {
            "CaptureArguments": ["orderId", "user"],
            "CaptureReturn": true,
            "CaptureStackTrace": true,
            "CaptureLimits": {
                "MaxHits": 100,
                "MaxStringLength": 255,
                "MaxCollectionWidth": 20,
                "MaxObjectDepth": 3,
                "MaxFieldsPerObject": 20,
                "MaxStackFrames": 20
            }
        }
    }'

MCP 서버를 사용하여 구성 생성

동적 계측을 사용하는 권장 접근 방식은 CloudWatch Application Signals MCP(Model Context Protocol) 서버를 사용하는 것입니다. MCP를 사용하면 IDE의 AI 코딩 어시스턴트와 에이전트가 개발 환경에서 직접 동적 계측 구성을 생성, 관리 및 쿼리할 수 있습니다.

AI 어시스턴트는 MCP를 사용하여 다음을 수행할 수 있습니다.

설정 및 사용 지침은 GitHub 웹 사이트의 Application Signals MCP 서버를 참조하세요.

데이터 스토리지

중단점 또는 프로브가 실행되면 Dynamic Instrumentation은 접두사(/aws/application-signals/service-nameservice-name은 OTEL_SERVICE_NAME 환경 변수의 값)를 사용하여 CloudWatch Logs에 로그 그룹을 생성하고 캡처된 스냅샷을 해당 로그 그룹에 로그 레코드로 씁니다.

로그 그룹이 아직 없는 경우 Dynamic Instrumentation은 스냅샷을 처음 내보낼 때 자동으로 로그 그룹을 생성합니다. 로그 수집 및 스토리지에 대한 요금은 표준 CloudWatch Logs 요금으로 청구됩니다.

구성 보기 및 관리

CloudWatch 콘솔에서 서비스 세부 정보 페이지로 이동하여 계측 탭을 선택합니다.

상태 이해

각 계측 구성에는 현재 상태를 나타내는 상태가 있습니다.

계측이 ERROR 상태가 되면 다음 원인이 보고될 수 있습니다.

캡처 제한

캡처 제한은 캡처된 데이터의 크기와 깊이를 제어합니다. 캡처 구성의 capture-limits 필드에서 이러한 값을 구성합니다.

각 계측 지점은 초당 캡처 5개로 속도가 제한됩니다.