AWS X-Ray 데몬 구성 - AWS X-Ray
지원되는 환경 변수명령줄 옵션 사용구성 파일 사용

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS X-Ray 데몬 구성

명령줄 옵션 또는 구성 파일을 사용하여 X-Ray 데몬의 동작을 사용자 지정할 수 있습니다. 두 가지 방법 모두 대부분의 옵션을 사용할 수 있지만, 구성 파일에만 사용하는 옵션도 있고 명령줄에만 사용하는 옵션도 있습니다.

시작하려면 알아야 할 유일한 옵션은 다음과 같습니다.-n또는--region, 데몬이 트레이스 데이터를 X-Ray로 보내는 데 사용하는 영역을 설정하는 데 사용합니다.

~/xray-daemon$ ./xray -n us-east-2

데몬을 로컬, 즉 Amazon EC2가 아닌 로컬에서 실행하는 경우 다음을 추가할 수 있습니다.-o인스턴스 프로필 자격 증명 확인을 건너뛰는 옵션을 통해 데몬이 더 빨리 준비되도록 할 수 있습니다.

~/xray-daemon$ ./xray -o -n us-east-2

나머지 명령줄 옵션은 로깅을 구성하거나, 다른 포트에서 수신하거나, 데몬이 사용할 수 있는 메모리의 양을 제한하거나, 트레이스 데이터를 다른 계정으로 보내는 역할을 맡는 데 사용할 수 있습니다.

구성 파일을 데몬에 전달하여 고급 구성 옵션에 액세스하고 동시 호출 수를 X-Ray로 제한하고, 로그 순환을 비활성화하고, 프록시로 트래픽을 보내는 등의 작업을 수행할 수 있습니다.

지원되는 환경 변수

X-Ray 데몬은 다음 환경 변수를 지원합니다.

  • AWS_REGION— 다음을 지정합니다.AWS 리전X-Ray 서비스 엔드포인트의

  • HTTPS_PROXY— 데몬이 세그먼트를 업로드할 때 사용할 프록시 주소를 지정합니다. 이것은 DNS 데몬 이름일 수도 있고, 프록시 서버에서 사용하는 IP 주소와 포트 번호일 수도 있습니다.

명령줄 옵션 사용

로컬에서 또는 사용자 데이터 스크립트를 사용하여 데몬을 실행할 때 이러한 옵션을 데몬에 전달합니다.

명령줄 옵션

  • -b,--bind— 다른 UDP 포트에서 세그먼트 문서를 수신합니다.

    --bind "127.0.0.1:3000"

    기본값 —2000.

  • -t,--bind-tcp— 다른 TCP 포트에서 X-Ray 서비스에 대한 호출을 수신합니다.

    -bind-tcp "127.0.0.1:3000"

    기본값 —2000.

  • -c,--config— 지정된 경로에서 구성 파일을 로드합니다.

    --config "/home/ec2-user/xray-daemon.yaml"

  • -f,--log-file— 지정된 파일 경로로 로그를 출력합니다.

    --log-file "/var/log/xray-daemon.log"

  • -l,--log-level— 가장 자세한 내용부터 가장 낮은 수준까지의 로그 수준: 개발, 디버그, 정보, 경고, 오류, 제품

    --log-level warn

    기본값 —prod

  • -m,--buffer-memory— 버퍼가 사용할 수 있는 메모리 양 (MB) 을 변경합니다 (최소 3개).

    --buffer-memory 50

    기본값 — 사용 가능한 메모리의 1%

  • -o,--local-mode— EC2 인스턴스 메타데이터를 확인하지 마십시오.

  • -r,--role-arn— 지정된 IAM 역할을 맡아 세그먼트를 다른 계정에 업로드합니다.

    --role-arn "arn:aws:iam::123456789012:role/xray-cross-account"

  • -a,--resource-arn— 의 아마존 리소스 이름 (ARN)AWS데몬을 실행하는 리소스.

  • -p,--proxy-address— 세그먼트 업로드AWS X-Ray프록시를 통해 프록시 서버의 프로토콜을 지정해야 합니다.

    --proxy-address "http://192.0.2.0:3000"

  • -n,--region— 특정 지역의 X-Ray 서비스로 세그먼트를 전송합니다.

  • -v,--version— 쇼AWS X-Ray데몬 버전.

  • -h,--help— 도움말 화면을 표시합니다.

구성 파일 사용

YAML 형식 파일을 사용하여 데몬을 구성할 수도 있습니다. -c 옵션을 사용하여 구성 파일을 데몬으로 전달합니다.

~$ ./xray -c ~/xray-daemon.yaml
구성 파일 옵션

  • TotalBufferSizeMB— 최대 버퍼 크기 (MB) (최소 3) 호스트 메모리의 1%를 사용하려면 0을 선택합니다.

  • Concurrency— 에 대한 최대 동시 통화 수AWS X-Ray세그먼트 문서를 업로드하기 위함입니다.

  • Region— 세그먼트를 다음으로 보내기AWS X-Ray특정 지역에서의 서비스.

  • Socket— 데몬의 바인딩을 구성합니다.

  • Logging— 로깅 동작을 구성합니다.

    • LogRotation— 로 설정false로그 로테이션을 비활성화합니다.

    • LogLevel— 로그 수준을 가장 자세한 수준에서 가장 낮은 수준으로 변경합니다.dev,debug,info,warn,error,prod. 기본값은prod이는 다음과 같습니다.info.

    • LogPath— 지정된 파일 경로로 로그를 출력합니다.

  • LocalMode— 로 설정trueEC2 인스턴스 메타데이터 확인을 건너뛰도록 설정합니다.

  • ResourceARN— 의 아마존 리소스 이름 (ARN)AWS데몬을 실행하는 리소스.

  • RoleARN— 지정된 IAM 역할을 맡아 세그먼트를 다른 계정에 업로드합니다.

  • ProxyAddress— 세그먼트를 에 업로드AWS X-Ray프록시를 통해

  • Endpoint— 데몬이 세그먼트 문서를 보내는 X-Ray 서비스 엔드포인트를 변경합니다.

  • NoVerifySSL— TLS 인증서 검증을 비활성화합니다.

  • Version— 데몬 구성 파일 형식 버전. 파일 형식 버전은필수필드.

예 xray-daemon.yaml

구성 파일은 데몬의 수신 포트를 3000으로 변경하고, 인스턴스 메타데이터 확인을 끄고, 세그먼트 업로드에 사용할 역할을 설정하고, 리전 및 로깅 옵션을 변경합니다.

Socket:
  UDPAddress: "127.0.0.1:3000"
  TCPAddress: "127.0.0.1:3000"
Region: "us-west-2"
Logging:
  LogLevel: "warn"
  LogPath: "/var/log/xray-daemon.log"
LocalMode: true
RoleARN: "arn:aws:iam::123456789012:role/xray-cross-account"
Version: 2