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 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 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 i 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 in cui 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
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 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 dall'apposita pagina della console Google Cloud.
Per controllare lo stato del job di caricamento:
- Vai alla pagina Importazione dati e fai clic su Caricamenti file.
- Nell'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 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 che carichi 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 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.