本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 教學課程：自動化索引狀態管理程序
<a name="ism-tutorial"></a>

本教學課程示範如何實作 ISM 政策，該政策可自動化例行索引管理任務並將它們套用至索引和索引模式。

Amazon OpenSearch Service 中的[索引狀態管理 (ISM)](ism.md) 可讓您自動化週期性索引管理活動，因此您可以避免使用其他工具來管理索引生命週期。您可以建立一個政策，根據索引期限、大小和其他條件，全部從 Amazon OpenSearch Service 網域內自動化這些操作。

OpenSearch Service 支援三種儲存層：用於主動寫入和低延遲分析的預設「熱」狀態、用於高達 3 PB 唯讀資料的 UltraWarm，以及用於無限長期存檔的冷儲存。

本教學課程提供在每日索引中處理時間序列資料的範例使用案例。在本教學課程中，您可設定政策，以在 24 小時後拍攝每個所連接索引的自動快照。然後，它會在兩天後將索引從預設的熱狀態遷移至 UltraWarm 儲存，在 30 天後遷移至冷儲存，最後在 60 天後刪除索引。

## 先決條件
<a name="ism-tutorialprerequisites"></a>
+ 您的 OpenSearch Service 網域必須執行 Elasticsearch 6.8 或更新版本。
+ 您的網域必須已啟用 [UltraWarm](ultrawarm.md) 和[冷儲存](cold-storage.md)。
+ 必須為您的網域[註冊手動快照儲存庫](managedomains-snapshot-registerdirectory.md)。
+ 您的使用者角色需要足夠的許可才能存取 OpenSearch Service 主控台。如有必要，請驗證並[設定網域的存取權](ac.md)。

## 步驟 1：設定 ISM 政策
<a name="ism-tutorial-policy"></a>

首先，在 OpenSearch Dashboards 中設定 ISM 政策。

1. 從 OpenSearch Service 主控台的網域儀表板中，導覽至 OpenSearch Dashboards URL，並使用主要使用者名稱和密碼登入。URL 遵循此格式：`domain-endpoint/_dashboards/`。

1. 在 OpenSearch Dashboards 中，選擇 **Add sample data** (新增範例資料)，然後新增一個或多個範例索引至您的網域。

1. 開啟左側導覽面板，然後依序選擇 **Index Management** (索引管理) 和 **Create policy** (建立政策)。

1. 將政策命名為 `ism-policy-example`。

1. 將預設政策取代為以下政策：

   ```
   {
     "policy": {
       "description": "Move indexes between storage tiers",
       "default_state": "hot",
       "states": [
         {
           "name": "hot",
           "actions": [],
           "transitions": [
             {
               "state_name": "snapshot",
               "conditions": {
                 "min_index_age": "24h"
               }
             }
           ]
         },
         {
           "name": "snapshot",
           "actions": [
             {
               "retry": {
                 "count": 5,
                 "backoff": "exponential",
                 "delay": "30m"
               },
               "snapshot": {
                 "repository": "snapshot-repo",
                 "snapshot": "ism-snapshot"
               }
             }
           ],
           "transitions": [
             {
               "state_name": "warm",
               "conditions": {
                 "min_index_age": "2d"
               }
             }
           ]
         },
         {
           "name": "warm",
           "actions": [
             {
               "retry": {
                 "count": 5,
                 "backoff": "exponential",
                 "delay": "1h"
               },
               "warm_migration": {}
             }
           ],
           "transitions": [
             {
               "state_name": "cold",
               "conditions": {
                 "min_index_age": "30d"
               }
             }
           ]
         },
         {
           "name": "cold",
           "actions": [
             {
               "retry": {
                 "count": 5,
                 "backoff": "exponential",
                 "delay": "1h"
               },
               "cold_migration": {
                 "start_time": null,
                 "end_time": null,
                 "timestamp_field": "@timestamp",
                 "ignore": "none"
               }
             }
           ],
           "transitions": [
             {
               "state_name": "delete",
               "conditions": {
                 "min_index_age": "60d"
               }
             }
           ]
         },
         {
           "name": "delete",
           "actions": [
             {
               "cold_delete": {}
             }
           ],
           "transitions": []
         }
       ],
       "ism_template": [
         {
           "index_patterns": [
             "index-*"
           ],
           "priority": 100
         }
       ]
     }
   }
   ```
**注意**  
`ism_template` 欄位會自動將政策連接至符合其中一個指定 `index_patterns` 的任何新建立的索引。在此案例中，則為所有以 `index-` 開頭的索引。您可以修改此欄位以符合環境中的索引格式。如需詳細資訊，請參閱 [ISM 範本](ism.md#ism-template)。

1. 在政策的 `snapshot` 區段中,將 `snapshot-repo` 取代為您為網域註冊的[快照儲存庫](managedomains-snapshot-registerdirectory.md)的名稱。您也可以選擇取代 `ism-snapshot`，這將是建立快照時的名稱。

1. 選擇**建立**。現在可以在 **State management policies** (狀態管理政策) 頁面上看到該政策。

## 步驟 2：將政策連接至一個或多個索引
<a name="ism-tutorial-attach"></a>

既然您已建立政策，請將其連接至叢集中的一個或多個索引。

1. 轉至 **Hot indicies** (熱索引) 標籤並搜尋 `opensearch_dashboards_sample`，這會列出您在步驟 1 中新增的所有範例索引。

1. 選取所有索引並選擇 **Apply policy** (套用政策)，然後選擇您剛剛建立的 **ism-policy-example** 政策。

1. 選擇**套用**。

您可以在 **Policy managed indices** (政策管理的索引) 頁面上監控索引在各種狀態間的移動。