기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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
— 데몬의 바인딩을 구성합니다.-
UDPAddress
— 데몬이 수신하는 포트를 변경합니다. -
TCPAddress
— 들어보세요X-Ray 서비스에 걸려온 전화다른 TCP 포트에서
-
-
Logging
— 로깅 동작을 구성합니다.-
LogRotation
— 로 설정false
로그 로테이션을 비활성화합니다. -
LogLevel
— 로그 수준을 가장 자세한 수준에서 가장 낮은 수준으로 변경합니다.dev
,debug
,info
,warn
,error
,prod
. 기본값은prod
이는 다음과 같습니다.info
. -
LogPath
— 지정된 파일 경로로 로그를 출력합니다.
-
-
LocalMode
— 로 설정true
EC2 인스턴스 메타데이터 확인을 건너뛰도록 설정합니다. -
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