Il Centro di migrazione consente di caricare le tabelle di dati da compilare manualmente utilizzando i modelli forniti. Ciò è utile se la tua infrastruttura ha un numero limitato di asset e vuoi creare i dati manualmente.
Per importare le tabelle compilate manualmente, segui questi passaggi:
- Scarica i modelli dall'elenco di modelli disponibili.
- Compila manualmente le tabelle con i dati della tua infrastruttura.
- Carica le tabelle in Migration Center.
Limitazioni
- La dimensione massima per un caricamento di file è 100 Mb.
Modelli di dati disponibili
La tabella seguente fornisce i modelli di file che puoi utilizzare per caricare i dati dell'infrastruttura in Migration Center. I modelli contengono dati di esempio come suggerimento su come compilare la tabella. Per una descrizione dettagliata del formato dei dati richiesto, consulta le specifiche dei file di importazione.
| Nome file | Tipo di dati | Descrizione |
|---|---|---|
| vmInfo.csv | Informazioni sul computer | Utilizza questo modello per fornire informazioni sui singoli asset, tra cui CPU, memoria e altri parametri di configurazione. Questa tabella è obbligatoria ogni volta che crei una nuova importazione. |
| perfInfo.csv | Dati prestazioni | (Facoltativo) Utilizza questo modello per fornire dati sul rendimento degli asset in formato serie temporale. |
| diskInfo.csv | Dati disco | (Facoltativo) Utilizza questo modello per fornire informazioni sui dischi e sul loro utilizzo. |
| tagInfo.csv | Tag di sistema | (Facoltativo) Utilizza questo modello per assegnare etichette alle risorse. Le etichette devono rispettare i requisiti per le etichette in Google Cloud. |
Per ulteriori informazioni sulle specifiche di ciascun file, vedi Importare le specifiche dei file.
Carica le tabelle
Per caricare i file, segui questi passaggi:
Console
Vai alla pagina Importazione dati.
Fai clic su Aggiungi dati > Carica file.
Nella sezione Configura caricamento file, inserisci il nome del caricamento file.
Nell'elenco Formato file, seleziona Modelli CSV compilati manualmente.
Fai clic su Seleziona i file da caricare, poi seleziona tutti i file che vuoi caricare.
Per confermare e iniziare a caricare i file, fai clic su Carica file.
Se i file vengono convalidati correttamente, per creare gli asset dai file fai clic su Importa dati e poi su Conferma.
API
Crea un job di importazione.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID { "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID" }Sostituisci quanto segue:
PROJECT_ID: ID del progetto per creare il job di importazione.REGION: regione in cui creare il job di importazione.IMPORT_JOB_ID: ID del nuovo job di importazione.SOURCE_ID: ID di un'origine esistente da associare al job di importazione.
Facoltativo: per confermare che il job di importazione è stato creato correttamente, scarica il job di importazione.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Crea un file di dati di importazione allegato al job di importazione.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID { "format": "IMPORT_JOB_FORMAT" }Sostituisci quanto segue:
DATA_FILE_ID: ID del nuovo file di datiIMPORT_JOB_FORMAT:IMPORT_JOB_FORMAT_MANUAL_CSV
Recupera il file di dati.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
Copia l'URL dal campo
signedUrldella risposta.Carica un file nell'URL copiato.
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
Sostituisci quanto segue:
UPLOAD_FILE_PATH: il percorso locale del file che viene caricato.COPIED_URL: l'URL firmato copiato dai passaggi dell'anteprima.
(Facoltativo) Ripeti i passaggi 3-6 per creare altri file di dati nello stesso job di importazione.
(Facoltativo) Ottieni tutti i file di dati di un job di importazione.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
Convalida il job di importazione.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Scarica il job di importazione e visualizza il report di convalida. Se lo stato è
READY, è possibile continuare con i passaggi successivi. In caso contrario, dovrai correggere il job o file specifici e potresti dover eliminare o caricare nuovi file.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Esegui il job di importazione.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Recupera il job di importazione e visualizza il report sull'esecuzione. Se lo stato è
COMPLETED, il job è stato eseguito correttamente. Altrimenti, se il job non è riuscito e si trova in uno stato terminale, il report di esecuzione include gli errori. Crea un nuovo job di importazione e applica le modifiche necessarie.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Se riscontri problemi con il caricamento del file, scopri come risolvere i problemi relativi ai messaggi di errore comuni.
Rivedi il caricamento
Dopo aver caricato i file, Migration Center li convalida per verificare che siano formalmente corretti. Se la convalida ha esito positivo, il Centro di migrazione elabora i dati per creare nuovi asset o aggiornare quelli esistenti. Puoi controllare lo stato dei job di caricamento dalla console Google Cloud.
Per esaminare lo stato del processo di caricamento:
- Vai alla pagina Importazione dati e poi fai clic su Caricamenti di file.
- Dall'elenco delle importazioni di file, seleziona il caricamento che vuoi esaminare.
- Nella pagina di caricamento dei file, in Avanzamento dell'importazione dei dati, controlla lo stato dei file caricati.
Puoi visualizzare i file in uno dei seguenti stati.
Elenco di stati
- Completato. Importazione del file riuscita.
- Inizia. Il file ha superato la convalida ed è pronto per essere importato.
- In attesa. Il tuo file è in attesa del completamento dell'elaborazione di un altro file.
- In esecuzione. Il file è in fase di elaborazione.
- Convalida in corso.... Il file è in fase di convalida.
- Convalida non riuscita. Il file contiene alcuni errori. Correggi gli errori, quindi prova a caricare di nuovo il file.
- Non riuscita. Impossibile importare il file.
Rivedi i dettagli dell'errore
Se si verificano errori dopo aver importato i file, puoi esaminare il messaggio di errore direttamente nella console Google Cloud.
Per esaminare gli errori del processo di caricamento:
- Vai alla pagina Importazione dati e poi fai clic su Caricamenti di file.
- Fai clic sul file di importazione che mostra un avviso o un errore. La pagina dei dettagli del file di importazione mostra l'elenco completo degli errori.
Nella pagina dei dettagli del file di importazione, puoi esaminare gli asset e i campi dei dati che causano gli errori e visualizzare una descrizione dell'errore. Gli errori nel job di importazione file potrebbero impedire al Centro di migrazione di creare nuovi asset o aggiornare quelli esistenti con le nuove modifiche. Per correggere l'errore, modifica i file e crea un nuovo job di importazione di file per caricarli di nuovo.
Per ulteriori informazioni sui possibili messaggi di errore, consulta Risolvere gli errori di importazione dei file.
Specifiche dei file per l'importazione
Le seguenti tabelle mostrano le specifiche tecniche per i file modello utilizzati per l'importazione manuale.
File vmInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| MachineName | string | Il nome visualizzato della macchina virtuale. |
| PrimaryIPAddress | string | L'indirizzo IP della macchina. |
| PrimaryMACAddress | string | L'indirizzo MAC della macchina. Viene utilizzato solo per identificare la macchina. |
| PublicIPAddress | string | L'indirizzo IP pubblico della macchina. |
| IpAddressListSemiColonDelimited | Elenco dei messaggi | L'elenco di indirizzi di rete allocati o assegnati. |
| TotalDiskAllocatedGiB | int64 | La capacità totale del disco. |
| TotalDiskUsedGiB | int64 | La quantità totale di spazio utilizzato nel disco. |
| MachineTypeLabel | string | L'etichetta del tipo di macchina AWS o Azure. |
| AllocatedProcessorCoreCount | int64 | Numero di core CPU nella macchina virtuale. |
| MemoryGiB | int32 | La quantità di memoria della macchina virtuale. |
| HostingLocation | string | La posizione della macchina in formato AWS o Azure. |
| OsType | string | Il sistema operativo della macchina. |
| OsName | string | Il sistema operativo della macchina. |
| OsVersion | string | La versione del sistema operativo della macchina. |
| MachineStatus | string | Lo stato di alimentazione della macchina. |
| ProvisioningState | string | Lo stato del provisioning, solo per le VM Azure. |
| CreateDate | Timestamp | Il timestamp di creazione della macchina. |
| IsPhysical | string | Se la macchina è fisica o virtuale. |
| Origine | messaggio | I dettagli dell'origine per le macchine AWS o Azure. |
File diskInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| DiskLabel | string | L'etichetta del disco. |
| SizeInGib | int64 | La capacità totale del disco. |
| UsedInGib | int64 | La quantità totale di spazio utilizzato nel disco. |
| StorageTypeLabel | string | Il tipo di etichetta del disco (ad esempio BIOS o GPT). |
file perfInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| TimeStamp | Timestamp di raccolta del campione. | |
| CpuUtilizationPercentage | float | La percentuale della capacità totale della CPU utilizzata. Il valore deve essere compreso tra 0 e 100. |
| MemoryUtilizationPercentage | float | La percentuale di memoria di sistema utilizzata. Il valore deve essere compreso tra 0 e 100. |
| UtilizedMemoryBytes | float | La memoria totale utilizzata in byte. |
| DiskReadOperationsPerSec | float | Le IOPS medie campionate in un breve periodo di tempo. |
| DiskWriteOperationsPerSec | float | Le IOPS medie campionate in un breve periodo di tempo. |
| NetworkBytesPerSecSent | float | Il traffico di rete in uscita medio in B/s, campionato in un breve periodo. |
| NetworkBytesPerSecReceived | float | Il traffico di rete in entrata medio in B/s, campionato in una finestra breve. |
file tagInfo
| Colonna | Tipo previsto | Descrizione |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| Chiave | string | La chiave di etichetta. |
| Valore | string | Il valore dell'etichetta. |
Algoritmo di analisi per le etichette
Le etichette caricate con il file tagInfo devono seguire i requisiti per le etichette in Google Cloud. Se l'etichetta non è conforme ai requisiti, il Centro di migrazione utilizza la seguente strategia per convertirla:
- Solo per le chiavi, rimuove tutti i caratteri iniziali che non sono lettere dell'alfabeto inglese.
- Sostituisce tutte le lettere maiuscole con lettere minuscole.
- Sostituisce tutti i caratteri non validi con trattini bassi (
_). - Tronca l'etichetta a un massimo di 62 caratteri.
- Aggiunge il suffisso
_<CRC32>, calcolato in base alla stringa originale.
Ogni volta che un'etichetta viene convertita viene visualizzato un messaggio di avviso.
Se la convalida non riesce o se la chiave esiste già, l'importazione ignora la riga e viene visualizzato un messaggio di avviso.
Passaggi successivi
- Scopri di più sui metodi di raccolta del Centro di migrazione.
- Scopri come gestire i caricamenti di file.