# PromQL에서 벤딩 지표 활성화
<a name="CloudWatch-OTelEnrichment"></a>

**작은 정보**  
CloudWatch의 OpenTelemetry에 대해 자세히 알아보려면 [Cloud Operations Enablement workshop and event series](https://aws-experience.com/amer/smb/events/series/Cloud-Operations-Enablement)를 확인하세요.

OTel 보강을 활성화하여 PromQL을 통해 쿼리할 수 있는 [지원되는 AWS 리소스](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/UsingResourceTagsForTelemetry.html)에 대한 벤딩 지표를 만들 수 있습니다. 활성화되면 리소스 식별자 차원(예: InstanceId 차원을 포함한 EC2 CPUUtilization)이 포함된 지표가 리소스 ARN 및 리소스 태그 레이블로 보강되고 PromQL을 사용하여 쿼리할 수 있게 됩니다.

보강된 지표에서 원래 지표 이름과 CloudWatch 차원은 보존되고, 다음이 추가됩니다.
+ **리소스 속성** - 리소스 ARN(`cloud.resource_id`), 클라우드 공급자, 리전 및 계정 ID.
+ **계측 범위** - 소스 서비스를 식별하고 지표를 OTel 보강된 것으로 표시합니다.
+ **리소스 태그** - AWS PromQL 레이블로 쿼리할 수 있는 리소스와 연결된 모든 리소스 태그.

기존 CloudWatch 지표는 수정되지 않고 기존 CloudWatch API를 통해 계속해서 제공됩니다.

## 벤딩 지표에 대한 OpenTelemetry 보강 활성화
<a name="CloudWatch-OTelEnrichment-Enable"></a>

OTel 보강을 시작하기 전에 계정의 [텔레메트리에서 리소스 태그를 활성화](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/EnableResourceTagsOnTelemetry.html)해야 합니다.

CloudWatch 콘솔, AWS CLI, CloudFormation, Terraform 또는 AWS SDK를 사용하여 특정 리전의 계정에 대해 OTel 보강을 활성화할 수 있습니다.

다음 작업에는 `cloudwatch:StartOTelEnrichment` 권한이 필요합니다.

**AWS 지표에 대한 OTel 보강 활성화(CloudWatch 콘솔)**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **CloudWatch**를 선택한 다음, **설정**을 선택합니다.

1. **AWS 지표에 대한 OTel 보강 활성화** 창에서 기능을 켭니다.

**AWS CLI**

```
aws cloudwatch start-otel-enrichment
```

**CloudFormation**

```
Resources:
  OTelEnrichment:
    Type: AWS::CloudWatch::OTelEnrichment
```

**Terraform**

**참고**  
`aws_cloudwatch_otel_enrichment` Terraform 리소스를 사용하려면 먼저 `aws_observabilityadmin_telemetry_enrichment` 리소스를 구성해야 합니다.

```
resource "aws_observabilityadmin_telemetry_enrichment" "example" {
}

resource "aws_cloudwatch_otel_enrichment" "example" {
  depends_on = [aws_observabilityadmin_telemetry_enrichment.example]
}
```

자세한 내용은 Terraform Registry의 [aws\_cloudwatch\_otel\_enrichment](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/cloudwatch_otel_enrichment)를 참조하세요.

여러 리전에서 활성화하려면 각 리전 스택에서 동일한 리소스를 생성하거나 각 관심 리전에서 API를 간접 호출합니다.

보강이 활성화되면 PromQL을 통해 벤딩 지표 쿼리를 시작할 수 있습니다. 참조: [PromQL을 사용하여 벤딩 AWS 지표 쿼리](CloudWatch-PromQL-Querying.md#CloudWatch-PromQL-Querying-Vended).