Im Migrationscenter können Sie Datentabellen hochladen, die Sie manuell mithilfe der bereitgestellten Vorlagen ausfüllen. Dies ist nützlich, wenn Ihre Infrastruktur eine begrenzte Anzahl von Assets hat und Sie die Daten manuell erstellen möchten.
Führen Sie die folgenden Schritte aus, um die manuell ausgefüllten Tabellen zu importieren:
- Laden Sie die Vorlagen aus der Liste der verfügbaren Vorlagen herunter.
- Sie können die Tabellen manuell mit den Daten aus Ihrer Infrastruktur füllen.
- Laden Sie die Tabellen in das Migrationscenter hoch.
Beschränkungen
- Die maximale Größe für einen Datei-Upload beträgt 100 MB.
Verfügbare Datenvorlagen
In der folgenden Tabelle finden Sie die Dateivorlagen, mit denen Sie Ihre Infrastrukturdaten in das Migrationscenter hochladen können. Die Vorlagen enthalten Beispieldaten als Vorschlag zum Ausfüllen der Tabelle. Eine ausführliche Beschreibung des erforderlichen Datenformats finden Sie unter Spezifikationen für Importdateien.
Dateiname | Datentyp | Beschreibung |
---|---|---|
vmInfo.csv | Gerätedaten | Verwenden Sie diese Vorlage, um Informationen zu einzelnen Assets wie CPU, Arbeitsspeicher und anderer Konfigurationsparameter bereitzustellen. Diese Tabelle wird jedes Mal benötigt, wenn Sie einen neuen Import erstellen. |
perfInfo.csv | Leistungsdaten | Optional: Verwenden Sie diese Vorlage, um Leistungsdaten für Ihre Assets im Zeitreihenformat bereitzustellen. |
diskInfo.csv | Laufwerksdaten | Optional: Verwenden Sie diese Vorlage, um Informationen zu Laufwerken und ihrer Nutzung bereitzustellen. |
tagInfo.csv | System-Tags | Optional: Verwende diese Vorlage, um den Assets Labels zuzuweisen. Labels müssen den Anforderungen für Labels in Google Cloud entsprechen. |
Weitere Informationen zu den Spezifikationen für jede Datei finden Sie unter Spezifikationen für Importdateien.
Tabellen hochladen
So laden Sie die Dateien hoch:
Console
Rufen Sie die Seite Datenimport auf.
Klicken Sie auf Daten hinzufügen > Dateien hochladen.
Geben Sie im Bereich Dateiupload einrichten den Namen der hochgeladenen Datei ein.
Wählen Sie in der Liste Dateiformat die Option Manuell ausgefüllte CSV-Vorlagen aus.
Klicken Sie auf Dateien zum Hochladen auswählen und wählen Sie dann alle Dateien aus, die Sie hochladen möchten.
Klicken Sie auf Dateien hochladen, um den Vorgang zu bestätigen und den Upload zu starten.
Wenn die Dateien korrekt validiert wurden, klicken Sie auf Daten importieren und dann auf Bestätigen, um die Assets aus den Dateien zu erstellen.
API
Erstellen Sie einen Importjob.
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" }
Ersetzen Sie Folgendes:
PROJECT_ID
: ID des Projekts, in dem der Importjob erstellt werden soll.REGION
: Region, in der der Importjob erstellt werden soll.IMPORT_JOB_ID
: ID des neuen Importjobs.SOURCE_ID
: ID einer vorhandenen Quelle, die mit dem Importjob verknüpft werden soll.
Optional: Rufen Sie den Importjob ab, um zu prüfen, ob der Importjob korrekt erstellt wurde.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Erstellen Sie eine Importdatendatei, die an den Importjob angehängt ist.
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" }
Ersetzen Sie Folgendes:
DATA_FILE_ID
: ID der neuen DatendateiIMPORT_JOB_FORMAT
:IMPORT_JOB_FORMAT_MANUAL_CSV
Rufen Sie die Datendatei ab.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
Kopieren Sie die URL aus dem Feld
signedUrl
aus der Antwort.Laden Sie eine Datei in die kopierte URL hoch.
PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
Ersetzen Sie Folgendes:
UPLOAD_FILE_PATH
: Der lokale Pfad der hochgeladenen Datei.COPIED_URL
: Die kopierte signierte URL aus den Vorschauschritten.
Optional: Wiederholen Sie die Schritte 3 bis 6, um weitere Datendateien unter demselben Importjob zu erstellen.
Optional: Rufen Sie alle Datendateien eines Importjobs ab.
GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
Validieren Sie den Importjob.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
Rufen Sie den Importjob ab und sehen Sie sich den Validierungsbericht an. Wenn der Status
READY
lautet, können Sie mit den nächsten Schritten fortfahren. Andernfalls müssen Sie den Job oder bestimmte Dateien korrigieren. Dazu müssen Sie möglicherweise Dateien löschen oder neue Dateien hochladen.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Führen Sie den Importjob aus.
POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
Rufen Sie den Importjob ab und sehen Sie sich den Ausführungsbericht an. Wenn der Status
COMPLETED
lautet, wurde der Job erfolgreich ausgeführt. Wenn der Job andernfalls fehlgeschlagen ist und sich im Terminal befindet, enthält der Ausführungsbericht die Fehler. Erstellen Sie einen neuen Importjob und wenden Sie die erforderlichen Änderungen an.GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
Wenn Probleme beim Hochladen von Dateien auftreten, lesen Sie die Informationen zur Fehlerbehebung bei häufigen Fehlermeldungen.
Upload überprüfen
Nachdem Sie Ihre Dateien hochgeladen haben, überprüft das Migrationscenter, ob sie formell korrekt sind. Wenn die Validierung erfolgreich ist, verarbeitet das Migrationscenter die Daten dann, um neue Assets zu erstellen oder vorhandene zu aktualisieren. Sie können den Status Ihrer Uploadjobs über die Google Cloud Console prüfen.
So überprüfen Sie den Status Ihres Uploadjobs:
- Rufen Sie die Seite Datenimport auf und klicken Sie auf Dateiuploads.
- Wählen Sie aus der Liste der Dateiimporte den Upload aus, den Sie prüfen möchten.
- Prüfen Sie auf der Seite „Dateiupload“ unter Fortschritt des Datenimports den Status der hochgeladenen Dateien.
Ihre Dateien können einen der folgenden Status haben.
Liste der Status
- Abgeschlossen: Die Datei wurde importiert.
- Bereit: Ihre Datei hat die Validierung bestanden und kann jetzt importiert werden.
- Ausstehend: Ihre Datei wartet, bis eine andere Datei verarbeitet wurde.
- Wird ausgeführt: Die Datei wird verarbeitet.
- Validierung: Ihre Datei befindet sich in der Überprüfungsphase.
- Validierung fehlgeschlagen. Die Datei enthält einige Fehler. Beheben Sie die Fehler und laden Sie die Datei dann noch einmal hoch.
- Fehlgeschlagen. Die Datei konnte nicht importiert werden.
Fehlerdetails ansehen
Wenn nach dem Importieren Ihrer Dateien Fehler auftreten, können Sie sich die Fehlermeldung direkt in der Google Cloud Console ansehen.
So überprüfen Sie die Fehler Ihres Uploadjobs:
- Rufen Sie die Seite Datenimport auf und klicken Sie auf Dateiuploads.
- Klicken Sie auf die Importdatei mit einer Warnung oder einem Fehler. Auf der Detailseite der Importdatei wird die vollständige Liste der Fehler angezeigt.
Auf der Detailseite der Importdatei können Sie die Assets und Datenfelder, die die Fehler verursachen, überprüfen und eine Fehlerbeschreibung sehen. Fehler im Dateiimportjob können verhindern, dass das Migrationscenter neue Assets erstellt oder vorhandene Assets mit den neuen Änderungen aktualisiert. Um den Fehler zu beheben, bearbeiten Sie die Dateien und erstellen einen neuen Dateiimportjob, um sie noch einmal hochzuladen.
Weitere Informationen zu möglichen Fehlermeldungen finden Sie unter Fehler beim Dateiimport beheben.
Spezifikationen für Importdateien
Die folgenden Tabellen enthalten die technischen Spezifikationen für die Vorlagendateien, die für den manuellen Import verwendet werden.
Datei vmInfo
Spalte | Erwarteter Typ | Beschreibung |
---|---|---|
MachineId | String | Die eindeutige Kennung der virtuellen Maschine. |
MachineName | String | Der Anzeigename der virtuellen Maschine. |
PrimaryIPAddress | String | Die IP-Adresse der Maschine. |
PrimaryMACAddress | String | Die MAC-Adresse der Maschine. Sie dient nur zur Identifizierung des Computers. |
PublicIPAddress | String | Die öffentliche IP-Adresse der Maschine. |
IpAddressListSemiColonDelimited | Liste der Nachrichten | Die Liste der zugewiesenen oder zugewiesenen Netzwerkadressen. |
TotalDiskAllocatedGiB | int64 | Die Gesamtkapazität des Laufwerks. |
TotalDiskUsedGiB | int64 | Der insgesamt genutzte Speicherplatz auf dem Laufwerk. |
MachineTypeLabel | String | Das Label des AWS- oder Azure-Maschinentyps. |
AllocatedProcessorCoreCount | int64 | Anzahl der CPU-Kerne in der virtuellen Maschine. |
MemoryGiB | int32 | Die Größe des Arbeitsspeichers der virtuellen Maschine. |
HostingLocation | String | Der Standort der Maschine im AWS- oder Azure-Format. |
OsType | String | Das Betriebssystem des Computers. |
OsName | String | Das Betriebssystem des Computers. |
OsVersion | String | Die Version des Betriebssystems des Computers. |
MachineStatus | String | Der Energiestatus der Maschine. |
ProvisioningState | String | Der Bereitstellungsstatus, nur für Azure-VMs. |
CreateDate | Zeitstempel | Der Erstellungszeitstempel der Maschine. |
IsPhysical | String | Ob die Maschine eine physische oder virtuelle Maschine ist. |
Quelle | Nachricht | Die Details der Quelle für AWS- oder Azure-Maschinen. |
Datei diskInfo
Spalte | Erwarteter Typ | Beschreibung |
---|---|---|
MachineId | String | Die eindeutige Kennung der virtuellen Maschine. |
DiskLabel | String | Die Datenträgerbezeichnung. |
SizeInGib | int64 | Die Gesamtkapazität des Laufwerks. |
UsedInGib | int64 | Der insgesamt genutzte Speicherplatz auf dem Laufwerk. |
StorageTypeLabel | String | Der Typ des Laufwerkslabels (z. B. BIOS oder GPT). |
perfInfo-Datei
Spalte | Erwarteter Typ | Beschreibung |
---|---|---|
MachineId | String | Die eindeutige Kennung der virtuellen Maschine. |
TimeStamp | Der Zeitstempel des Zeitpunkts, zu dem die Stichprobe erfasst wurde. | |
CpuUtilizationPercentage | float | Der Prozentsatz der insgesamt verwendeten CPU-Kapazität. Er muss im Intervall 0 bis 100 liegen. |
MemoryUtilizationPercentage | float | Der Prozentsatz des verwendeten Systemspeichers. Er muss im Intervall 0 bis 100 liegen. |
UtilizedMemoryBytes | float | Der insgesamt verwendete Arbeitsspeicher in Byte. |
DiskReadOperationsPerSec | float | Die durchschnittlichen IOPS, die über ein kurzes Fenster erfasst werden. |
DiskWriteOperationsPerSec | float | Die durchschnittlichen IOPS, die über ein kurzes Fenster erfasst werden. |
NetworkBytesPerSecSent | float | Durchschnittlicher ausgehender Netzwerktraffic in B/s, Stichproben über ein kurzes Zeitfenster. |
NetworkBytesPerSecReceived | float | Der durchschnittliche eingehende Netzwerktraffic in B/s, Stichproben über ein kurzes Zeitfenster. |
TagInfo-Datei
Spalte | Erwarteter Typ | Beschreibung |
---|---|---|
MachineId | String | Die eindeutige Kennung der virtuellen Maschine. |
Schlüssel | String | Labelschlüssel |
Wert | String | Der Labelwert. |
Parsing-Algorithmus für Labels
Die Labels, die Sie mit der Datei „tagInfo“ hochladen, müssen den Anforderungen für Labels in Google Cloud entsprechen. Wenn das Label nicht den Anforderungen entspricht, verwendet das Migrationscenter die folgende Strategie zum Konvertieren des Labels:
- Nur bei Schlüsseln werden alle führenden Zeichen entfernt, die keine Buchstaben des englischen Alphabets sind.
- Dabei werden alle Großbuchstaben durch Kleinbuchstaben ersetzt.
- Es ersetzt alle ungültigen Zeichen durch Unterstriche (
_
). - Das Label wird auf maximal 62 Zeichen gekürzt.
- Sie fügt das Suffix
_<CRC32>
hinzu, das auf der Grundlage des ursprünglichen Strings berechnet wurde.
Bei jeder Konvertierung eines Labels wird eine Warnmeldung angezeigt.
Wenn die Validierung fehlschlägt oder der Schlüssel bereits vorhanden ist, wird die Zeile beim Import übersprungen und eine Warnmeldung wird angezeigt.
Nächste Schritte
- Weitere Informationen zu Sammlungsmethoden des Migrationscenters
- Informationen zum Verwalten von Dateiuploads