AWS CDK CLI 원격 측정 구성

CDK CLI 버전

CLI 버전(x.y.z)

이를 수집하면 데이터를 버전별로 양분하는 데 도움이 되며, 이는 문제가 있는 버전을 식별하는 데 도움이 될 수 있습니다.

"2.1100.0"

설치 ID

CLI 명령을 실행하는 로컬 시스템에 저장된 임의 UUID

이렇게 하면 오류의 영향을 받는 고유한 사용자 수를 추정하는 데 도움이 됩니다. 고유한 각 시스템에는 UUID V4를 통해 무작위로 생성되는 자체 설치 ID가 있습니다.

"881d3281-2811-4c86-b7b6-4a8a621cf6f2"

세션 ID

각 CLI 명령 호출에서 생성된 임의 UUID

이렇게 하면 동일한 명령에서 발생하는 모든 이벤트를 식별할 수 있습니다.

"c47e3d55-bc20-406b-a02a-e0285dd63230"

이벤트 ID

세션 ID와 카운터

그러면 세션의 각 이벤트에 대한 고유 식별자가 생성됩니다.

"c47e3d55-bc20-406b-a02a-e0285dd63230:0"

리전

AWS 리전

이렇게 하면 리전별 문제에 대한 데이터를 양분하는 데 도움이 됩니다.

"us-east-1"

타임스탬프

데이터가 원격 측정 엔드포인트로 전송되는 시간(클라이언트에서 생성)

이렇게 하면 시계열 그래프를 생성하는 데 도움이 됩니다.

"2025-12-12T00:00:00.000Z"

이벤트 상태

이벤트의 "결과"입니다. 가능한 값은 'SUCCESS', 'FAILURE', 'ABORTED'입니다.

이를 통해 각 CLI 명령의 오류율을 추적하고 고객이 보고하기 전에 잠재적 회귀를 알릴 수 있습니다.

"SUCCESS"

이벤트 유형

데이터를 생성하는 이벤트 유형의 식별자입니다.

명령 실행에 여러 이벤트가 있을 수 있으므로 발생한 이벤트의 종류를 식별하는 열거형입니다.

"SYNTH"

명령 경로

자유 텍스트가 수정된 상태에서 CLI에 입력된 명령 및 속성

이 정보는 명령 파라미터와 함께 발생한 이벤트의 동작을 결정하는 데 도움이 되므로 폭발 반경과 발생하는 문제의 원인을 식별하는 데 도움이 됩니다.

["cdk", "deploy", "$STACK1"]

명령 파라미터

자유 텍스트가 수정된 상태로 CLI에 입력되는 선택적 파라미터

이 정보는 명령 경로와 함께 발생한 이벤트의 동작을 결정하는 데 도움이 되며, 이는 폭파 반경과 급증하는 문제의 원인을 식별하는 데 도움이 됩니다.

{
  all: true,
  concurrency: 4
}

구성

CLI 명령에 영향을 미칠 수 있는 추가 파라미터(예: cdk.context.json 또는 cdk.json /의 컨텍스트 값~/.cdk.json) 및 모든 자유 텍스트 수정

이렇게 하면 CLI의 동작에 영향을 미칠 수 있는 가능한 모든 파라미터에 대한 포괄적인 보기를 제공하여 디버깅을 용이하게 할 수 있습니다.

{
  context: {
    "@aws-cdk/core:explicitStackTags": true
  }
}

운영 체제

사용 중인 운영 체제

이렇게 하면 특정 운영 체제에만 영향을 미치는 문제를 디버깅하는 데 도움이 됩니다.

{
  platform: "linux",
  release: "5.15.0-1019-aws",
}

CI/CD

CLI 명령이 CI/CD 환경에서 호출되고 있는지 여부

이렇게 하면 CI/CD 환경과 관련된 문제를 식별하는 데 도움이 됩니다.

false

노드 버전

환경에서 사용되는 노드 버전

이렇게 하면 발생하는 노드별 문제를 디버깅하는 데 도움이 됩니다.

"v22.0.0"

지속 시간

밀리초 단위의 이벤트 길이

이를 통해 특정 이벤트에 걸리는 시간의 패턴을 파악할 수 있습니다.

{ total: 300 }

카운터

CDK 앱 및 CLI 실행에서 파생된 다양한 카운터 지표

CFN 리소스 수(이에 국한되지 않음)와 같은 통계 계산이 배포 기간에 미치는 영향을 모니터링합니다.

{
  resourceCount: 25,
  errorCount: 0,
  warningCount: 2,
}

종속성

관련 AWS 종속성 및 해당 버전

aws-cdk-lib, jsii, projen 등과 같이 CLI 결과에 영향을 미칠 수 있는 AWS 종속성을 추적할 계획입니다. 특정 AWS 소유 라이브러리에 대한 종속성만 수집합니다.

[{ "aws-cdk-lib": "2.232.0"}]

오류 이름

오류가 발생하는 경우 오류의 이름입니다.

제어되는 오류 이름만 기록하므로 반복되는 오류 유형을 식별하는 데 도움이 됩니다.

"ToolkitError"

다음 지표는 명시적 옵트인이 필요하며 현재 수집되지 않습니다.

오류 메시지

오류가 발생하면 오류 메시지가 반환됩니다. 자유 형식 텍스트 수정

[옵트인 필요] 오류 메시지를 캡처하면 오류가 발생한 데이터를 더 빠른 속도로 집계하고 개별 사용 사례에서 발생한 문제를 디버깅하는 데 도움이 됩니다.

현재 수집되지 않음

오류 스택 추적

오류가 발생할 경우 오류 메시지의 스택 추적입니다. 자유 형식 텍스트 수정

[옵트인 필요] 스택 추적은 개별 디버깅 목적에 유용하며 발생할 수 있는 문제를 재현하는 데 필요합니다.

현재 수집되지 않음

오류 로그

오류가 발생할 경우 실패한 CLI 명령의 로그입니다. 자유 형식 텍스트 수정

[옵트인 필요] 오류 로그는 CLI에 표시되는 문제를 디버깅하고 재현하는 데도 도움이 됩니다.

현재 수집되지 않음