Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Migrazione degli oggetti salvati dalle dashboard all'interfaccia utente OpenSearch OpenSearch
Se disponi di dashboard, visualizzazioni, modelli di indice e altri oggetti salvati nelle OpenSearch dashboard, puoi migrarli e riutilizzarli nell'interfaccia utente. OpenSearch
Vantaggi della migrazione all'interfaccia utente: OpenSearch
-
Alta disponibilità: l' OpenSearch interfaccia utente è ospitata nel dominio Cloud AWS e rimane disponibile durante gli aggiornamenti e la manutenzione del dominio, mentre OpenSearch le dashboard sono ospitate all'interno del dominio e non saranno temporaneamente disponibili.
-
Fonte di dati multipla: l' OpenSearchinterfaccia utente può fornire un unico pannello di controllo consolidato su più fonti di dati, inclusi OpenSearch domini, raccolte serverless e connessioni dati con Amazon S3 e Amazon CloudWatch; mentre ogni OpenSearch dashboard può funzionare solo con un dominio o una raccolta.
-
Nell'interfaccia utente sono disponibili funzionalità aggiuntive come AI Assistant e Workspaces. OpenSearch Per saperne di più:Utilizzo OpenSearch dell'interfaccia utente in Amazon OpenSearch Service.
Argomenti
Panoramica sulla migrazione
Il processo di migrazione prevede i seguenti passaggi di alto livello:
-
Esporta oggetti salvati dalle OpenSearch dashboard: utilizza l'interfaccia utente di gestione degli oggetti salvati di OpenSearch Dashboards o l'API di esportazione per scaricare dashboard, visualizzazioni, modelli di indice e altri oggetti come file JSON (NDJSON) delimitato da nuove righe.
-
Crea un'applicazione OpenSearch UI e un'area di lavoro: se non l'hai già fatto, crea un'applicazione UI e un'area di lavoro per ricevere gli oggetti importati. OpenSearch
-
Registra l'origine dati nell' OpenSearchinterfaccia utente: associa il tuo OpenSearch dominio all'applicazione OpenSearch UI e registralo come fonte di dati all'interno dell'area di lavoro. I modelli di indice negli oggetti importati fanno riferimento a questa fonte di dati.
-
Importa oggetti salvati nell' OpenSearch interfaccia utente: utilizza l' OpenSearch interfaccia utente di gestione degli oggetti salvati dell'interfaccia utente o l'API di importazione per caricare il file NDJSON nell'area di lavoro di destinazione.
-
Convalida gli oggetti importati: apri i dashboard e le visualizzazioni nell' OpenSearch interfaccia utente per verificare che vengano visualizzati correttamente e che i dati provengano dal dominio o dalla raccolta associati.
Prerequisiti
Prima della migrazione, verifica i seguenti prerequisiti:
-
Disponi delle autorizzazioni IAM necessarie per chiamare il OpenSearch servizio Amazon e OpenSearch APIs. Per ulteriori informazioni, consulta Autorizzazioni richieste per la creazione di applicazioni Amazon OpenSearch Service.
-
Puoi accedere al dominio o alla raccolta e alle OpenSearch dashboard che desideri migrare.
-
Hai creato un'applicazione OpenSearch UI. Per informazioni sulla creazione di un'applicazione e di un'area di lavoro, consultaGuida introduttiva all'interfaccia OpenSearch utente in Amazon OpenSearch Service.
-
Hai associato lo stesso dominio o la stessa raccolta all'applicazione OpenSearch UI. Per informazioni sull'associazione delle fonti di dati, consultaGestione delle associazioni delle fonti di dati e delle autorizzazioni di accesso al Virtual Private Cloud.
Nota
OpenSearch L'interfaccia utente supporta solo OpenSearch la versione 1.3 e successive. Verifica che OpenSearch sul tuo dominio sia in esecuzione la versione 1.3 o successiva prima di tentare di migrare gli oggetti salvati.
Fase 1: Esportazione degli oggetti salvati dai pannelli di controllo OpenSearch
Esporta gli oggetti salvati dalle OpenSearch dashboard utilizzando l'interfaccia utente di gestione o l'API di esportazione. L'esportazione produce un file JSON (NDJSON) delimitato da nuove righe che contiene tutti i tipi di oggetti salvati selezionati e le relative dipendenze.
OpenSearch Esportazione manuale su dashboard
Per esportare oggetti salvati utilizzando l'interfaccia utente di OpenSearch gestione delle dashboard
-
Apri l'istanza OpenSearch Dashboards.
-
Nel pannello di navigazione a sinistra, scegli Gestione.
-
In Gestione dashboard, scegli Oggetti salvati.
-
Seleziona gli oggetti salvati che desideri esportare. Per esportare tutti gli oggetti di un tipo specifico, filtra per tipo utilizzando la barra di ricerca. Per esportare tutti gli oggetti, selezionate la casella di controllo nell'intestazione della tabella.
-
Scegli Export (Esporta).
-
Nella finestra di dialogo Esporta oggetti salvati, assicuratevi che sia selezionata l'opzione Includi oggetti correlati. Questa opzione include tutti gli oggetti da cui dipendono gli oggetti salvati selezionati, come i modelli di indice a cui fanno riferimento le visualizzazioni. Deselezionate questa opzione solo se intendete gestire le dipendenze manualmente.
-
Scegli Esporta per scaricare il
.ndjsonfile sul tuo computer locale.
Suggerimento
Quando scegli Includi oggetti correlati, il file NDJSON esportato contiene tutti gli oggetti salvati necessari per il rendering delle dashboard e delle visualizzazioni selezionate, inclusi i modelli di indice, le visualizzazioni e gli oggetti di ricerca dipendenti. Ciò semplifica la fase di importazione ed evita errori di riferimento mancanti.
Esportazione tramite API
Puoi utilizzare l'API di esportazione degli oggetti salvati di OpenSearch Dashboards per esportare a livello di codice gli oggetti salvati. Ciò è utile per automatizzare le migrazioni o integrare la fase di esportazione in una pipeline. CI/CD
Nota
Se il tuo OpenSearch dominio ha abilitato il controllo granulare degli accessi, devi fornire le credenziali di autenticazione con la richiesta di esportazione. Utilizza l'autenticazione di base HTTP aggiungendo il -u contrassegno con nome utente e password. Per ulteriori informazioni sulle opzioni di autenticazione, consulta Controllo granulare degli accessi in Amazon Service OpenSearch.
L'esempio seguente esporta tutti i dashboard con i relativi oggetti. Sostituisci placeholder values con le informazioni appropriate.
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
Se nel tuo dominio non è abilitato il controllo granulare degli accessi, puoi omettere il flag. -u
Per esportare oggetti salvati specifici in base all'ID, utilizza il objects parametro anziché: 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
Nota
Per trovare oggetti salvati IDs, puoi utilizzare l'API Saved Objects per elencare tutti gli oggetti di un tipo specifico. L'esempio seguente elenca tutti i dashboard:
curl -X GET \ "https://dashboards-endpoint/_dashboards/api/saved_objects/_find?type=dashboard" \ -u 'master-username:master-password'
La risposta include l'ID per ogni oggetto salvato. Puoi anche trovare l'ID nell'URL del browser quando visualizzi l'oggetto nelle OpenSearch dashboard.
Passaggio 2: Importa gli oggetti salvati nell'interfaccia utente OpenSearch
Dopo aver esportato gli oggetti salvati, puoi importare il file NDJSON nell' OpenSearch interfaccia utente manualmente o tramite API.
Importazione manuale nell'interfaccia utente OpenSearch
Per importare oggetti salvati utilizzando l' OpenSearch interfaccia utente di gestione dell'interfaccia utente
-
Apri l'applicazione OpenSearch UI e accedi all'area di lavoro di destinazione.
-
Nell'area di lavoro, scegli Risorse dalla barra di navigazione in alto o vai alla pagina delle risorse dell'area di lavoro.
-
Scegliete Importa per aprire la finestra di dialogo Importa risorse.
-
Scegliete Seleziona file e selezionate il
.ndjsonfile esportato dai OpenSearch pannelli di controllo. -
Per la gestione dei conflitti, scegli una delle seguenti opzioni:
-
Crea nuove risorse con risorse uniche IDs (impostazione predefinita): genera nuove risorse IDs per tutti gli oggetti importati, evitando conflitti con le risorse esistenti.
-
Verifica la presenza di risorse esistenti: verifica la presenza di conflitti con gli oggetti esistenti. Se selezionata, scegliete una delle seguenti opzioni secondarie:
-
Sovrascrivi automaticamente i conflitti: le risorse esistenti con lo stesso ID vengono sostituite automaticamente.
-
Richiedi un'azione in caso di conflitto: ti viene richiesto di risolvere ogni conflitto singolarmente.
-
-
-
Scegli Importa.
-
Consulta il riepilogo delle importazioni.
Importazione tramite API
Per importare oggetti salvati utilizzando l'API con autenticazione AWS Signature Version 4, devi prima ottenere l'ID della fonte di dati, quindi utilizzarlo nella richiesta di importazione. Sostituisci placeholder values con le informazioni appropriate.
Passaggio 1: ottieni l'ID della fonte di dati per il tuo spazio di lavoro:
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"
Nota
La risposta include l'ID della fonte di dati. Puoi anche trovare l'ID dell'origine dati nell'URL del browser quando visualizzi l'origine dati nell' OpenSearch interfaccia utente.
Passaggio 2: Importa gli oggetti salvati utilizzando l'ID dell'origine dati dal passaggio 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"
Nota
Questi esempi utilizzano l'--aws-sigv4opzione integrata di curl (disponibile in curl 7.75 o versioni successive) per firmare le richieste. Imposta AWS
le tue credenziali come variabili di ambiente prima di eseguire i comandi:AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY, e AWS_SESSION_TOKEN (se usi credenziali temporanee).
