Creating and Managing OpenSearch Index Policies

Context

1. Creating an Index Lifecycle Policy: Create an index lifecycle policy on OpenSearch Dashboards.
2. Associating Indexes with a Lifecycle Policy: Associate indexes with a lifecycle policy.
3. Managing Index Policies: Modify, retry, and change index lifecycle policies.

Creating an Index Lifecycle Policy

1. Log in to the CSS management console.
2. In the navigation pane on the left, choose Clusters > OpenSearch.
3. In the cluster list, find the target cluster, and click Dashboards in the Operation column to log in to OpenSearch Dashboards.
4. Expand the OpenSearch Dashboards menu in the upper-left corner, and choose Index Management.
5. Click Create policy to create an index policy. In the Configuration method dialog box, select JSON editor and click Continue. The page for creating an index policy is displayed.
   • Policy ID: use a custom policy name.
   • Define policy: define a custom policy based on the reference example provided.

     Figure 1 Configuring a policy

     
     

     In the following example, a policy named policy1 is created. The ism_template part specifies the indexes to apply the policy to. After the policy is created, indexes whose names start with test are automatically associated with this policy.

     PUT _plugins/_ism/policies/policy1
     { 
       "policy": { 
         "description": "an example policy", 
         "default_state": "hot", 
         "states": [ 
             // Ignore the states part.
         ], 
         "ism_template": { 
           "index_patterns": [ 
             "test*" 
           ], 
           "priority": 100 
         } 
       } 
     }
     
     

6. Click Create.

Associating Indexes with a Lifecycle Policy

You can bind a policy to one or more indexes, or associate a policy with an index template, so that the policy will be applied to all indexes created using this index template. Use this method when associating existing indexes with a lifecycle policy.

1. On the Index Management page of the OpenSearch Dashboards, choose Indexes.
2. In the Indexes list, select one or more indexes that you want to bind with a policy.
3. Click Apply policy in the upper-right corner. In the displayed dialog box, select Policy ID.

   Figure 2 Apply policy

   
   

   Figure 3 Selecting a policy

   
   
4. Click Apply.

   After you bind a policy to an index, ISM creates a job that runs every 5 minutes by default to execute the policy, check criteria, and change index states.

Managing Index Policies

1. On the Index Management page of the OpenSearch Dashboards, choose Managed Indices.

   The displayed page shows index policies configured for the current cluster.

2. Manage policies in the index policy list.
   • For a policy whose status is abnormal, click Retry policy.
   • To update a policy for an index, select the associated index, and click Change policy. After the policy is updated, click Change to apply the new policy.
   • To remove a policy from an index, select the index, and click Remove policy. In the displayed dialog box, click Remove.