Il Centro di migrazione ti consente di caricare tabelle di dati che compili manualmente utilizzando i modelli forniti. Questa operazione è utile se la tua infrastruttura ha un numero limitato di asset e vuoi creare manualmente i dati.
Per importare le tabelle compilate manualmente:
- Scarica i modelli dall'elenco dei modelli disponibili.
- Compila manualmente le tabelle con i dati della tua infrastruttura.
- Carica le tabelle nel Migration Center.
Limitazioni
- La dimensione massima per il caricamento di un file è 100 MB.
Modelli di dati disponibili
La tabella seguente fornisce i modelli di file che puoi utilizzare per caricare i dati dell'infrastruttura nel Centro di migrazione. I modelli contengono dati di esempio come suggerimento su come compilare la tabella. Per una descrizione dettagliata del formato dei dati richiesto, consulta Specifiche dei file di importazione.
Nome file | Tipo di dati | Descrizione |
---|---|---|
vmInfo.csv | Informazioni sulla macchina | 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 i dati sul rendimento dei tuoi asset in un formato di serie temporali. |
diskInfo.csv | Dati del 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 le etichette alle risorse. Le etichette devono rispettare i requisiti per le etichette in Google Cloud. |
Per ulteriori informazioni sulle specifiche di ciascun file, consulta Specifiche per l'importazione dei file.
Carica le tabelle
Per caricare i file:
Console
Vai alla pagina Importazione dati.
Fai clic su Aggiungi dati > Carica file.
Nella sezione Configura il caricamento dei file, inserisci il nome del caricamento dei file.
Nell'elenco Formato file, seleziona Modelli CSV compilati manualmente.
Fai clic su Seleziona file da caricare, poi seleziona tutti i file che vuoi caricare.
Per confermare e avviare il caricamento dei file, fai clic su Carica file.
Se i file sono 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
: l'ID del progetto per creare il lavoro di importazione.REGION
: regione per creare il job di importazione.IMPORT_JOB_ID
: l'ID del nuovo job di importazione.SOURCE_ID
: l'ID di un'origine esistente da associare al job di importazione.
(Facoltativo) Per verificare che il job di importazione sia stato creato correttamente, recuperalo.
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
signedUrl
della 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 caricato.COPIED_URL
: l'URL firmato copiato dai passaggi di anteprima.
(Facoltativo) Ripeti i passaggi da 3 a 6 per creare altri file di dati nello stesso job di importazione.
(Facoltativo) Recupera 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
Recupera il job di importazione e visualizza il report di convalida. Se lo stato è
READY
, puoi continuare con i passaggi successivi. In caso contrario, devi correggere il job o file specifici, il che potrebbe richiedere la cancellazione di file o il caricamento di 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
Ottieni il job di importazione e visualizza il report di esecuzione. Se lo stato è
COMPLETED
, il job è stato eseguito correttamente. In caso contrario, se il job non è riuscito ed è in uno stato di terminazione, 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, il Centro migrazione li convalida per verificare che siano formalmente corretti. Se la convalida va a buon fine, Migration Center elabora i dati per creare nuovi asset o aggiornare quelli esistenti. Puoi controllare lo stato dei job di caricamento nella console Google Cloud.
Per controllare lo stato del job di caricamento:
- Vai alla pagina Importazione dati e fai clic su Caricamenti 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, esamina lo stato dei file caricati.
Puoi visualizzare i tuoi file in uno dei seguenti stati.
Elenco di stati
- Completato. L'importazione del file è andata a buon fine.
- Pronto. 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. È in corso l'elaborazione del file.
- Convalida. Il tuo 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. Non è stato possibile importare il file.
Rivedi i dettagli dell'errore
Se riscontri errori dopo aver importato i file, puoi esaminare il messaggio di errore direttamente nella console Google Cloud.
Per esaminare gli errori del job di caricamento:
- Vai alla pagina Importazione dati e fai clic su Caricamenti 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 di dati che causano gli errori e visualizzare una descrizione dell'errore. Gli errori nel job di importazione dei file potrebbero impedire a Migration Center 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 dei file per caricarli nuovamente.
Per ulteriori informazioni sui possibili messaggi di errore, consulta Risolvere i problemi di importazione dei file.
Specifiche dei file di importazione
Le tabelle riportate di seguito mostrano le specifiche tecniche dei 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 di messaggi | L'elenco degli indirizzi di rete allocati o assegnati. |
TotalDiskAllocatedGiB | int64 | La capacità totale del disco. |
TotalDiskUsedGiB | int64 | La quantità totale di spazio utilizzato sul disco. |
MachineTypeLabel | string | L'etichetta del tipo di macchina AWS o Azure. |
AllocatedProcessorCoreCount | int64 | Numero di core della 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 sul 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 | Il timestamp del momento in cui è stato raccolto il campione. | |
CpuUtilizationPercentage | float | La percentuale di capacità totale della CPU utilizzata. Deve essere compreso tra 0 e 100. |
MemoryUtilizationPercentage | float | La percentuale di memoria di sistema utilizzata. 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 | L'esportazione di rete media in B/s, campionata in un breve intervallo di tempo. |
NetworkBytesPerSecReceived | float | La larghezza di banda in entrata nella rete media in B/s, campionata in un breve intervallo di tempo. |
file tagInfo
Colonna | Tipo previsto | Descrizione |
---|---|---|
MachineId | string | L'identificatore univoco della macchina virtuale. |
Chiave | string | La chiave dell'etichetta. |
Valore | string | Il valore dell'etichetta. |
Algoritmo di analisi per le etichette
Le etichette caricate con il file tagInfo devono rispettare i requisiti per le etichette in Google Cloud. Se l'etichetta non è conforme ai requisiti, il Centro migrazione utilizza la seguente strategia per convertirla:
- Solo per le chiavi, vengono rimossi 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 (
_
). - L'etichetta viene troncata a un massimo di 62 caratteri.
- Aggiunge il suffisso
_<CRC32>
, calcolato in base alla stringa originale.
Viene visualizzato un messaggio di avviso ogni volta che viene convertita un'etichetta.
Se la convalida non va a buon fine o se la chiave esiste già, l'importazione salta la riga e viene visualizzato un messaggio di avviso.
Passaggi successivi
- Scopri di più sui metodi di raccolta di Migration Center.
- Scopri come gestire i caricamenti dei file.