Migração de objetos salvos dos OpenSearch painéis para a interface do usuário OpenSearch

Se você tiver painéis, visualizações, padrões de índice e outros objetos salvos nos OpenSearch painéis, poderá migrá-los e reutilizá-los na interface do usuário. OpenSearch

Benefícios da migração para a OpenSearch interface do usuário:

Visão geral da migração

O processo de migração consiste nas seguintes etapas de alto nível:

Pré-requisitos

Antes da migração, verifique os seguintes pré-requisitos:

Etapa 1: Exportar objetos salvos dos OpenSearch painéis

Exporte seus objetos salvos dos OpenSearch painéis usando a interface de gerenciamento ou a API de exportação. A exportação produz um arquivo JSON (NDJSON) delimitado por nova linha que contém todos os tipos de objetos salvos selecionados e suas dependências.

Exportar manualmente em OpenSearch painéis

Exportação via API

Você pode usar a API de exportação de objetos salvos do OpenSearch Dashboards para exportar objetos salvos de forma programática. Isso é útil para automatizar migrações ou integrar a etapa de exportação em um pipeline. CI/CD

O exemplo a seguir exporta todos os painéis com seus objetos relacionados. Substitua placeholder values por suas próprias informações.

curl -X POST \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \
    -u 'master-username:master-password' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "type": ["dashboard", "visualization", "index-pattern", "search"],
        "includeReferencesDeep": true,
        "excludeExportDetails": false
    }' \
    -o saved-objects-export.ndjson

Se o seu domínio não tiver o controle de acesso detalhado ativado, você poderá omitir o sinalizador. -u

Para exportar objetos salvos específicos por ID, use o objects parâmetro em vez detype:

curl -X POST \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \
    -u 'master-username:master-password' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "objects": [
            {"type": "dashboard", "id": "dashboard-id"},
            {"type": "visualization", "id": "visualization-id"}
        ],
        "includeReferencesDeep": true
    }' \
    -o saved-objects-export.ndjson

curl -X GET \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_find?type=dashboard" \
    -u 'master-username:master-password'

Etapa 2: importar objetos salvos para a OpenSearch interface

Depois de exportar os objetos salvos, você pode importar o arquivo NDJSON para a OpenSearch interface do usuário manualmente ou via API.

Importar manualmente na OpenSearch interface

Importar via API

Para importar objetos salvos usando a API com autenticação AWS Signature versão 4, você deve primeiro obter a ID da fonte de dados e usá-la na solicitação de importação. Substitua placeholder values por suas próprias informações.

Etapa 1: obtenha o ID da fonte de dados para seu espaço de trabalho:

curl -X GET \
    "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_find?type=data-source" \
    --aws-sigv4 "aws:amz:region:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true"

Etapa 2: Importe os objetos salvos usando a ID da fonte de dados da Etapa 1:

curl -X POST \
    "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_import?overwrite=true&dataSourceId=data-source-id" \
    --aws-sigv4 "aws:amz:region:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true" \
    -F "file=@saved-objects-export.ndjson"