Creare e caricare manualmente le tabelle di dati

Migration Center ti consente di caricare tabelle di dati che compili manualmente utilizzando i modelli forniti. Questa opzione è utile se la tua infrastruttura ha un numero limitato di asset e vuoi creare manualmente i dati.

Per creare e caricare manualmente le tabelle di dati:

  1. Scarica i modelli dall'elenco dei modelli disponibili.
  2. Compila manualmente le tabelle con i dati della tua infrastruttura.
  3. Carica le tabelle nel Migration Center.

Limitazioni

  • La dimensione massima per il caricamento di un file è 100 MB.

Modelli di dati disponibili

La seguente tabella fornisce i modelli di file che puoi utilizzare per caricare i dati dell'infrastruttura nel Migration Center. I modelli contengono dati di esempio come suggerimento su come compilare la tabella. Per una descrizione dettagliata del formato dei dati richiesto, vedi Specifiche dei file di importazione.

Nome file Tipo di dati Descrizione
vmInfo.csv Informazioni sul computer Utilizza questo modello per fornire informazioni sulle singole risorse, inclusi 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 delle tue risorse in un formato di serie temporale.
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 attributi chiave-valore alle tue risorse Amazon Web Services (AWS). Gli attributi sono formattati come "tag:KEY" : "VALUE". Ad esempio, "tag:Name" : "AWS-example".

Per saperne di più sulle specifiche di ogni file, consulta Specifiche dei file di importazione.

Caricare le tabelle

Per caricare i file:

Console

  1. Vai alla pagina Importazione dati.

    Vai a Importazione dati

  2. Fai clic su Aggiungi dati > Carica file.

  3. Nella sezione Configura caricamento file, inserisci il nome del caricamento file.

  4. Nell'elenco Formato file, seleziona Modelli CSV compilati manualmente.

  5. Fai clic su Seleziona i file da caricare, poi seleziona tutti i file che vuoi caricare.

  6. Per confermare e iniziare a caricare i file, fai clic su Carica file.

  7. Se i file vengono convalidati correttamente, per creare gli asset dai file, fai clic su Importa dati, quindi su Conferma.

API

  1. 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 in cui creare il job di importazione.
    • REGION: la 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.

  2. (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

  3. 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 dati
    • IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_MANUAL_CSV

  4. Scarica il file di dati.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID

  5. Copia l'URL dal campo signedUrl della risposta.

  6. 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 precedenti.

  7. (Facoltativo) Ripeti i passaggi 3-6 per creare altri file di dati nello stesso job di importazione.

  8. (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

  9. Convalida il job di importazione.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate

  10. 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 i file specifici, il che potrebbe richiedere l'eliminazione dei file o il caricamento di nuovi.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID

  11. Esegui il job di importazione.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run

  12. Recupera 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 è andato a buon fine 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.

Esaminare il caricamento

Dopo aver caricato i file, Migration Center li convalida per verificare che siano formalmente corretti. Se la convalida ha esito positivo, Migration Center elabora i dati per creare nuovi asset o aggiornare quelli esistenti. Puoi controllare lo stato dei job di caricamento dalla console Google Cloud .

Per controllare lo stato del job di caricamento:

  1. Vai alla pagina Importazione dati, poi fai clic su Caricamenti di file.
  2. Dall'elenco delle importazioni di file, seleziona il caricamento che vuoi esaminare.
  3. Nella pagina di caricamento dei file, in Avanzamento dell'importazione dati, controlla 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 l'importazione.
  • In attesa. Il tuo file è in attesa del completamento dell'elaborazione di un altro file.
  • Corsa. 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 e prova a caricare di nuovo il file.
  • Operazione non riuscita. Impossibile importare il file.

Rivedi i dettagli dell'errore

Se riscontri 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:

  1. Vai alla pagina Importazione dati, poi fai clic su Caricamenti di file.
  2. 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 nuove risorse o aggiornare quelle esistenti con le nuove modifiche. Per correggere l'errore, modifica i file e crea un nuovo job di importazione per caricarli di nuovo.

Per ulteriori informazioni sui possibili messaggi di errore, vedi Risolvere i problemi relativi agli errori di importazione dei file.

Specifiche dei file di importazione

Le tabelle seguenti 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 dei 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 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 nel 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 di 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).

perfInfo file

Colonna Tipo previsto Descrizione
MachineId string L'identificatore univoco della macchina virtuale.
TimeStamp Il timestamp di raccolta del campione.
CpuUtilizationPercentage float La percentuale della capacità totale della CPU utilizzata. Deve essere compreso nell'intervallo 0-100.
MemoryUtilizationPercentage float Percentuale di memoria di sistema utilizzata. Deve essere compreso nell'intervallo 0-100.
UtilizedMemoryBytes float La memoria totale utilizzata in byte.
DiskReadOperationsPerSec float La media degli IOPS campionata in un breve periodo di tempo.
DiskWriteOperationsPerSec float La media degli IOPS campionata in un breve periodo di tempo.
NetworkBytesPerSecSent float L'uscita di rete media in B/s, campionata in un breve periodo di tempo.
NetworkBytesPerSecReceived float L'ingresso medio nella rete in B/s, campionato in un breve periodo di tempo.

File tagInfo

Colonna Tipo previsto Descrizione
Chiave string La chiave dell'attributo.
Valore string Il valore dell'attributo.

Passaggi successivi