Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Migrieren gespeicherter Objekte 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 in der Benutzeroberfläche migrieren und wiederverwenden. OpenSearch
Vorteile der Migration zur Benutzeroberfläche: OpenSearch
-
Hohe Verfügbarkeit — Die OpenSearch Benutzeroberfläche wird in der gehostet AWS Cloud und bleibt während Domain-Upgrades und Wartungsarbeiten verfügbar, während OpenSearch Dashboards innerhalb der Domain gehostet werden und vorübergehend nicht verfügbar sein werden.
-
Mehrere Datenquellen — Die OpenSearch Benutzeroberfläche kann eine konsolidierte zentrale Oberfläche für mehrere Datenquellen bereitstellen, darunter OpenSearch Domänen, serverlose Sammlungen und Datenverbindungen mit Amazon S3 und Amazon CloudWatch. Jedes OpenSearch Dashboard kann jedoch nur mit einer Domain oder Sammlung funktionieren.
-
Zusätzliche Funktionen wie AI Assistant und Workspaces sind auf der Benutzeroberfläche verfügbar. OpenSearch Erfahre mehr:Verwenden der OpenSearch Benutzeroberfläche in Amazon OpenSearch Service.
Themen
Überblick über die Migration
Der Migrationsprozess besteht aus den folgenden allgemeinen Schritten:
-
Exportieren von gespeicherten Objekten aus OpenSearch Dashboards — Verwenden Sie die Verwaltungsschnittstelle für gespeicherte Objekte in OpenSearch Dashboards oder die Export-API, um Ihre Dashboards, Visualisierungen, Indexmuster und andere Objekte als durch Zeilenumbrüche getrennte JSON-Datei (NDJSON) herunterzuladen.
-
Erstellen Sie eine OpenSearch UI-Anwendung und einen Workspace — Falls Sie dies noch nicht getan haben, erstellen Sie eine UI-Anwendung und einen OpenSearch Workspace, um die importierten Objekte zu empfangen.
-
Registrieren Sie die Datenquelle in der OpenSearch Benutzeroberfläche — Ordnen Sie Ihre OpenSearch Domain der OpenSearch UI-Anwendung zu und registrieren Sie sie als Datenquelle im Workspace. Indexmuster in Ihren importierten Objekten verweisen auf diese Datenquelle.
-
Gespeicherte Objekte in die OpenSearch Benutzeroberfläche importieren — Verwenden Sie die OpenSearch UI Saved Objects Management UI oder die Import-API, um die NDJSON-Datei in den Ziel-Workspace hochzuladen.
-
Überprüfen Sie die importierten Objekte — Öffnen Sie Ihre Dashboards und Visualisierungen in der OpenSearch Benutzeroberfläche, um zu überprüfen, ob sie korrekt angezeigt werden und ob Daten aus der zugehörigen Domäne oder Sammlung stammen.
Voraussetzungen
Überprüfen Sie vor der Migration die folgenden Voraussetzungen:
-
Sie verfügen über die erforderlichen IAM-Berechtigungen, um den Amazon OpenSearch Service aufzurufen und OpenSearch APIs. Weitere Informationen finden Sie unter Erforderliche Berechtigungen für die Erstellung von Amazon OpenSearch Service-Anwendungen.
-
Sie können auf die Domain oder Sammlung und die OpenSearch Dashboards zugreifen, die Sie migrieren möchten.
-
Sie haben eine OpenSearch UI-Anwendung erstellt. Informationen zum Erstellen einer Anwendung und eines Arbeitsbereichs finden Sie unterErste Schritte mit der OpenSearch Benutzeroberfläche in Amazon OpenSearch Service.
-
Sie haben dieselbe Domäne oder Sammlung mit der OpenSearch Benutzeroberflächenanwendung verknüpft. Hinweise zum Zuordnen von Datenquellen finden Sie unterVerwaltung von Datenquellenzuordnungen und Virtual Private Cloud-Zugriffsberechtigungen.
Anmerkung
OpenSearch Die Benutzeroberfläche unterstützt nur OpenSearch Version 1.3 und höher. Stellen Sie sicher, dass auf Ihrer OpenSearch Domain Version 1.3 oder höher ausgeführt wird, bevor Sie versuchen, gespeicherte Objekte zu migrieren.
Schritt 1: Exportieren Sie gespeicherte Objekte aus OpenSearch Dashboards
Exportieren Sie Ihre gespeicherten Objekte mithilfe der Management-Benutzeroberfläche oder der Export-API aus OpenSearch Dashboards. Beim Export wird eine durch Zeilenumbrüche getrennte JSON-Datei (NDJSON) erzeugt, die alle ausgewählten gespeicherten Objekttypen und ihre Abhängigkeiten enthält.
OpenSearch Manueller Export auf Dashboards
Um gespeicherte Objekte mithilfe der OpenSearch Dashboard-Verwaltungsschnittstelle zu exportieren
-
Öffnen Sie Ihre OpenSearch Dashboards-Instanz.
-
Wählen Sie im linken Navigationsbereich Management aus.
-
Wählen Sie unter Dashboard-Verwaltung die Option Gespeicherte Objekte aus.
-
Wählen Sie die gespeicherten Objekte aus, die Sie exportieren möchten. Um alle Objekte eines bestimmten Typs zu exportieren, filtern Sie mithilfe der Suchleiste nach Typ. Um alle Objekte zu exportieren, aktivieren Sie das Kontrollkästchen in der Tabellenüberschrift.
-
Wählen Sie Export aus.
-
Stellen Sie sicher, dass im Dialogfeld Gespeicherte Objekte exportieren die Option Verwandte Objekte einbeziehen aktiviert ist. Diese Option umfasst alle Objekte, von denen die ausgewählten gespeicherten Objekte abhängen, z. B. Indexmuster, auf die in Visualisierungen verwiesen wird. Deaktivieren Sie diese Option nur, wenn Sie beabsichtigen, Abhängigkeiten manuell zu verwalten.
-
Wählen Sie Exportieren, um die
.ndjsonDatei auf Ihren lokalen Computer herunterzuladen.
Tipp
Wenn Sie „Verwandte Objekte einbeziehen“ wählen, enthält die exportierte NDJSON-Datei alle gespeicherten Objekte, die zum Rendern der ausgewählten Dashboards und Visualisierungen benötigt werden, einschließlich ihrer abhängigen Indexmuster, Visualisierungen und Suchobjekte. Dies vereinfacht den Importschritt und vermeidet fehlende Referenzfehler.
Über API exportieren
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
Anmerkung
Wenn für Ihre OpenSearch Domain eine differenzierte Zugriffskontrolle aktiviert ist, müssen Sie bei Ihrer Exportanfrage Anmeldeinformationen angeben. Verwenden Sie die HTTP-Basisauthentifizierung, indem Sie das -u Kennzeichen mit Ihrem Benutzernamen und Passwort hinzufügen. Weitere Informationen über Authentifizierungsoptionen finden Sie unter Feinkörnige Zugriffskontrolle in Amazon Service OpenSearch.
Das folgende Beispiel exportiert alle Dashboards mit ihren zugehörigen Objekten. 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 }' \ -osaved-objects-export.ndjson
Wenn in Ihrer Domain keine detaillierte Zugriffskontrolle aktiviert ist, können Sie die Markierung 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 }' \ -osaved-objects-export.ndjson
Anmerkung
Um nach gespeicherten Objekten zu suchen IDs, können Sie die API für gespeicherte Objekte verwenden, um alle Objekte eines bestimmten Typs aufzulisten. Das folgende Beispiel listet alle Dashboards auf:
curl -X GET \ "https://dashboards-endpoint/_dashboards/api/saved_objects/_find?type=dashboard" \ -u 'master-username:master-password'
Die Antwort enthält die ID für jedes gespeicherte Objekt. Sie finden die ID auch in der Browser-URL, wenn Sie das Objekt in OpenSearch Dashboards anzeigen.
Schritt 2: Importieren Sie gespeicherte Objekte in die Benutzeroberfläche OpenSearch
Nach dem Exportieren der gespeicherten Objekte können Sie die NDJSON-Datei manuell oder über die API in die OpenSearch Benutzeroberfläche importieren.
Manuell auf der Benutzeroberfläche importieren OpenSearch
Um gespeicherte Objekte mithilfe der OpenSearch UI Management UI zu importieren
-
Öffnen Sie Ihre OpenSearch UI-Anwendung und navigieren Sie zum Ziel-Workspace.
-
Wähle im Workspace in der oberen Navigationsleiste Assets aus oder gehe zur Workspace-Asset-Seite.
-
Wählen Sie „Importieren“, um das Dialogfeld „Elemente importieren“ zu öffnen.
-
Wählen Sie „Datei auswählen“ und wählen Sie die
.ndjsonDatei aus, die Sie aus OpenSearch Dashboards exportiert haben. -
Wählen Sie für Konfliktmanagement eine der folgenden Optionen:
-
Neue Objekte mit eindeutigen Elementen erstellen IDs (Standard) — Generiert neue Objekte IDs für alle importierten Objekte, wodurch Konflikte mit vorhandenen Objekten vermieden werden.
-
Nach vorhandenen Objekten suchen — Prüft, ob Konflikte mit vorhandenen Objekten bestehen. Wenn diese Option ausgewählt ist, wählen Sie eine der folgenden Unteroptionen:
-
Konflikte automatisch überschreiben — Bestehende Assets mit derselben ID werden automatisch ersetzt.
-
Bei Konflikten Maßnahmen anfordern — Sie werden aufgefordert, jeden Konflikt einzeln zu lösen.
-
-
-
Wählen Sie Importieren aus.
-
Lesen Sie die Importzusammenfassung.
Über API importieren
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"
Anmerkung
Die Antwort enthält die Datenquellen-ID. Sie können die Datenquellen-ID auch in der Browser-URL finden, wenn Sie die Datenquelle in der OpenSearch Benutzeroberfläche anzeigen.
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"
Anmerkung
Diese Beispiele verwenden die integrierte --aws-sigv4 Option von Curl (verfügbar in Curl 7.75 oder höher), um die Anfragen zu signieren. Stellen Sie Ihre AWS
Anmeldeinformationen als Umgebungsvariablen ein, bevor Sie die Befehle ausführen: AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY, und AWS_SESSION_TOKEN (falls Sie temporäre Anmeldeinformationen verwenden).
