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

# Amazon OpenSearch Service 이름 변경 - 변경 사항 요약
<a name="rename"></a>

2021년 9월 8일에 검색 및 분석 제품군의 이름이 Amazon OpenSearch Service로 변경되었습니다. OpenSearch Service는 OpenSearch 및 레거시 Elasticsearch OSS를 지원합니다. 다음 섹션에서는 이름 변경과 함께 변경된 서비스의 여러 부분과 도메인이 계속 제대로 작동하도록 하기 위해 수행해야 하는 작업에 대해 설명합니다.

이러한 변경 사항 중 일부는 도메인을 Elasticsearch에서 OpenSearch로 업그레이드할 때만 적용됩니다. Billing and Cost Management 콘솔과 같은 다른 경우에는 환경이 즉시 변경됩니다.

단, 이 목록이 전부는 아닙니다. 제품의 다른 부분도 변경되었지만 이러한 업데이트가 가장 적합합니다.

## 새로운 API 버전
<a name="rename-sdk"></a>

새로운 버전의 OpenSearch Service 구성 API(2021년 1월 1일)는 기존 Elasticsearch OSS뿐만 아니라 OpenSearch와 함께 작동합니다. 21개의 API 작업이 보다 간결하고 엔진에 구애받지 않는 이름으로 대체되었지만(예:`CreateElasticsearchDomain`이 `CreateDomain`으로 변경 됨) OpenSearch Service는 두 가지 API 버전을 계속 지원합니다.

앞으로 새 API 작업을 사용하여 도메인을 생성하고 관리하는 것이 좋습니다. 새 API 작업을 사용하여 도메인을 생성할 때 `EngineVersion` 파라미터를 단순한 버전 번호가 아닌 `Elasticsearch_X.Y` 또는 `OpenSearch_X.Y`의 형식으로 지정해야 합니다. 버전을 지정하지 않을 경우 기본값은 최신 버전의 OpenSearch로 설정됩니다.

 AWS CLI 를 사용하여 도메인을 생성하고 관리하려면 `aws opensearch ...`를 버전 1.20.40 이상으로 업그레이드합니다. 새로운 CLI 형식은 [OpenSearch CLI 참조](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/opensearch/index.html)를 참조하세요.

## 인스턴스 유형의 이름 변경
<a name="rename-instances"></a>

이제 Amazon OpenSearch Service 인스턴스 유형의 형식은 `<type>.<size>.search`입니다(예: `m6g.large.elasticsearch`가 아닌 `m6g.large.search`). 별도의 조치를 할 필요는 없습니다. 기존 도메인은 API 및 Billing and Cost Management 콘솔에서 새 인스턴스 유형을 자동으로 참조하기 시작합니다.

예약 인스턴스(RI)가 있는 경우 계약은 변경의 영향을 받지 않습니다. 이전 구성 API 버전은 이전 명명 형식과 계속 호환되지만 새 API 버전을 사용하려면 새 형식을 사용해야 합니다.

## 액세스 정책 변경 사항
<a name="rename-iam"></a>

다음 섹션에서는 액세스 정책을 업데이트하기 위해 수행해야 하는 작업에 대해 설명합니다.

### IAM 정책
<a name="rename-iam-only"></a>

이름이 바뀐 API 작업을 사용하려면 [IAM 정책](ac.md)을 업데이트하는 것이 좋습니다. 그러나 OpenSearch Service는 이전 API 권한을 내부적으로 복제하여 기존 정책을 계속 준수합니다. 예를 들어, 현재 `CreateElasticsearchDomain` 작업을 수행할 수 있는 권한이 있는 경우 이제 `CreateElasticsearchDomain`(이전 API 작업) 및 `CreateDomain`(새 API 작업)을 모두 호출할 수 있습니다. 명시적 거부에도 동일하게 적용됩니다. 업데이트된 API 작업 목록은 [정책 요소 참조](ac.md#ac-reference)를 참조하세요.

### SCP 정책
<a name="rename-iam-only"></a>

[서비스 제어 정책(SCP)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)은 표준 IAM에 비해 복잡성을 다시 한번 가중합니다. SCP 정책이 중단되는 것을 방지하려면 이전 *및* 새로운 API 작업을 모두 각 SCP 정책에 추가해야 합니다. 예를 들어, 사용자가 현재 `CreateElasticsearchDomain`에 대한 허용 권한이 있는 경우, `CreateDomain`에 대한 허용 권한도 부여하여 이들이 계속 도메인을 생성할 수 있도록 해야 합니다. 명시적 거부에도 동일하게 적용됩니다.

예제:

```
"Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "es:CreateElasticsearchDomain",
        "es:CreateDomain"
         ...
      ],
    },
      "Effect": "Deny",
      "Action:" [
        "es:DeleteElasticsearchDomain",
        "es:DeleteDomain"
         ...
```

## 새로운 리소스 유형
<a name="rename-resource"></a>

OpenSearch Service는 다음과 같은 새로운 리소스 유형을 도입합니다.


| Resource | 설명 | 
| --- | --- | 
|  `AWS::OpenSearchService::Domain`  |  Amazon OpenSearch Service 도메인을 나타냅니다. 이 리소스는 서비스 수준에 존재하며 도메인에서 실행되는 소프트웨어에만 국한되지 않습니다. [CloudFormation](https://aws.amazon.com/cloudformation/) 및 [AWS Resource Groups](https://docs.aws.amazon.com/ARG/latest/userguide/welcome.html)와 같은 서비스에 적용되며, 서비스 전체에 대한 리소스를 생성하고 관리합니다. CloudFormation 내에 정의된 도메인을 Elasticsearch에서 OpenSearch로 업그레이드하는 방법은 CloudFormation 사용 설명서의 [설명](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchservice-domain.html#aws-resource-opensearchservice-domain--remarks)을 참조하세요.  | 
|  `AWS::OpenSearch::Domain`  | 도메인에서 실행 중인 OpenSearch/Elasticsearch 소프트웨어를 나타냅니다. 이 리소스는 [AWS CloudTrail](https://aws.amazon.com/documentation/cloudtrail/) 및 [AWS Config](https://aws.amazon.com/config/)와 같은 서비스에 적용되며, OpenSearch Service 전체가 아닌 도메인에서 실행 중인 소프트웨어를 참조합니다. 이제 이러한 서비스에는 Elasticsearch를 실행하는 도메인(AWS::Elasticsearch::Domain)과 OpenSearch를 실행하는 도메인(AWS::OpenSearch::Domain)에 대한 별도의 리소스 유형이 포함됩니다. | 

**참고**  
하나 이상의 도메인을 OpenSearch로 업그레이드하는 경우에도 [AWS Config](https://aws.amazon.com/config/)에서 몇 주 동안 기존 `AWS::Elasticsearch::Domain` 리소스 유형의 데이터를 계속 볼 수 있습니다.

## Kibana의 이름이 OpenSearch Dashboards로 변경
<a name="rename-dashboards"></a>

Kibana의 AWS 대안인 [OpenSearch Dashboards](dashboards.md)는 OpenSearch와 함께 작동하도록 설계된 오픈 소스 시각화 도구입니다. Elasticsearch에서 OpenSearch로 도메인을 업그레이드하면 `/_plugin/kibana` 엔드포인트가 `/_dashboards`로 변경됩니다. OpenSearch Service는 모든 요청을 새 엔드포인트로 리디렉션하지만 IAM 정책에서 Kibana 엔드포인트를 사용하는 경우 새로운 `/_dashboards` 엔드포인트도 포함하도록 해당 정책을 업데이트합니다.

[OpenSearch 대시보드에 대한 SAML 인증](saml.md)을 사용하는 경우 도메인을 OpenSearch로 업그레이드하기 전에 자격 증명 공급자(IdP)에 구성된 모든 Kibana URL을 `/_plugin/kibana`에서 `/_dashboards`로 변경해야 합니다. 가장 일반적인 URL은 Assertion Consumer Service(ACS) 및 수신자 URL입니다.

OpenSearch Dashboards의 기본 `kibana_read_only` 역할이 `opensearch_dashboards_read_only`(으)로 이름이 변경되었으며 `kibana_user` 역할이 `opensearch_dashboards_user`(으)로 이름이 변경되었습니다. 변경 사항은 모든 서비스 소프트웨어 R20211203 이상이 설치된 *새로 생성된* OpenSearch 1.*x*도메인에 적용됩니다. 기존 도메인을 서비스 소프트웨어 R20211203으로 업그레이드하 경우 역할 이름은 동일하게 유지됩니다.

## CloudWatch 지표의 이름 변경
<a name="rename-metrics"></a>

OpenSearch를 실행하는 도메인에 대한 CloudWatch 지표가 몇 가지 변경되었습니다. 도메인을 OpenSearch로 업그레이드하면 지표가 자동으로 변경되고 현재 CloudWatch 경보가 중단됩니다. 클러스터를 Elasticsearch 버전에서 OpenSearch 버전으로 업그레이드하기 전에 새 지표를 사용하도록 CloudWatch 경보를 업데이트해야 합니다.

다음 지표가 변경되었습니다.


| 원래 지표 이름 | 새 이름 | 
| --- | --- | 
|  `KibanaHealthyNodes`  |  `OpenSearchDashboardsHealthyNodes`  | 
|  `KibanaConcurrentConnections`  |  `OpenSearchDashboardsConcurrentConnections`  | 
|  `KibanaHeapTotal`  |  `OpenSearchDashboardsHeapTotal`  | 
|  `KibanaHeapUsed`  |  `OpenSearchDashboardsHeapUsed`  | 
|  `KibanaHeapUtilization`  |  `OpenSearchDashboardsHeapUtilization`  | 
|  `KibanaOS1MinuteLoad`  |  `OpenSearchDashboardsOS1MinuteLoad`  | 
|  `KibanaRequestTotal`  |  `OpenSearchDashboardsRequestTotal`  | 
|  `KibanaResponseTimesMaxInMillis`  |  `OpenSearchDashboardsResponseTimesMaxInMillis`  | 
|  `ESReportingFailedRequestSysErrCount`  |  `KibanaReportingFailedRequestSysErrCount`  | 
|  `ESReportingRequestCount`  |  `KibanaReportingRequestCount`  | 
|  `ESReportingFailedRequestUserErrCount`  |  `KibanaReportingFailedRequestUserErrCount`  | 
|  `ESReportingSuccessCount`  |  `KibanaReportingSuccessCount`  | 
|  `ElasticsearchRequests`  |  `OpenSearchRequests`  | 

OpenSearch Services가 Amazon CloudWatch로 전송하는 지표의 전체 목록은 [Amazon CloudWatch로 OpenSearch 클러스터 지표 모니터링](managedomains-cloudwatchmetrics.md)를 참조하세요.

## Billing and Cost Management 콘솔 변경 사항
<a name="rename-billing"></a>

[결제 및 비용 관리](https://console.aws.amazon.com/billing/home) 콘솔 및 [비용 및 사용 보고서](https://aws.amazon.com/aws-cost-management/aws-cost-and-usage-reporting/)의 기록 데이터는 이전 서비스 이름을 계속 사용하므로 데이터를 검색할 때 **Amazon OpenSearch Service**와 레거시 Elasticsearch 이름 모두에 대한 필터를 사용해야 합니다. 기존의 저장된 보고서가 있는 경우 필터를 업데이트하여 OpenSearch Service도 포함하도록 합니다. Elasticsearch의 사용량이 감소하고 OpenSearch의 사용량이 증가하면 처음에 알림이 표시될 수 있지만 며칠 이내에 사라집니다.

서비스 이름 외에도 다음 필드는 모든 보고서, 청구서, 가격 목록 API 작업에서 변경됩니다.


| Field | 이전 형식 | 행 형식 | 
| --- | --- | --- | 
| 인스턴스 유형 |  `m5.large.elasticsearch`  |  `m5.large.search`  | 
| 제품군 |  Elasticsearch 인스턴스 Elasticsearch 볼륨  |  Amazon OpenSearch Service 인스턴스 Amazon OpenSearch Service 볼륨  | 
| 가격 설명 |  c5.18xlarge.elasticsearch 인스턴스 시간(또는 부분적인 시간)당 5.098 USD - EU  |  c5.18xlarge.search 인스턴스 시간(또는 부분적인 시간)당 5.098 USD - EU  | 
|  인스턴스 패밀리  |  `ultrawarm.elasticsearch`  |  `ultrawarm.search`  | 

## 새로운 이벤트 형식
<a name="rename-events"></a>

OpenSearch Service가 Amazon EventBridge와 Amazon CloudWatch에 전송하는 이벤트 형식이 변경되었습니다. 특히 `detail-type` 필드가 변경되었습니다. 소스 필드(`aws.es`)는 동일하게 유지됩니다. 각 이벤트 유형에 대한 전체 형식은 [Amazon EventBridge를 사용하여 OpenSearch Service 이벤트 모니터링](monitoring-events.md) 섹션을 참조하세요. 이전 형식에 따라 달라지는 기존 이벤트 규칙이 있는 경우 새 형식에 맞게 업데이트해야 합니다.

## 변경되지 않는 것은 무엇입니까?
<a name="rename-nochange"></a>

나열되지 않은 기능 중 다음 기능은 동일하게 유지됩니다.
+ 서비스 보안 주체(`es.amazonaws.com`)
+ 공급 업체 코드
+ 도메인 ARN
+ 도메인 엔드포인트

## 시작하기: 도메인을 OpenSearch 1.x로 업그레이드
<a name="rename-upgrade"></a>

OpenSearch 1.*x*는 Elasticsearch 버전 6.8 및 7.*x*에서의 업그레이드를 지원합니다. 도메인을 업그레이드하는 방법에 대한 지침은 [도메인 업그레이드(콘솔)](starting-upgrades.md) 섹션을 참조하세요. AWS CLI 또는 구성 API를 사용하여 도메인을 업그레이드하는 경우를 `TargetVersion`로 지정해야 합니다`OpenSearch_1.x`.

OpenSearch 1.*x*에 **호환성 모드 사용 설정**이라는 추가 도메인 설정이 도입되었습니다. 특정 Elasticsearch OSS 클라이언트 및 플러그인은 연결하기 전에 클러스터 버전을 확인하기 때문에 호환성 모드에서는 OpenSearch가 해당 버전을 7.10으로 보고하도록 설정하여 이러한 클라이언트가 계속 작동하도록 합니다.

OpenSearch 도메인을 처음 생성하거나 Elasticsearch 버전에서 OpenSearch로 업그레이드할 때 호환성 모드를 활성화할 수 있습니다. 설정되지 않은 경우 파라미터의 기본값은 도메인을 생성할 때 `false`, `true`도메인을 업그레이드할 때입니다.

[구성 API](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpgradeDomain.html)를 사용하여 호환성 모드를 활성화하려면, `override_main_response_version`을 `true`로 설정합니다.

```
POST https://es.us-east-1.amazonaws.com/2021-01-01/opensearch/upgradeDomain
{
  "DomainName": "domain-name",
  "TargetVersion": "OpenSearch_1.0",
  "AdvancedOptions": {
    "override_main_response_version": "true"
   }
}
```

*기존* OpenSearch 도메인에서 호환성 모드를 활성화 또는 비활성화하려면 OpenSearch [\$1cluster/settings](https://docs.opensearch.org/latest/opensearch/rest-api/cluster-settings/) API 작업을 사용해야 합니다.

```
PUT /_cluster/settings
{
  "persistent" : {
    "compatibility.override_main_response_version" : true
  }
}
```