Migrieren von gespeicherten Objekten von Dashboards zur Benutzeroberfläche OpenSearch OpenSearch

Wenn Sie bereits Dashboards, Visualisierungen, Indexmuster und andere gespeicherte Objekte in OpenSearch Dashboards haben, können Sie diese migrieren und in der Benutzeroberfläche wiederverwenden. OpenSearch

Vorteile der Migration zur Benutzeroberfläche: OpenSearch

Überblick über die Migration

Der Migrationsprozess besteht aus den folgenden allgemeinen Schritten:

Voraussetzungen

Überprüfen Sie vor der Migration die folgenden Voraussetzungen:

Schritt 1: Exportieren Sie gespeicherte Objekte aus OpenSearch Dashboards

Exportieren Sie Ihre gespeicherten Objekte aus OpenSearch Dashboards mithilfe der Verwaltungsschnittstelle oder der Export-API. Der Export erzeugt eine durch Zeilenumbrüche getrennte JSON-Datei (NDJSON), die alle ausgewählten gespeicherten Objekttypen und ihre Abhängigkeiten enthält.

OpenSearch Manuelles Exportieren auf Dashboards

Exportieren über API

Sie können die Export-API für gespeicherte Objekte von OpenSearch Dashboards verwenden, um gespeicherte Objekte programmgesteuert zu exportieren. Dies ist nützlich, um Migrationen zu automatisieren oder den Exportschritt in eine Pipeline zu integrieren. CI/CD

Im folgenden Beispiel werden alle Dashboards mit ihren zugehörigen Objekten exportiert. Ersetzen Sie placeholder values durch Ihre Informationen.

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

Wenn in Ihrer Domain keine feinkörnige Zugriffskontrolle aktiviert ist, können Sie das Kennzeichen weglassen. -u

Um bestimmte gespeicherte Objekte nach ID zu exportieren, verwenden Sie den objects Parameter anstelle von: type

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'

Schritt 2: Importieren Sie gespeicherte Objekte in die Benutzeroberfläche OpenSearch

Nach dem Export der gespeicherten Objekte können Sie die NDJSON-Datei manuell oder über die API in die OpenSearch Benutzeroberfläche importieren.

Manuelles Importieren auf der Benutzeroberfläche OpenSearch

Import über API

Um gespeicherte Objekte mithilfe der API mit AWS Signature Version 4-Authentifizierung zu importieren, müssen Sie zuerst die Datenquellen-ID abrufen und sie dann in der Importanforderung verwenden. Ersetzen Sie placeholder values durch Ihre Informationen.

Schritt 1: Holen Sie sich die Datenquellen-ID für Ihren Workspace:

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"

Schritt 2: Importieren Sie die gespeicherten Objekte mithilfe der Datenquellen-ID aus Schritt 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"