As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tutorial: como automatizar processos do Gerenciamento de estados de índice
<a name="ism-tutorial"></a>

Este tutorial demonstra como implementar uma política do ISM que automatiza tarefas de rotina de gerenciamento de índices e as aplica a índices e padrões de índices.

O [Index State Management (ISM)](ism.md) no Amazon OpenSearch Service permite automatizar atividades recorrentes de gerenciamento de índices, evitando o uso de ferramentas adicionais para gerenciar os ciclos de vida dos índices. Você pode criar uma política que automatize essas operações com base na idade, tamanho e outras condições do índice, tudo de dentro do seu domínio do Amazon OpenSearch Service.

OpenSearch O serviço oferece suporte a três níveis de armazenamento: o estado “ativo” padrão para gravação ativa e análise de baixa latência, UltraWarm para dados somente para leitura de até três petabytes e armazenamento frio para arquivamento ilimitado a longo prazo.

Este tutorial apresenta um exemplo de caso de uso do tratamento de dados de séries temporais em índices diários. No tutorial, você configurará uma política que captura um instantâneo automatizado de cada índice anexado após 24 horas. Em seguida, ele migra o índice do estado quente padrão para o UltraWarm armazenamento após dois dias, o armazenamento frio após 30 dias e, finalmente, exclui o índice após 60 dias.

## Pré-requisitos
<a name="ism-tutorialprerequisites"></a>
+ Seu domínio OpenSearch de serviço deve estar executando a versão 6.8 ou posterior do Elasticsearch.
+ Seu domínio deve ter um [UltraWarm](ultrawarm.md)[armazenamento a frio](cold-storage.md) ativado.
+ É necessário [registrar um repositório de snapshots manuais](managedomains-snapshot-registerdirectory.md) para seu domínio. 
+ Sua função de usuário precisa de permissões suficientes para acessar o console OpenSearch de serviço. Se necessário, valide e [configure o acesso ao seu domínio](ac.md).

## Etapa 1: configurar a política do ISM
<a name="ism-tutorial-policy"></a>

Primeiro, configure uma política do ISM nos OpenSearch painéis.

1. No painel do seu domínio no console OpenSearch de serviços, navegue até a URL dos OpenSearch painéis e faça login com seu nome de usuário e senha principais. O URL segue este formato: `domain-endpoint/_dashboards/`.

1. Em OpenSearch Painéis, escolha **Adicionar dados de amostra** e adicione um ou mais índices de amostra ao seu domínio.

1. Abra o painel de navegação esquerdo e escolha **IGerenciamento de índices** e **Criar política**.

1. Atribua o nome `ism-policy-example` à política.

1. Substitua a política padrão pela seguinte política:

   ```
   {
     "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
         }
       ]
     }
   }
   ```
**nota**  
O campo `ism_template` anexa automaticamente a política a qualquer índice recém-criado que corresponda a um dos `index_patterns` especificados. Nesse caso, todos os índices que começam com `index-`. É possível modificar esse campo para corresponder a um formato de índice em seu ambiente. Para saber mais, consulte [Modelos do ISM](ism.md#ism-template). 

1. Na seção `snapshot` da política, substitua `snapshot-repo` pelo nome do [repositório de snapshots](managedomains-snapshot-registerdirectory.md) que você registrou para o seu domínio. Se quiser, você também pode substituir `ism-snapshot`, que será o nome do snapshot quando ele for criado.

1. Escolha **Criar**. A política agora está visível na página **Políticas de gerenciamento de estado**.

## Etapa 2: anexar a política a um ou mais índices.
<a name="ism-tutorial-attach"></a>

Agora que você criou a política, anexe-a a um ou mais índices no cluster.

1. Vá para a guia **Índices quentes** e procure `opensearch_dashboards_sample`, que lista todos os índices de exemplo adicionados na etapa 1.

1. Selecione todos os índices e escolha **Aplicar política** e, em seguida, escolha a **ism-policy-example**política que você acabou de criar.

1. Escolha **Aplicar**.

É possível monitorar os índices à medida que eles avançam pelos vários estados na página **Índices gerenciados por políticas**.