Aiven 完成了远离 Elasticsearch 的过渡：技术细节的翻译。

2022年8月9日

完成从Aiven和Elasticsearch的迁移：技术细节。

2022年8月23日，Aiven将完成从Elasticsearch的迁移。请查看这里，了解我们提供的后向兼容性受到的影响。

有关从Elasticsearch的迁移完成的技术细节。

2021年9月，Aiven引入了Aiven for OpenSearch®服务作为Aiven for Elasticsearch的继任者。为了方便迁移，Aiven提供了从Aiven for Elasticsearch到Aiven for OpenSearch的升级路径，同时保持对Aiven for Elasticsearch的API和指标的向后兼容性。

2022年8月23日，Aiven将为所有迁移至Aiven for OpenSearch的集群停用向下兼容功能，以完成迁移过程。本文将说明在升级后需要进行的必要更改。

Aiven的REST API

Aiven提供的OpenSearch® ACL API

从2022年8月23日开始，Aiven for Elasticsearch API将停止支持。我们建议您尽快切换到Aiven for OpenSearch® API。切换过程涉及到GET、PUT和POST的使用。

https://api.aiven.io/v1/project/{project}/service/{service_name}/opensearch/acl にアクセスしてください。

相反的是

https://api.aiven.io/v1/project/{project}/service/{service_name}/elasticsearch/acl の代わりに以下のようにする。

您可以通过API参考文档确认Aiven for OpenSearch的Aiven API的使用方法。

为了访问服务信息的Aiven API

由于与Aiven for Elasticsearch的后向兼容性被废除，使用Aiven API访问服务信息的方法已经发生变化。当向https://api.aiven.io/v1/project/{project}/service/{service_name}发送请求时，将会发生以下更改：

elasticsearch と kibana は components フィールドで返されなくなりました。

elasticsearch、elasticsearch_username、elasticsearch_password および kibana_uri は connection_info フィールドで返されなくなった。
user_configでelasticsearch_version` を返さなくなった。
service_typeはelasticsearchではなくopensearch` を返すようになった。

这是对Aiven for Elasticsearch和Aiven for OpenSearch®服务的JSON响应的示例：

 `{
 "service_type"："elasticsearch"、
 "components"：[
 {
 "component"："elasticsearch"、
 "host"：「elasticsearch_host
 "port"：12691,
 "privatelink_connection_id": null、
 "route"："dynamic"、
 "use"："primary"："primary"
 }
 {
 "component"："kibana"、
 "host"：「elasticsearch_host
 "port"：443,
 "privatelink_connection_id": null、
 "route"："dynamic"、
 "use"："primary"："primary"
 },
 {
 "component"："opensearch"、
 "host"："opensearch_host"、
 「port"：12691,
 "privatelink_connection_id": null、
 「route"：「dynamic"、
 "use"："primary"："primary"
 }
 {
 "component"："opensearch_dashboards"、
 "host"："opensearch_host"、
 「port"：443,
 "privatelink_connection_id": null、
 「route"：「dynamic"、
 "use"："primary"："primary"
 }
[ ]
 "connection_info": {
 "elasticsearch"：[],
 "kibana_uri"：「elasticsearch_uri
 「elasticsearch_password": "PASSWORD"、
 「elasticsearch_username": "USERNAME"、
 "opensearch"：[],
 "opensearch_dashboards_uri"："opensearch_uri"、
 "opensearch_password": "PASSWORD"、
 "opensearch_username": "USERNAME"
 },
 「user_config"：{
 「elasticsearch_version1.3.3
 }
 クリップボードにコピー

以下是关闭与Elasticsearch的向后兼容性之后，Aiven for OpenSearch®服务的JSON响应示例：

 `{
 "service_type"："opensearch"、
 "components"：[
 {
 "component"："opensearch"、
 "host"："opensearch_host"、
 「port"：12691,
 "privatelink_connection_id": null、
 「route"：「dynamic"、
 "use"："primary"："primary"
 }
 {
 "component"："opensearch_dashboards"、
 "host"："opensearch_host"、
 「port"：443,
 "privatelink_connection_id": null、
 「route"：「dynamic"、
 "use"："primary"："primary"
 }
[ ]
 「connection_info": {
 "opensearch"：[],
 "opensearch_dashboards_uri"："opensearch_uri": "PASSWORD"、
 「opensearch_password": "PASSWORD"、
 "opensearch_username": "USERNAME"
 },
 「user_config"：{
 "opensearch_version"：1.3.3
 }
 クリップボードにコピー

Aiven 控制台 (Aiven console)

如果关闭后向兼容性，您可以在 Aiven 控制台的 OpenSearch® 服务页面上查看差异：Elasticsearch 版本将变为 OpenSearch 版本。

後方互換Aiven for OpenSearch®のサービスページ：

後方互換性OFF後のAiven for OpenSearch®のサービスページです：

指标整合

您可以通过Aiven的Telegraf插件提供指标。可在Aiven for InfluxDB®、Aiven for M3指标集成、外部Prometheus集成以及外部AWS CloudWatch指标集成中使用同样的指标。您可以查看完整的列表。

指标的详细信息 (Zhǐ de xi xī)

请查看附加指标。

如果将后方互换性关闭，Aiven for OpenSearch®将不再生成任何以elasticsearch_为前缀的指标，对于除Datadog之外的所有类型的指标集成。因此，从Aiven for OpenSearch®集群输出的指标中，只会包含上述列表中的opensearch_前缀。

Datadog度量集成

由于Aiven无法控制Datadog代理，因此发送到外部Datadog度量集成的所有度量都带有elasticsearch的前缀。

Grafana ® 可视化工具

如果您正在使用默认的Aiven for Grafana®仪表板，Aiven会自动将使用elasticsearch_前缀的所有查询转换为opensearch_前缀。

如果您使用的是除默认以外的Aiven for Grafana®仪表板，Aiven将提供以下功能。

提供了一个辅助Grafana®仪表板转换的工具，请参考。

请参考替换字符串的步骤。

继续阅读

请参考以下步骤，了解将外部的 Elasticsearch 数据迁移到 Aiven for OpenSearch® 的方法。

Elasticsearch是Elasticsearch BV在美国和其他国家注册的商标。