기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
X-Ray 샘플링 규칙 및 그룹 태그 지정하기
태그는 AWS 리소스를 식별하고 구성하는 데 사용할 수 있는 단어 또는 문구입니다. 각 리소스에 여러 개의 태그를 추가할 수 있습니다. 각 태그는 사용자가 정의하는 키와 선택적 값이 포함됩니다. 예를 들어, 태그 키는 domain
이고 태그 값은 example.com
일 수 있습니다. 추가하는 태그를 기준으로 리소스를 검색하고 필터링할 수 있습니다. 태그에 대한 자세한 내용은 AWS 일반 참조 안내서의 AWS
리소스 태깅을 참조하세요.
태그를 사용하여 배포에 태그 기반 권한을 적용할 수 있습니다 CloudFront . 자세한 내용은 리소스 태그를 사용한 AWS 리소스 액세스 제어를 참조하세요.
참고
Tag Editor 및 AWS Resource Groups는 현재 X-Ray 리소스를 지원하지 않습니다. 콘솔이나 를 사용하여 태그를 추가하고 관리할 수 있습니다 AWS X-Ray . API
X-Ray 콘솔, API AWS CLI SDKs, 및 를 사용하여 리소스에 태그를 적용할 수 AWS Tools for Windows PowerShell있습니다. 자세한 내용은 다음 설명서를 참조하세요.
-
X-Ray API — AWS X-Ray API참조에서 다음 작업을 참조하십시오.
-
AWS CLI — AWS CLI 명령 참조서의 xray를 참조하십시오.
-
SDKs— SDK 설명서 페이지의 해당 설명서를 AWS 참조하십시오.
참고
X-Ray 리소스에 태그를 추가하거나 변경할 수 없거나 특정 태그가 있는 리소스를 추가할 수 없다면 이 작업을 수행할 수 있는 권한이 없는 것입니다. 액세스를 요청하려면 X-Ray에서 관리자 권한을 가진 기업 내 AWS 사용자에게 문의하십시오.
태그 제한
태그에 적용되는 제한은 다음과 같습니다.
-
리소스당 최대 태그 수 – 50개
-
최대 키 길이 - 유니코드 128자
-
최대 값 길이 - 유니코드 256자
-
키 및 값의 유효값 - a-z, A-Z, 0-9, 공백 및 특수 문자 _ . : / = + - 및 @
-
태그 키와 값은 대소문자를 구분합니다.
-
키 접두사로
aws:
를 사용하지 마세요. AWS 전용입니다.
참고
시스템 태그는 수정하거나 삭제할 수 없습니다.
콘솔에서 태그 관리
엑스레이 그룹 또는 샘플링 규칙을 만들 때 태그(선택 사항)를 추가할 수 있습니다. 태그는 나중에 콘솔에서 변경하거나 삭제할 수 있습니다.
다음 절차는 X-Ray 콘솔에서 그룹 및 샘플링 규칙에 대한 태그를 추가, 편집 및 삭제하는 방법을 설명합니다.
새 그룹에 태그 추가 (콘솔)
새 X-Ray 그룹을 생성할 때 그룹 생성 페이지에서 태그(선택 사항)를 추가할 수 있습니다.
https://console.aws.amazon.com/xray/집에
있는 X-Ray 콘솔에 AWS Management Console 로그인하고 엽니다. -
탐색 창에서 구성을 확장하고 그룹을 선택합니다.
-
그룹 생성을 선택합니다.
-
그룹 생성 페이지에서 그룹의 이름과 필터 표현식을 지정합니다. 이러한 속성에 대한 자세한 내용은 그룹 구성 단원을 참조하십시오.
-
태그에서 태그 키와 태그 값(선택 사항)을 입력합니다. 예를 들어, 태그 키
Stage
와 태그 값Production
을 입력하여 이 그룹이 프로덕션용임을 나타낼 수 있습니다. 태그를 추가할 때 새 줄이 표시되어 필요한 경우 다른 태그를 추가할 수 있습니다. 태그에 대한 제한 사항은 태그 제한을 참조하십시오. -
태그 추가가 완료되면 그룹 생성을 클릭합니다.
새 샘플링 규칙에 태그 추가하기 (콘솔)
새 X-Ray 샘플링 규칙을 생성할 때 샘플링 규칙 생성 페이지에서 태그를 추가할 수 있습니다.
https://console.aws.amazon.com/xray/집에
있는 X-Ray 콘솔에 AWS Management Console 로그인하고 엽니다. -
탐색 창에서 구성을 확장하고 샘플링을 선택합니다.
-
샘플링 규칙 생성을 선택합니다.
-
샘플링 규칙 생성 페이지에서 이름, 우선 순위, 제한, 매칭 기준 및 매칭 속성을 지정합니다. 이러한 속성에 대한 자세한 내용은 샘플링 규칙 구성 단원을 참조하십시오.
-
태그에서 태그 키와 태그 값(선택 사항)을 입력합니다. 예를 들어, 태그 키
Stage
와 태그 값Production
을 입력하여 이 샘플링 규칙이 프로덕션용임을 나타낼 수 있습니다. 태그를 추가할 때 새 줄이 표시되어 필요한 경우 다른 태그를 추가할 수 있습니다. 태그에 대한 제한 사항은 태그 제한을 참조하십시오. -
태그 추가가 완료되면 샘플링 규칙 생성을 클릭합니다.
그룹 태그 편집 또는 삭제하기 (콘솔)
그룹 편집 페이지에서 X-Ray 그룹의 태그를 변경하거나 삭제할 수 있습니다.
https://console.aws.amazon.com/xray/집에
있는 X-Ray 콘솔에 AWS Management Console 로그인하고 엽니다. -
탐색 창에서 구성을 확장하고 그룹을 선택합니다.
-
그룹 테이블에서 그룹의 이름을 선택합니다.
-
그룹 편집 페이지의 태그에서 태그 키와 값을 편집합니다. 태그 키는 중복해서 사용할 수 없습니다. 태그 값은 선택 사항이며 원하는 경우 값을 삭제할 수 있습니다. 그룹 편집 페이지의 다른 속성에 대한 자세한 내용은 그룹 구성을 참조하십시오. 태그에 대한 제한 사항은 태그 제한을 참조하십시오.
-
태그를 삭제하려면 태그 오른쪽에 있는 X를 선택합니다.
-
태그 편집 또는 삭제를 마치면 그룹 업데이트를 선택합니다.
샘플링 규칙 태그 편집 또는 삭제하기 (콘솔)
샘플링 규칙 편집 페이지에서 X-Ray 샘플링 규칙의 태그를 변경하거나 삭제할 수 있습니다.
https://console.aws.amazon.com/xray/집에
있는 X-Ray 콘솔에 AWS Management Console 로그인하고 엽니다. -
탐색 창에서 구성을 확장하고 샘플링을 선택합니다.
-
샘플링 규칙 테이블에서 샘플링 규칙의 이름을 선택합니다.
-
태그에서 태그 키 및 값을 편집합니다. 태그 키는 중복해서 사용할 수 없습니다. 태그 값은 선택 사항이며 원하는 경우 값을 삭제할 수 있습니다. 샘플링 규칙 편집 페이지의 다른 속성에 대한 자세한 내용은 샘플링 규칙 구성을 참조하십시오. 태그에 대한 제한 사항은 태그 제한을 참조하십시오.
-
태그를 삭제하려면 태그 오른쪽에 있는 X를 선택합니다.
-
태그 편집 또는 삭제를 마치면 샘플링 규칙 업데이트를 선택합니다.
내 태그 관리 AWS CLI
X-Ray 그룹 또는 샘플링 규칙을 만들 때 태그를 추가할 수 있습니다. 를 AWS CLI 사용하여 태그를 만들고 관리할 수도 있습니다. 기존 그룹 또는 샘플링 규칙의 태그를 업데이트하려면 AWS X-Ray 콘솔 또는 OR를 TagResource사용합니다 UntagResourceAPIs.
새 X-Ray 그룹 또는 샘플링 규칙에 태그 추가 (CLI)
새 X-Ray 그룹 또는 샘플링 규칙을 만들 때 선택적 태그를 추가하려면 다음 명령 중 하나를 사용하세요.
-
새 그룹에 태그를 추가하려면 다음 명령을 실행합니다.
group_name
그룹 이름을 입력하세요.mydomain.com
서비스 엔드포인트와 함께key_name
태그 키를 사용하여, 그리고 선택적으로value
태그 값 포함. 그룹 생성 방법에 대한 자세한 내용은 그룹 섹션을 참조하십시오.aws xray create-group \ --group-name "
group_name
" \ --filter-expression "service(\"mydomain.com
\") {fault OR error}" \ --tags [{"Key": "key_name
","Value": "value
"},{"Key": "key_name
","Value": "value
"}]다음은 예입니다.
aws xray create-group \ --group-name "AdminGroup" \ --filter-expression "service(\"mydomain.com\") {fault OR error}" \ --tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
-
새 샘플링 규칙에 태그를 추가하려면 다음 명령을 실행합니다.
key_name
태그 키를 사용하여, 그리고 선택적으로value
태그 값 포함. 이 명령은--sampling-rule
매개변수의 값을 JSON 파일로 지정합니다. 샘플링 규칙 생성 방법에 대한 자세한 내용은 샘플링 규칙 섹션을 참조하십시오.aws xray create-sampling-rule \ --cli-input-json file://
file_name.json
다음은 JSON 파일 내용입니다.
file_name.json
--cli-input-json
매개변수로 지정됩니다.{ "SamplingRule": { "RuleName": "
rule_name
", "RuleARN": "string", "ResourceARN": "string", "Priority": integer, "FixedRate": double, "ReservoirSize": integer, "ServiceName": "string", "ServiceType": "string", "Host": "string", "HTTPMethod": "string", "URLPath": "string", "Version": integer, "Attributes": {"attribute_name
": "value
","attribute_name
": "value
"...} } "Tags": [ { "Key":"key_name
", "Value":"value
" }, { "Key":"key_name
", "Value":"value
" } ] }다음 명령은 예제입니다.
aws xray create-sampling-rule \ --cli-input-json file://9000-base-scorekeep.json
다음은
--cli-input-json
매개변수로 지정된 예제9000-base-scorekeep.json
파일의 내용입니다.{ "SamplingRule": { "RuleName": "base-scorekeep", "ResourceARN": "*", "Priority": 9000, "FixedRate": 0.1, "ReservoirSize": 5, "ServiceName": "Scorekeep", "ServiceType": "*", "Host": "*", "HTTPMethod": "*", "URLPath": "*", "Version": 1 } "Tags": [ { "Key":"Stage", "Value":"Prod" }, { "Key":"Department", "Value":"QA" } ] }
기존 리소스에 태그 추가 (CLI)
tag-resource
명령을 실행하여 기존 X-Ray 그룹 또는 샘플링 규칙에 태그를 추가할 수 있습니다. 이 방법은 update-group
또는 update-sampling-rule
를 실행하여 태그를 추가하는 것보다 간단합니다.
그룹이나 샘플링 규칙에 태그를 추가하려면 다음 명령을 실행하여 를 리소스의 ARN 로 바꾸고 추가할 태그의 키와 선택적 값을 지정합니다. ARN
aws xray tag-resource \ --resource-arn "
ARN
" \ --tag-keys [{"Key":"key_name
","Value":"value
"}, {"Key":"key_name
","Value":"value
"}]
다음은 예입니다.
aws xray tag-resource \ --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \ --tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]
리소스의 태그 목록 (CLI)
list-tags-for-resource
명령을 실행하여 X-Ray 그룹 또는 샘플링 규칙의 태그를 나열할 수 있습니다.
그룹 또는 샘플링 규칙과 관련된 태그를 나열하려면 를 리소스의 ARN 태그로 대체하여 다음 명령을 실행합니다. ARN
aws xray list-tags-for-resource \ --resource-arn "
ARN
"
다음은 예입니다.
aws xray list-tags-for-resource \ --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"
리소스의 태그 삭제 (CLI)
untag-resource
명령을 실행하여 X-Ray 그룹 또는 샘플링 규칙의 태그를 삭제할 수 있습니다.
그룹 또는 샘플링 규칙에서 태그를 제거하려면 다음 명령을 실행하여 를 리소스의 ARN 태그로 바꾸고 제거하려는 태그의 키를 지정합니다. ARN
untag-resource
명령으로 전체 태그만 제거할 수 있습니다. 태그 값을 제거하려면 X-Ray 콘솔을 사용하거나, 태그를 삭제하고 동일한 키이지만 값이 다르거나 비어 있는 새 태그를 추가합니다.
aws xray untag-resource \ --resource-arn "
ARN
" \ --tag-keys ["key_name
","key_name
"]
다음은 예입니다.
aws xray untag-resource \ --resource-arn "arn:aws:xray:us-east-2:01234567890:group/
group_name
" \ --tag-keys ["Stage","Department"]
태그를 기반으로 X-Ray 리소스에 대한 액세스 제어
X-Ray 그룹이나 샘플링 규칙에 태그를 첨부하거나 요청에 포함된 태그를 X-Ray에 전달할 수 있습니다. 태그에 근거하여 액세스를 제어하려면 xray:ResourceTag/
, key-name
aws:RequestTag/
또는 key-name
aws:TagKeys
조건 키를 사용하여 정책의 조건 요소에 태그 정보를 제공합니다. 이러한 조건 키에 대해 자세히 알아보려면 리소스 태그를 사용한 AWS 리소스 액세스 제어를 참조하십시오.
리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예제는 태그에 기반한 X-Ray 그룹 및 샘플링 규칙에 대한 액세스 관리 섹션에서 확인할 수 있습니다.