Il Centro di migrazione consente di caricare tabelle di dati compilate manualmente utilizzando i modelli forniti. Ciò è utile se l'infrastruttura ha un numero limitato di asset e vuoi creare manualmente i dati.
Per importare le tabelle compilate manualmente, svolgi i seguenti passaggi:
- Scarica i modelli dall'elenco dei modelli disponibili.
- Compila manualmente le tabelle con i dati della tua infrastruttura.
- Carica le tabelle nel Centro di migrazione.
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 | Description |
|---|---|---|
| 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 sulle prestazioni dei tuoi asset in formato serie temporale. |
| diskInfo.csv | Dati disco | (Facoltativo) Utilizza questo modello per fornire informazioni sui dischi e sul relativo utilizzo. |
| tagInfo.csv | Tag di sistema | (Facoltativo) Utilizza questo modello per assegnare etichette alle risorse. Le etichette devono seguire i requisiti per le etichette in Google Cloud. |
Per ulteriori informazioni sulle specifiche di ciascun file, consulta Specifiche dei file di importazione.
Carica le tabelle
Per caricare i file:
Console
Vai alla pagina Importazione dati.
Fai clic su Aggiungi dati. Si apre una nuova pagina.
Seleziona Carica file e poi, in Imposta il caricamento di file, inserisci il nome del file caricato.
Seleziona Modelli CSV compilati manualmente dall'elenco.
Fai clic su Seleziona i file da caricare, quindi seleziona tutti i file che vuoi caricare.
Per confermare e iniziare il caricamento dei file, fai clic su Carica file.
Se i file vengono convalidati correttamente, per creare gli asset a partire 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 sia 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
signedUrldalla 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 3-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, è possibile continuare con i passaggi successivi. In caso contrario, devi correggere il job o file specifici, ciò potrebbe richiedere l'eliminazione 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
Scarica il job di importazione e visualizza il report di esecuzione. Se lo stato è
COMPLETED, il job è stato eseguito correttamente. Altrimenti, se il job non è riuscito e in stato di 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
In caso di problemi con il caricamento di file, scopri come risolvere i messaggi di errore più comuni.
Rivedi il caricamento
Dopo aver caricato i file, il Centro di migrazione li convalida per verificare se sono 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 fai clic su Caricamenti di file.
- Nell'elenco delle importazioni di file, seleziona il caricamento che vuoi esaminare.
- Nella pagina di caricamento del file, in Avanzamento importazione dati, controlla lo Stato dei file caricati.
Puoi visualizzare i file in uno dei seguenti stati.
Elenco di stati
- Completato. L'importazione del file è riuscita.
- Pronti. 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. Il file è in fase di convalida.
- Convalida non riuscita. Il file contiene alcuni errori. Correggi gli errori, quindi prova a caricare nuovamente il file.
- Non riuscita. Impossibile importare il file.
Esamina i dettagli dell'errore
Se si verificano errori dopo l'importazione dei 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 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 di dati che causano gli errori, nonché 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 file per caricarli di nuovo.
Per ulteriori informazioni sui possibili messaggi di errore, consulta Risolvere gli errori di importazione dei file.
Specifiche dei file di importazione
Le seguenti tabelle mostrano le specifiche tecniche dei file modello utilizzati per l'importazione manuale.
File vmInfo
| Colonna | Tipo previsto | Description |
|---|---|---|
| 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. Questo 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 assegnati 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 località 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 è una macchina fisica o virtuale. |
| Origine | messaggio | I dettagli dell'origine per le macchine AWS o Azure. |
File diskInfo
| Colonna | Tipo previsto | Description |
|---|---|---|
| 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 | Description |
|---|---|---|
| MachineId | string | L'identificatore univoco della macchina virtuale. |
| TimeStamp | Il timestamp di raccolta del campione. | |
| CpuUtilizationPercentage | float | La percentuale di capacità totale della CPU utilizzata. Deve essere compreso nell'intervallo 0-100. |
| MemoryUtilizationPercentage | float | La percentuale di memoria di sistema utilizzata. Deve essere compreso nell'intervallo 0-100. |
| UtilizedMemoryBytes | float | La memoria totale utilizzata in byte. |
| DiskReadOperationsPerSec | float | Le IOPS medie campionate in una finestra breve. |
| DiskWriteOperationsPerSec | float | Le IOPS medie campionate in una finestra breve. |
| NetworkBytesPerSecSent | float | Il traffico di rete in uscita medio in B/s, campionato in un periodo breve. |
| NetworkBytesPerSecReceived | float | Il traffico di rete medio in entrata in B/s, campionato in una finestra breve. |
File tagInfo
| Colonna | Tipo previsto | Description |
|---|---|---|
| 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 i tasti, 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 (
_). - 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 va a buon fine 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.