설정 및 구성 개념 서비스 통합 X-Ray 콘솔 보기 Step Function에 대한 X-Ray 트레이싱 정보 보기 트레이스 서비스 맵 세그먼트 및 하위 세그먼트 분석 구성 트레이스 맵 또는 서비스 맵에 데이터가 없으면 어떻게 되나요?

Trace Step Functions에서 데이터를 요청합니다. AWS X-Ray

다음을 사용할 수 있습니다. AWS X-Ray상태 머신의 구성 요소를 시각화하고, 성능 병목 현상을 식별하고, 오류가 발생한 요청 문제를 해결합니다. 상태 시스템은 트레이스 데이터를 X-Ray로 보내고 X-Ray는 데이터를 처리하여 서비스 맵과 검색 가능한 트레이스 요약을 생성합니다.

상태 머신에 X-Ray를 활성화하면 Step Functions에서 실행되는 모든 요청을 추적할 수 있습니다. AWS X-Ray를 사용할 수 있는 지역 이를 통해 전체 Step Functions 요청에 대한 상세 개요를 확인할 수 있습니다. Step Functions는 업스트림 서비스에서 트레이스 ID를 전달하지 않은 경우에도 상태 시스템 실행을 위해 트레이스를 X-Ray로 전송합니다. X-Ray 서비스 맵을 사용하여 요청을 포함한 요청의 지연 시간을 볼 수 있습니다. AWS X-Ray와 통합된 서비스 또한 샘플링 규칙을 구성하여 지정한 기준에 따라 어떤 요청을 어떤 샘플링 속도로 기록할지를 X-Ray에 지시할 수도 있습니다.

상태 시스템에 X-Ray를 활성화하지 않고 업스트림 서비스에서 트레이스 ID를 전달하지 않으면 Step Functions는 상태 시스템 실행을 위해 트레이스를 X-Ray에 전송하지 않습니다. 하지만 업스트림 서비스에서 트레이스 ID를 전달하는 경우 Step Functions는 상태 시스템 실행을 위해 트레이스를 X-Ray로 전송합니다.

다음을 사용할 수 있음: AWS X-Ray 둘 다 지원되는 지역에서는 Step Functions를 사용할 수 있습니다. X-Ray 및 Step Functions의 리전 지원에 대한 자세한 내용은 Step Functions와 X-Ray 엔드포인트 및 할당량 페이지를 참조하세요.

X-Ray 및 Step Functions의 통합 할당량

최대 7일 동안 데이터를 트레이스에 추가하고 X-Ray에서 트레이스 데이터를 저장하는 기간인 30일 이전의 트레이스 데이터를 쿼리할 수 있습니다. 트레이스에는 X-Ray 할당량이 적용됩니다. 다른 할당량 외에도 X-Ray는 Step Functions 상태 시스템의 최소 보장 트레이스 크기인 100KB를 제공합니다. 100KB 이상의 트레이스 데이터가 X-Ray에 제공되면 트레이스가 정지될 수 있습니다. 다른 X-Ray 할당량에 대한 자세한 내용은 X-Ray 엔드포인트 및 할당량 페이지의 서비스 할당량 섹션을 참조하세요.

중요

Step Functions는 Distributed Map 상태에서 시작된 하위 워크플로 실행의 X-Ray 트레이스를 지원하지 않습니다. 이러한 실행의 경우 트레이스 문서 크기 한도를 초과하기 쉽기 때문입니다.

설정 및 구성

상태 시스템을 만들 때 X-Ray 트레이싱 활성화

세부 정보 지정 페이지에서 X-Ray 추적 활성화를 선택하여 새 상태 시스템을 만들 때 X-Ray 트레이싱을 활성화할 수 있습니다.

Step Functions 콘솔을 열고 상태 시스템 생성을 선택합니다.
작성 방법 선택 페이지에서 적절한 옵션을 선택하여 상태 시스템을 만듭니다. 샘플 프로젝트 실행을 선택하면 상태 시스템을 만드는 동안 X-Ray 트레이싱을 활성화할 수 없으며 상태 시스템을 만든 후에 X-Ray 트레이싱을 활성화해야 합니다. 기존 상태 시스템에서 X-Ray를 활성화하는 방법에 대한 자세한 내용은 기존 상태 시스템에서 X-Ray 활성화 섹션을 참조하세요.

Next(다음)를 선택합니다.
세부 정보 지정 페이지에서 상태 시스템을 구성합니다.
X-Ray 추적 활성화를 선택합니다.

이제 Step Functions 상태 시스템에서 상태 시스템 실행을 위해 트레이스를 X-Ray로 전송합니다.

참고
기존 IAM 역할을 사용하기로 선택한 경우 X-Ray 쓰기가 허용되는지 확인해야 합니다. 필요한 권한에 대한 자세한 내용은 다음 항목을 참조하십시오.

IAM정책: 사용 AWS X-Ray Step Functions에서

X-Ray Tracing을 활성화하려면 추적을 허용할 수 있는 적절한 권한이 포함된 IAM 정책이 필요합니다. 스테이트 머신이 다른 통합 서비스를 사용하는 경우 추가 IAM 정책이 필요할 수 있습니다. 특정 서비스 통합에 대한 IAM 정책을 참조하십시오.

기존 상태 시스템에 X-Ray 추적을 활성화하는 경우 X-Ray 추적을 활성화할 수 있는 충분한 권한이 있는 정책을 추가해야 합니다.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "xray:PutTraceSegments",
                "xray:PutTelemetryRecords",
                "xray:GetSamplingRules",
                "xray:GetSamplingTargets"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

기존 상태 시스템에서 X-Ray 활성화

기존 상태 시스템에서 X-Ray 활성화하기

Step Functions 콘솔에서 트레이싱을 활성화하려는 상태 시스템을 선택합니다.
편집을 선택합니다.
X-Ray 추적 활성화를 선택합니다.

추가적으로 변경해야 할 수도 있다는 알림이 표시됩니다.

참고
기존 상태 머신에 대해 X-Ray를 사용하도록 설정하는 경우 X-Ray에서 추적을 수행할 수 있는 충분한 권한을 부여하는 IAM 정책이 있는지 확인해야 합니다. 수동으로 추가하거나 생성할 수 있습니다. 자세한 내용은 의 IAM 정책 섹션을 참조하십시오IAM정책: 사용 AWS X-Ray Step Functions에서.
(선택 사항) X-Ray 권한이 포함되도록 상태 시스템의 새 역할을 자동 생성합니다.
저장(Save)을 선택합니다.

Step Function에 대한 X-Ray 트레이싱 구성

X-Ray Tracing이 활성화된 상태에서 상태 머신을 처음 실행하면 X-Ray Tracing의 기본 구성 값이 사용됩니다. AWS X-Ray 애플리케이션으로 전송되는 모든 요청에 대해 데이터를 수집하지는 않습니다. 대신 통계적으로 유의미한 요청 수에 대한 데이터를 수집합니다. 기본 값은 매초 최초 요청과 추가 요청의 5% 기록입니다. 초당 하나의 요청은 리저버입니다. 이는 서비스가 요청을 처리 중인 동안 하나 이상의 트레이스가 매초 기록되도록 합니다. 5퍼센트는 리저버 크기를 넘는 추가 요청이 샘플링되는 비율입니다.

시작할 때 서비스 요금이 발생하지 않도록 하려는 경우 기본 샘플링 비율은 보수적입니다. 기본 샘플링 규칙을 수정하고 서비스 또는 요청의 속성에 따라 샘플링을 적용하는 추가 규칙을 구성하도록 X-Ray를 구성할 수 있습니다.

예를 들어 샘플링을 비활성화하고 상태 또는 처리를 수정하는 호출에 대한 모든 요청을 추적하고 싶을 수 있습니다. AWS 계정 또는 트랜잭션. 백그라운드 폴링, 상태 확인 또는 연결 유지 관리와 같은 대량 읽기 전용 직접 호출의 경우 낮은 비율로 샘플링하면서도 발생하는 문제를 관찰할 수 있을 만큼 충분한 데이터를 계속 확보할 수 있습니다.

상태 시스템에 대한 샘플링 규칙 구성하기

X-Ray 콘솔로 이동합니다.
샘플링을 선택합니다.
샘플링 규칙 생성을 선택하여 규칙을 생성합니다.

규칙 이름을 선택하여 규칙을 편집합니다.

규칙을 선택하고 작업메뉴를 사용하여 규칙을 삭제합니다.

기존 샘플링 규칙의 일부(예: 이름 및 우선순위)를 변경할 수 없습니다. 대신 기존 규칙을 추가 또는 복제하고 원하는 대로 변경한 다음 새 규칙을 사용합니다.

X-Ray 샘플링 규칙 및 다양한 파라미터를 구성하는 방법에 대한 자세한 내용은 X-Ray 콘솔에서 샘플링 규칙 구성을 참조하세요.

업스트림 서비스 통합

Express, 동기 및 표준 워크플로와 같은 Step Functions 워크플로의 실행을 업스트림 서비스와 통합하려면 traceHeader를 설정해야 합니다. In API Gateway를 사용하는 경우 이 작업은 자동으로 수행됩니다. HTTP API 하지만 Lambda 함수 및/또는 SDK an을 사용하는 경우에는 StartExecutionon이나 호출을 직접 설정해야 traceHeader 합니다. StartSyncExecutionAPI

traceHeader를 \p{ASCII}∗ 형식으로 지정해야 합니다. 또한 Step Functions에서 같은 트레이스 ID를 사용하도록 하려면 형식을 Root={TRACE_ID};Sampled={1 or 0}으로 지정해야 합니다. Lambda 함수를 사용하는 경우 TRACE_ID를 현재 세그먼트의 트레이스 ID로 바꾸고 샘플링 필드를 샘플링 모드가 true인 경우에는 1로, 샘플링 모드가 false인 경우에는 0으로 설정합니다. 트레이스 ID를 이 형식으로 제공하면 완전한 트레이스를 얻을 수 있습니다.

다음은 traceHeader를 지정하는 방법을 보여주기 위해 Python으로 작성된 예제입니다.


state_machine = config.get_string_paramter("STATE_MACHINE_ARN")
    if (xray_recorder.current_subsegment() is not None and 
        xray_recorder.current_subsegment().sampled) :
        trace_id = "Root={};Sampled=1".format(
            xray_recorder.current_subsegment().trace_id
        )
    else:
        trace_id = "Root=not enabled;Sampled=0"
    LOGGER.info("trace %s", trace_id)
    
    # execute it
    response = states.start_sync_execution(
        stateMachineArn=state_machine,
        input=event['body'],
        name=context.aws_request_id,
        traceHeader=trace_id
    )
    LOGGER.info(response)

개념

X-Ray 콘솔

In the AWS X-Ray 콘솔에서는 상태 머신에 대해 X-Ray가 활성화된 경우 애플리케이션이 제공하는 요청에 대한 서비스 맵과 추적을 볼 수 있습니다.

상태 시스템 실행을 위해 X-Ray 콘솔에 액세스하는 방법은 X-Ray 콘솔 보기 섹션을 참조하세요.

X-Ray 콘솔에 대한 자세한 내용은 X-Ray 콘솔 설명서를 참조하세요.

세그먼트, 하위 세그먼트 및 트레이스

세그먼트는 상태 시스템에 대한 요청 정보를 기록합니다. 여기에는 상태 시스템에서 수행하는 작업과 같은 정보가 포함되며 다운스트림 호출에 대한 정보가 포함된 하위 세그먼트도 포함될 수 있습니다.

트레이스는 단일 요청에 의해 생성된 모든 세그먼트를 수집합니다.

샘플링

효율적인 트레이스를 보장하고 애플리케이션에서 처리하는 요청의 대표적 샘플을 제공하기 위해 X-Ray는 샘플링 알고리즘을 적용하여 트레이스되는 요청을 결정합니다. 샘플링 규칙을 편집하여 이를 변경할 수 있습니다.

지표

상태 시스템의 경우 X-Ray는 간접 호출 시간, 상태 전환 시간, Step Functions의 전체 실행 시간 및 이 실행 시간의 차이를 측정합니다. X-Ray 콘솔을 통해 이 정보에 액세스할 수 있습니다.

분석

The AWS X-Ray 분석 콘솔은 트레이스 데이터를 해석하기 위한 대화형 도구입니다. 현재 트레이스 집합과 연결된 지표 및 필드의 그래프와 패널을 클릭하면 더욱 세부적인 필터로 활성 데이터 세트를 구체화할 수 있습니다. 상태 머신의 성능을 분석하여 성능 문제를 찾아 식별할 수 있습니다.

X-Ray 분석에 대한 자세한 내용은 분석과의 상호 작용을 참조하십시오. AWS X-Ray 분석 콘솔

Step Functions 서비스 통합 및 X-Ray

일부 AWS Step Functions와 통합되는 서비스는 다음과 같은 통합을 제공합니다. AWS X-Ray 요청에 추적 헤더를 추가하거나, X-Ray 데몬을 실행하거나, 샘플링 결정을 내리고 추적 데이터를 X-Ray에 업로드합니다. 나머지는 다음을 사용하여 계측해야 합니다. AWS X-Ray SDK. 몇몇 서비스는 아직 X-Ray 통합을 지원하지 않습니다. Step Functions와 서비스 통합을 사용할 때 완전한 트레이스 데이터를 제공하려면 X-Ray 통합이 필요합니다.

기본 X-Ray 지원

기본 X-Ray 지원과 서비스 통합에는 다음이 포함됩니다.

계측 필요

X-Ray 기기가 필요한 서비스 통합:

Amazon Elastic Container Service
AWS Batch
AWS Fargate

클라이언트 측 트레이스 전용

다른 서비스 통합은 X-Ray 트레이스를 지원하지 않습니다. 하지만 클라이언트 측 트레이스를 계속 수집할 수 있습니다.

Amazon DynamoDB
아마존 EMR
아마존 SageMaker
AWS CodeBuild
AWS Glue

X-Ray 콘솔 보기

X-Ray는 서비스로부터 데이터를 세그먼트로 수신합니다. X-Ray는 공통 요청이 있는 세그먼트를 트레이스로 그룹화합니다. X-Ray는 트레이스를 처리하여 애플리케이션을 시각적으로 표현하는 서비스 그래프를 생성합니다.

상태 시스템 실행을 시작한 후 실행 세부 정보 섹션에서 X-Ray 트레이스 맵 링크를 선택하면 X-Ray 트레이스를 볼 수 있습니다.

상태 시스템에 X-Ray를 활성화한 후에는 X-Ray 콘솔에서 해당 실행에 대한 트레이싱 정보를 볼 수 있습니다.

Step Function에 대한 X-Ray 트레이싱 정보 보기

다음 단계에서는 X-Ray를 활성화하고 실행을 실행한 후 콘솔에 표시되는 정보의 종류를 보여줍니다. AmazonSQS, AmazonSNS, Lambda를 사용하여 콜백 패턴 예제 만들기 샘플 프로젝트의 X-Ray 트레이스가 표시됩니다.

트레이스

실행이 완료되면 X-Ray 콘솔로 이동합니다. 여기서 X-Ray 트레이스 페이지가 표시됩니다. 이 페이지는 서비스 맵 개요뿐만 아니라 상태 시스템의 트레이스 및 세그먼트 정보도 표시됩니다.

서비스 맵

X-Ray 콘솔의 서비스 맵을 사용하면 지연 시간이 긴 연결과 같은 오류가 발생한 서비스를 식별하고 실패한 요청의 트레이스를 확인할 수 있습니다.

트레이스 맵에서 서비스 노드를 선택하여 해당 노드에 대한 요청을 보거나 두 노드 간의 엣지를 선택하여 해당 연결로 이동하는 요청을 볼 수 있습니다. 여기에서는 WaitForCallBack 노드가 선택되었으므로 해당 실행과 응답 상태에 대한 추가 정보를 볼 수 있습니다.

X-Ray 서비스 맵이 상태 시스템과 상관 관계를 지정하는 방법을 확인할 수 있습니다. X-Ray를 지원하는 경우 Step Functions에서 직접적으로 호출하는 각 서비스 통합에 대한 서비스 맵 노드가 있습니다.

세그먼트 및 하위 세그먼트

트레이스는 단일 요청에 의해 생성된 세그먼트 컬렉션입니다. 각 세그먼트는 리소스 이름, 요청의 세부 정보 및 완료된 작업의 세부 정보를 제공합니다. 트레이스 페이지에서 세그먼트를 확인할 수 있으며 이 페이지를 확장하면 해당 하위 세그먼트도 확인할 수 있습니다. 세그먼트나 하위 세그먼트를 선택하여 해당 세그먼트에 대한 자세한 정보를 볼 수 있습니다.

서비스 맵의 각 노드마다 다른 세그먼트가 됩니다.

세그먼트를 선택하면 리소스 이름, 요청의 세부 정보 및 완료된 작업의 세부 정보가 제공됩니다.

세그먼트는 완료된 작업에 대한 데이터를 하위 세그먼트로 구분할 수 있습니다. 하위 세그먼트를 선택하면 세분화된 타이밍 정보와 세부 정보가 표시됩니다. 하위 세그먼트에는 전화 통화에 대한 추가 세부 정보가 포함될 수 있습니다. AWS 서비스 HTTPAPI, 외부 또는 SQL 데이터베이스

분석

The AWS X-Ray 분석 콘솔은 트레이스 데이터를 해석하기 위한 대화형 도구입니다. 이 콘솔을 사용하면 상태 시스템이 수행되는 방식을 더욱 쉽게 이해할 수 있습니다. 대화형 응답 시간 및 시계열 그래프를 통해 트레이스를 탐색, 분석 및 시각화하여 성능 및 지연 시간 문제를 찾을 수 있습니다.

현재 트레이스 집합과 연결된 지표 및 필드의 그래프와 패널을 클릭하면 더욱 세부적인 필터로 활성 데이터 세트를 구체화할 수 있습니다.

구성

X-Ray 콘솔에서 샘플링 및 암호화 옵션을 구성할 수 있습니다.

샘플링을 선택하여 샘플링 속도와 구성에 대한 세부 정보를 봅니다.

샘플링 규칙을 변경하여 기록할 데이터 양을 제어하고 특정 요구 사항에 맞게 샘플링 동작을 수정할 수 있습니다.
암호화를 선택하여 암호화 설정을 수정합니다.

X-Ray가 트레이스 및 저장된 데이터를 암호화하는 기본 설정을 사용하거나 필요한 경우 KMS 키를 선택할 수 있습니다. 표준 AWS KMS후자의 경우 요금이 부과됩니다.

트레이스 맵 또는 서비스 맵에 데이터가 없으면 어떻게 되나요?

X-Ray를 활성화했지만 X-Ray 콘솔에 데이터가 표시되지 않으면 다음을 확인합니다.

X-Ray에 쓸 수 있도록 IAM 역할이 올바르게 설정되었습니다.
샘플링 규칙에서 데이터 샘플링을 허용합니다.
새로 생성되거나 수정된 IAM 역할이 적용되기까지 약간의 지연이 있을 수 있으므로 몇 분 후에 트레이스 또는 서비스 맵을 다시 확인하십시오.
X-Ray Trace 패널에 데이터를 찾을 수 없다는 메시지가 표시되면 IAM계정 설정을 확인하고 다음을 확인하십시오. AWS Security Token Service 원하는 지역에서 활성화됩니다. 자세한 내용은 활성화 및 비활성화를 참조하십시오. AWS STS 에서 AWS 리전(출처: IAM 사용 설명서).

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

로그인 및 CloudWatch 로그

를 사용하는 이벤트 사용자 알림