기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# X-Ray 샘플링 규칙 및 그룹 태그 지정하기
태그는 AWS 리소스를 식별하고 구성하는 데 사용할 수 있는 단어 또는 구문입니다. 각 리소스에 여러 개의 태그를 추가할 수 있습니다. 각 태그는 사용자가 정의하는 키와 선택적 값이 포함됩니다. 예를 들어, 태그 키는 **domain**이고 태그 값은 **example.com**일 수 있습니다. 추가하는 태그를 기준으로 리소스를 검색하고 필터링할 수 있습니다. 태그에 대한 자세한 내용은 *AWS 일반 참조 안내서*의 [AWS 리소스 태깅](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)을 참조하세요.
태그를 사용하여 CloudFront 배포에 대한 태그 기반 권한을 적용할 수 있습니다. 자세한 내용은 [리소스 태그를 사용한 AWS 리소스 액세스 제어](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html)를 참조하세요.
**참고**
[Tag Editor](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html) 및 [AWS Resource Groups는](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html) 현재 X-Ray 리소스를 지원하지 않습니다. AWS X-Ray 콘솔 또는 API를 사용하여 태그를 추가하고 관리합니다.
X-Ray 콘솔, API, AWS CLI SDKs 및를 사용하여 리소스에 태그를 적용할 수 있습니다 AWS Tools for Windows PowerShell. 자세한 내용은 다음 설명서를 참조하세요.
+ X-Ray API – *AWS X-Ray API 참조 자료*에서 다음 작업을 참조하십시오.
+ [ListTagsForResource](https://docs.aws.amazon.com/xray/latest/api/API_ListTagsForResource.html)
+ [CreateSamplingRule](https://docs.aws.amazon.com/xray/latest/api/API_CreateSamplingRule.html)
+ [CreateGroup](https://docs.aws.amazon.com/xray/latest/api/API_CreateGroup.html)
+ [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html)
+ AWS CLI - *AWS CLI 명령 참조*의 [xray](https://docs.aws.amazon.com/cli/latest/reference/xray/index.html) 참조
+ SDK - [AWS 설명서](https://docs.aws.amazon.com/) 페이지에서 해당 SDK 설명서 참조
**참고**
X-Ray 리소스에 태그를 추가하거나 변경할 수 없거나 특정 태그가 있는 리소스를 추가할 수 없다면 이 작업을 수행할 수 있는 권한이 없는 것입니다. 액세스를 요청하려면 X-Ray에서 **관리자** 권한이 있는 엔터프라이즈의 AWS 사용자에게 문의하세요.
**Topics**
+ [태그 제한 사항](#xray-tagging-restrictions)
+ [콘솔에서 태그 관리](#xray-tagging-manage)
+ [에서 태그 관리 AWS CLI](#xray-tagging-manage-cli)
+ [태그를 기반으로 X-Ray 리소스에 대한 액세스 제어](#xray-tagging-policy)
## 태그 제한 사항
태그에 적용되는 제한은 다음과 같습니다.
+ 리소스당 최대 태그 수 - 50
+ 최대 키 길이 - 유니코드 128자
+ 최대 값 길이 - 유니코드 256자
+ 키 및 값의 유효값 - a-z, A-Z, 0-9, 공백 및 특수 문자 \_ . : / = \+ - 및 @
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키 접두사로 `aws:`를 사용하지 마세요. AWS 전용입니다.
**참고**
시스템 태그는 수정하거나 삭제할 수 없습니다.
## 콘솔에서 태그 관리
엑스레이 그룹 또는 샘플링 규칙을 만들 때 태그(선택 사항)를 추가할 수 있습니다. 태그는 나중에 콘솔에서 변경하거나 삭제할 수 있습니다.
다음 절차는 X-Ray 콘솔에서 그룹 및 샘플링 규칙에 대한 태그를 추가, 편집 및 삭제하는 방법을 설명합니다.
**Topics**
+ [새 그룹에 태그 추가 (콘솔)](#xray-tagging-add-group-console)
+ [새 샘플링 규칙에 태그 추가하기 (콘솔)](#xray-tagging-add-rule-console)
+ [그룹 태그 편집 또는 삭제하기 (콘솔)](#xray-tagging-change-group-console)
+ [샘플링 규칙 태그 편집 또는 삭제하기 (콘솔)](#xray-tagging-change-rule-console)
### 새 그룹에 태그 추가 (콘솔)
새 X-Ray 그룹을 생성할 때 **그룹 생성** 페이지에서 태그(선택 사항)를 추가할 수 있습니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) X-Ray 콘솔을 엽니다.
1. 탐색 창에서 **구성**을 확장하고 **그룹**을 선택합니다.
1. **그룹 생성**을 선택합니다.
1. **그룹 생성** 페이지에서 그룹의 이름과 필터 표현식을 지정합니다. 이러한 속성에 대한 자세한 내용은 [그룹 구성](xray-console-groups.md) 단원을 참조하십시오.
1. **태그**에서 태그 키와 태그 값(선택 사항)을 입력합니다. 예를 들어, 태그 키 **Stage**와 태그 값 **Production**을 입력하여 이 그룹이 프로덕션용임을 나타낼 수 있습니다. 태그를 추가할 때 새 줄이 표시되어 필요한 경우 다른 태그를 추가할 수 있습니다. 태그에 대한 제한 사항은 [태그 제한 사항](#xray-tagging-restrictions)을 참조하십시오.
1. 태그 추가가 완료되면 **그룹 생성**을 클릭합니다.
### 새 샘플링 규칙에 태그 추가하기 (콘솔)
새 X-Ray 샘플링 규칙을 생성할 때 **샘플링 규칙 생성** 페이지에서 태그를 추가할 수 있습니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) X-Ray 콘솔을 엽니다.
1. 탐색 창에서 **구성**을 확장하고 **샘플링**을 선택합니다.
1. **샘플링 규칙 생성**을 선택합니다.
1. **샘플링 규칙 생성** 페이지에서 이름, 우선 순위, 제한, 매칭 기준 및 매칭 속성을 지정합니다. 이러한 속성에 대한 자세한 내용은 [샘플링 규칙 구성](xray-console-sampling.md) 단원을 참조하십시오.
1. **태그**에서 태그 키와 태그 값(선택 사항)을 입력합니다. 예를 들어, 태그 키 **Stage**와 태그 값 **Production**을 입력하여 이 샘플링 규칙이 프로덕션용임을 나타낼 수 있습니다. 태그를 추가할 때 새 줄이 표시되어 필요한 경우 다른 태그를 추가할 수 있습니다. 태그에 대한 제한 사항은 [태그 제한 사항](#xray-tagging-restrictions)을 참조하십시오.
1. 태그 추가가 완료되면 **샘플링 규칙 생성**을 클릭합니다.
### 그룹 태그 편집 또는 삭제하기 (콘솔)
**그룹 편집** 페이지에서 X-Ray 그룹의 태그를 변경하거나 삭제할 수 있습니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) X-Ray 콘솔을 엽니다.
1. 탐색 창에서 **구성**을 확장하고 **그룹**을 선택합니다.
1. **그룹** 테이블에서 그룹의 이름을 선택합니다.
1. **그룹 편집** 페이지의 **태그**에서 태그 키와 값을 편집합니다. 태그 키는 중복해서 사용할 수 없습니다. 태그 값은 선택 사항이며 원하는 경우 값을 삭제할 수 있습니다. **그룹 편집** 페이지의 다른 속성에 대한 자세한 내용은 [그룹 구성](xray-console-groups.md)을 참조하십시오. 태그에 대한 제한 사항은 [태그 제한 사항](#xray-tagging-restrictions)을 참조하십시오.
1. 태그를 삭제하려면 태그 오른쪽에 있는 **X**를 선택합니다.
1. 태그 편집 또는 삭제를 마치면 **그룹 업데이트**를 선택합니다.
### 샘플링 규칙 태그 편집 또는 삭제하기 (콘솔)
**샘플링 규칙 편집** 페이지에서 X-Ray 샘플링 규칙의 태그를 변경하거나 삭제할 수 있습니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/xray/home](https://console.aws.amazon.com/xray/home) X-Ray 콘솔을 엽니다.
1. 탐색 창에서 **구성**을 확장하고 **샘플링**을 선택합니다.
1. **샘플링 규칙** 테이블에서 샘플링 규칙의 이름을 선택합니다.
1. 태그에서 **태그** 키 및 값을 편집합니다. 태그 키는 중복해서 사용할 수 없습니다. 태그 값은 선택 사항이며 원하는 경우 값을 삭제할 수 있습니다. **샘플링 규칙 편집** 페이지의 다른 속성에 대한 자세한 내용은 [샘플링 규칙 구성](xray-console-sampling.md)을 참조하십시오. 태그에 대한 제한 사항은 [태그 제한 사항](#xray-tagging-restrictions)을 참조하십시오.
1. 태그를 삭제하려면 태그 오른쪽에 있는 **X**를 선택합니다.
1. 태그 편집 또는 삭제를 마치면 **샘플링 규칙 업데이트**를 선택합니다.
## 에서 태그 관리 AWS CLI
X-Ray 그룹 또는 샘플링 규칙을 만들 때 태그를 추가할 수 있습니다. AWS CLI 를 사용하여 태그를 생성하고 관리할 수도 있습니다. 기존 그룹 또는 샘플링 규칙에서 태그를 업데이트하려면 AWS X-Ray 콘솔 또는 [TagResource](https://docs.aws.amazon.com/xray/latest/api/API_TagResource.html) 또는 [UntagResource](https://docs.aws.amazon.com/xray/latest/api/API_UntagResource.html) APIs 사용합니다.
**Topics**
+ [새 X-Ray 그룹 또는 샘플링 규칙(CLI)에 태그 추가하기](#xray-tagging-cli-create)
+ [기존 리소스에 태그 추가 (CLI)](#xray-tagging-cli-add)
+ [리소스의 태그 나열하기 (CLI)](#xray-tagging-cli-list)
+ [리소스에서 태그 삭제하기 (CLI)](#xray-tagging-cli-delete)
### 새 X-Ray 그룹 또는 샘플링 규칙(CLI)에 태그 추가하기
새 X-Ray 그룹 또는 샘플링 규칙을 만들 때 선택적 태그를 추가하려면 다음 명령 중 하나를 사용하세요.
+ 새 그룹에 태그를 추가하려면 다음 명령을 실행하여 {{group\_name}}을 그룹 이름으로, {{mydomain.com}}을 서비스 엔드포인트로, {{key\_name}}을 태그 키로, {{값}}(선택 사항)을 태그 값으로 대체합니다. 그룹 생성 방법에 대한 자세한 내용은 [그룹](xray-api-configuration.md#xray-api-configuration-groups) 섹션을 참조하십시오.
```
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 파일로 지정합니다. 샘플링 규칙 생성 방법에 대한 자세한 내용은 [샘플링 규칙](xray-api-configuration.md#xray-api-configuration-sampling) 섹션을 참조하십시오.
```
aws xray create-sampling-rule \
--cli-input-json file://{{file_name.json}}
```
다음은 `--cli-input-json` 매개변수로 지정된 JSON 파일 {{file\_name.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`조건 키를 사용하여 정책의 [조건 요소](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)에 태그 정보를 제공합니다. 이러한 조건 키에 대한 자세한 내용은 [AWS 리소스 태그를 사용하여 리소스에 대한 액세스 제어를](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) 참조하세요.
리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예시는 [태그에 기반한 X-Ray 그룹 및 샘플링 규칙에 대한 액세스 관리](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-manage-sampling-tags)에서 확인할 수 있습니다.