Empfehlungen für Maschinentypen konfigurieren

Auf dieser Seite wird beschrieben, wie Sie die Konfiguration Ihrer Empfehlungen zu Maschinentypen aufrufen und ändern. Sie können festlegen, welche Maschinentypen empfohlen werden sollen, damit die generierten Empfehlungen nur Ihre bevorzugte Maschinenserie enthalten. Sie können auch die Messwerte ändern, die zum Generieren von Speicherempfehlungen verwendet werden, um die Genauigkeit der Empfehlungen zu verbessern. Die Änderungen an der Konfiguration werden auf Projektebene angewendet.

Weitere Informationen zu Empfehlungen für Maschinentypen finden Sie unter Empfehlungen für Maschinentypen für VMs anwenden.

Hinweis

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute Recommender Admin (roles/recommender.computeAdmin) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ändern von Empfehlungen für Maschinentypen benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Ändern von Empfehlungen für den Maschinentyp erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Empfehlungen für den Maschinentyp zu ändern:

  • Konfiguration der Empfehlung für Maschinentypen aufrufen: recommender.computeInstanceMachineTypeRecommenderConfig.get im Projekt
  • Konfigurieren Sie die Empfehlung für den Maschinentyp: recommender.computeInstanceMachineTypeRecommenderConfig.update für das Projekt

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Empfehlungen konfigurieren

So konfigurieren Sie Empfehlungen für den Maschinentyp:

  1. Rufen Sie die aktuelle Konfiguration ab, um die JSON-Datei der Konfiguration zu erhalten.
  2. Bearbeiten Sie die Konfigurationsdatei im JSON-Format.
  3. Neue Konfigurationsdatei hochladen um die Änderungen zu übernehmen.

Aktuelle Konfiguration abrufen

Sie können die aktuelle Konfiguration der Empfehlungen für Maschinentypen für Ihr Projekt über die Google Cloud CLI abrufen.

gcloud

Verwenden Sie den Befehl gcloud beta recommender recommender-config describe und geben Sie google.compute.instance.MachineTypeRecommender als Recommender-ID an, um die aktuellen Konfigurationsparameter abzurufen:

gcloud beta recommender recommender-config describe google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID.
  • ZONE: die Zone, für die Sie die aktuelle Konfiguration abrufen möchten.

Der Befehl gibt die Recommender-Konfiguration zurück, einschließlich der änderbaren Unterfelder preferred_machine_types und memory_metrics.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_AND_CUSTOM",
      "memory_metrics": "MONITORING_AGENT_ONLY"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-08-20T04:41:15.330351Z"
}

Wenn Sie die Konfiguration in einer lokalen Datei speichern möchten, damit Sie sie später bearbeiten und hochladen können, führen Sie den folgenden Befehl aus:

gcloud beta recommender recommender-config describe \
  google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE > LOCAL_FILE_PATH_AND_NAME

Empfehlungskonfiguration bearbeiten

In der Konfiguration können Sie die folgenden Parameter anpassen:

  • preferred_machine_types: Die Empfehlungen zu Maschinentypen, die Sie erhalten.
  • memory_metrics: Wie Arbeitsspeichermesswerte zur Generierung von Empfehlungen verwendet werden.

Optionen für Empfehlungen zu Maschinentypen

Sie können festlegen, welche Empfehlungen für Maschinentypen Sie erhalten, indem Sie die Einstellung preferred_machine_types auf einen der folgenden Werte ändern:

  • DEFAULT: Der Standardwert ist STANDARD_AND_CUSTOM.
  • STANDARD_AND_CUSTOM: Empfiehlt die beste Übereinstimmung aus Standard- und benutzerdefinierten Maschinentypen.
  • STANDARD_ONLY: Es wird nur die beste Übereinstimmung aus Standardmaschinentypen empfohlen.

Optionen für Speicherempfehlungen

Für die Speichermesswerte, die zur Generierung der Empfehlungen verwendet werden, können Sie die folgenden Werte festlegen:

  • MEMORY_METRICS_DEFAULT: Mit den Standardmesswerten Empfehlungen generieren.
  • MEMORY_METRICS_ALL: Verwenden Sie alle verfügbaren Messwerte, um Empfehlungen zu generieren.
  • MONITORING_AGENT_ONLY: Verwenden Sie nur Messwerte, die vom Cloud Monitoring-Ops-Agent erfasst wurden.
  • Wenn Sie den Ops-Agenten nicht verwenden und keine Speicherempfehlungen erhalten möchten, können Sie den Wert MEMORY_AGENT_ONLY verwenden, um die Empfehlungen zu deaktivieren.

Wenn Sie genauere Empfehlungen zur Speichernutzung erhalten möchten, verwenden Sie den Ops-Agent.

Konfiguration für ein Projekt aktualisieren

Wenn Sie die Konfiguration der Empfehlungen zu Maschinentypen aktualisieren möchten, ändern Sie die Konfigurationswerte und laden Sie die neue Konfiguration für Ihr Projekt hoch. Sie können die bevorzugten Maschinentypen, die für Empfehlungen verwendeten Arbeitsspeichermesswerte oder beide Werte in derselben Anfrage ändern.

Nachdem Sie die neue Konfiguration hochgeladen haben, dauert es etwa 48 Stunden, bis sie wirksam wird. Bis dahin verwenden alle generierten Empfehlungen die vorherige Konfiguration.

gcloud

Verwenden Sie zum Aktualisieren der Konfigurationsparameter den Befehl gcloud beta recommender recommender-config update und geben Sie google.compute.instance.MachineTypeRecommender als Recommender-ID an:

gcloud beta recommender recommender-config update google.compute.instance.MachineTypeRecommender\
  --project=PROJECT_ID \
  --location=ZONE \
  --config-file=LOCAL_FILE_PATH_AND_NAME \
  --etag=ETAG

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID.
  • ZONE: die Zone, für die Sie die aktuelle Konfiguration abrufen möchten.
  • LOCAL_FILE_PATH_AND_NAME: der Pfad zur JSON-Datei mit der aktuellen Konfiguration
  • ETAG: der ETag-Wert der aktuellen Konfiguration. Sie finden diesen Wert in der Ausgabe des vorherigen Befehls.

Geben Sie in Ihrer Konfigurationsdatei nur das Objekt recommenderGenerationConfig mit den aktualisierten Konfigurationsparametern an. Wenn Sie die Konfiguration in einer lokalen Datei gespeichert haben, kopieren Sie den Wert etag und entfernen Sie alle Felder mit Ausnahme des Werts recommenderGenerationConfig.

Wenn Sie beispielsweise nur Empfehlungen für Standardmaschinentypen erhalten möchten, verwenden Sie die folgende Konfigurationsdatei:

{
  "params": {
    "preferred_machine_types": "STANDARD_ONLY"
  }
}

Wenn der Befehl erfolgreich ausgeführt wurde, wird ein Antworttext ähnlich dem folgenden zurückgegeben. Dieser enthält die neue Konfiguration mit den soeben geänderten Parametern.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_ONLY"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-08-20T05:00:05Z"
}

Nächste Schritte