Statistiken und Empfehlungen zur Einstellung ansehen

Auf dieser Seite erfahren Sie, wie Sie Statistiken und Empfehlungen zu Kubernetes-Einstellungen für Ihre Google Kubernetes Engine-Cluster (GKE) aufrufen. Weitere Informationen dazu, wie Kubernetes-Einstellungen mit GKE verwaltet werden, finden Sie unter Einstellungen von Features und APIs.

Was sind Statistiken und Empfehlungen zu veralteten Versionen?

Wenn GKE erkennt, dass ein Cluster eine verworfene Kubernetes-Funktion oder API verwendet, die in einer Nebenversion entfernt wird, geschieht Folgendes:

• Ein automatisches Upgrade auf die nächste Nebenversion ist pausiert. Weitere Informationen dazu finden Sie unter Was passiert, wenn GKE automatische Upgrades pausiert?
• Es werden eine Statistik und eine Empfehlung generiert, damit Sie die Gefährdung Ihres Clusters für die Einstellung bewerten und reduzieren können.

Statistiken und Empfehlungen zu veralteten Versionen finden Sie unter Recommender, einem Dienst, der Statistiken und Empfehlungen zur Verwendung von Ressourcen in Cloud de Confiance by S3NSbietet. Weitere Informationen zur Funktionsweise von Recommender mit GKE finden Sie unter Nutzung von GKE mit Statistiken und Empfehlungen optimieren.

Hier finden Sie das Einstellungsthema mit Recommender:

• Eine Statistik erläutert, dass Ihr Cluster ein Feature oder eine API verwendet, die verworfen wurde und in einer Nebenversion entfernt wird.
• Eine Empfehlung enthält Hinweise dazu, wie Sie die Gefährdung Ihres Clusters durch die Einstellung reduzieren können.

Sie könnten einer Statistik zum Beispiel erklären, dass Ihr Cluster eine Beta API verwendet, die verworfen wurde und in der nächsten Nebenversion entfernt wird. Es wird empfohlen, dass Sie Ihre Arbeitslasten von den Beta APIs zu v1 APIs migrieren. Jede Empfehlung enthält einen Verweis auf einen Migrationsleitfaden für das verworfene Feature oder die API. Dieser Migrationsleitfaden ist auch in der entsprechenden Tabelle für die Einstellung von Kubernetes verfügbar.

Wenn GKE ein Insight-Empfehlungs-Paar generiert, gilt dies für die Verwendung verworfener Kubernetes APIs oder Funktionen in einem bestimmten Statistik-Untertyp für einen Cluster in Ihrem Projekt. Beispiel: Wenn User-Agents eine der vom Untertyp DEPRECATION_K8S_1_22_V1BETA1_API adressierten APIs aufrufen, wird eine Statistik und eine Empfehlung angezeigt. Dabei wird empfohlen, dass Sie diesen Cluster von der Verwendung dieser APIs migrieren sollten. Wenn ein anderer Cluster diese APIs ebenfalls verwendet, generiert GKE eine weitere Statistik und eine Empfehlung.

Verwendung von verworfenen Kubernetes-Features und APIs, die von GKE erkannt wurden

Denken Sie daran, dass Sie bei nächsten Einstellungsvorgängen die Gefährdung Ihrer Clusterumgebung unabhängig bewerten und etwaige Probleme minimieren müssen.

Hinweis

Führen Sie die folgenden Aufgaben aus, bevor Sie beginnen:

• Aktivieren Sie die Google Kubernetes Engine API.
Google Kubernetes Engine API aktivieren
• Wenn Sie die Google Cloud CLI für diese Aufgabe verwenden möchten, installieren und dann initialisieren Sie die gcloud CLI. Wenn Sie die gcloud CLI bereits installiert haben, rufen Sie die neueste Version mit dem gcloud components update Befehl ab. Ältere gcloud CLI-Versionen unterstützen möglicherweise nicht die Ausführung der Befehle in diesem Dokument.

Erforderliche Rollen

Prüfen Sie, ob Sie die erforderlichen Berechtigungen für Kubernetes-Statistiken und -Empfehlungen haben, entweder mit den folgenden einfachen Rollen oder vordefinierten Rollen:

• Lassen Sie Statistiken und Empfehlungen mit einer der folgenden Rollen anzeigen:

  • Betrachter
  • Betrachter von GKE-Diagnose-Recommender

• Sehen Sie sich den Status der Statistiken und Empfehlungen an und aktualisieren Sie sie (z. B. Empfehlung verwerfen):

  • Bearbeiter
  • Kubernetes Engine-Administrator
  • Kubernetes Engine-Entwickler
  • Administrator von GKE-Diagnose-Recommender

Statistiken und Empfehlungen aufrufen

Sie können Statistiken und Empfehlungen mit der Google Cloud CLI, in der Cloud de Confiance Console oder mit der Recommender API aufrufen.

Beispiel: Statistik

Eine Einstellungsstatistik enthält Details zum Zeitpunkt und zum Nutzungsumfang eines verworfenen Features oder einer verworfenen API. Welche Informationen darin enthalten sind, hängt davon ab, für welche Art von Einstellung die Statistik Informationen bereitstellt.

Dies ist ein Beispiel für den Statistikuntertyp DEPRECATION_K8S_1_22_V1BETA1_API:

  name: projects/<PROJECT-NUMBER>/locations/us-central1/insightTypes/google.container.DiagnosisInsight/insights/<INSIGHT-ID>
  observationPeriod: 2592000s
  severity: HIGH
  category: RELIABILITY
  stateInfo:
    state: ACTIVE
  insightSubtype: DEPRECATION_K8S_1_22_V1BETA1_API
  description: Your API clients have used deprecated APIs in the last 30 days that are removed in Kubernetes v1.22. Upgrading your cluster before migrating to the updated APIs supported by v1.22 could cause it to break. [Learn more](https://kubernetes.io/docs/reference/using-api/deprecation-guide/#v1-22).
  targetResources:
    - //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
  associatedRecommendations:
    - recommendation: projects/<PROJECT-NUMBER>/locations/us-central1/recommenders/google.container.DiagnosisRecommender/recommendations/<RECOMMENDATION-ID>
  etag: '"2147dd8e1e302ed7"'
  lastRefreshTime: "2022-01-30T08:00:00Z"
  content:
  targetClusters:
    - clusterId: <CLUSTER-ID>
      clusterUri: //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
  apiDeprecationInsight:
    - api: /apis/networking.k8s.io/v1beta1/Ingress
      stopServingVersion: 1.22
      deprecatedClientStats:
        userAgent: kubectl
        numberOfRequestsLast30Days: 288
        lastRequestTime: "2022-03-02T08:00:18Z"
    - api: /apis/rbac.authorization.k8s.io/v1beta1/ClusterRole
      stopServingVersion: 1.22
      deprecatedClientStats:
        userAgent: kubectl
        numberOfRequestsLast30Days: 126
        lastRequestTime: "2022-02-01T06:45:25Z"

Beispiel: Empfehlung

Eine Einstellungsempfehlung enthält eine Beschreibung der Einstellung sowie einen Link zum Migrationsleitfaden für die Einstellung. Diese Migrationsleitfäden finden Sie auch in der Tabelle zur Einstellung von GKE-Features und der Tabelle zur Einstellung von Kubernetes APIs.

Dies ist eine Beispielempfehlung für den Empfehlungsuntertyp DEPRECATION_K8S_1_22_V1BETA1_API:

  name: projects/<PROJECT-NUMBER>/locations/us-central1/recommenders/google.container.DiagnosisRecommender/recommendations/<RECOMMENDATION-ID>
  description: Update manifests and API clients to use v1 API before upgrading to Kubernetes 1.22 by following the [instructions](https://cloud.google.com/kubernetes-engine/docs/deprecations/apis-1-22).
  primaryImpact:
    category: RELIABILITY
    reliabilityProjection:
      risks:
      - SERVICE_DISRUPTION
  priority: P2
  recommenderSubtype: DEPRECATION_K8S_1_22_V1BETA1_API
  stateInfo:
    state: ACTIVE
  targetResources:
    - //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
  associatedInsights:
    - insight: projects/<PROJECT-NUMBER>/locations/us-central1/insightTypes/google.container.DiagnosisInsight/insights/<INSIGHT-ID>
  etag: '"4dc0f7b33594072f"'
  lastRefreshTime: "2022-01-30T08:00:00Z"
  content:
    overview:
      targetClusters:
        - clusterId: <CLUSTER-ID>
          clusterUri: //container.googleapis.com/projects/<PROJECT-NUMBER>/locations/us-central1/clusters/c1
      apiDeprecationRecommendation:
        - api: /apis/networking.k8s.io/v1beta1/Ingress
          apiReplacement: /apis/networking.k8s.io/v1/Ingress
          stopServingVersion: 1.22
        - api: /apis/rbac.authorization.k8s.io/v1beta1/ClusterRole
          apiReplacement: /apis/rbac.authorization.k8s.io/v1/ClusterRole
          stopServingVersion: 1.22

Statistiken und Empfehlungen nach BigQuery exportieren

Mit BigQuery können Sie Statistiken und Empfehlungen zur Einstellung für Ihre gesamte Organisation exportieren und analysieren. Weitere Informationen finden Sie unter Empfehlungen nach BigQuery exportieren.

Empfehlungen verwerfen oder wiederherstellen

Wenn Sie in der Cloud de Confiance Console keine Einstellungsempfehlung für einen Cluster mehr sehen möchten, verwerfen Sie ihn. Dies kann beispielsweise dazu dienen, um Empfehlungen für temporäre, kurzlebige Cluster zu verwerfen.

Wenn Sie die Empfehlung verwerfen, wird sie für Nutzer, die den Cluster in der Console aufrufen, nicht angezeigt. Nachdem Sie die Empfehlung verworfen haben, wird sie nicht noch einmal angezeigt, selbst wenn ein User-Agent nach dem Verwerfen die verworfene API oder das Feature in diesem Untertyp aufruft.

Die Empfehlung bleibt in der Google Cloud CLI und der Recommender API sichtbar.

Wenn Sie eine Empfehlung verwerfen, wird sie lediglich für alle Nutzer ausgeblendet. Automatische Upgrades bleiben pausiert, bis Sie von der verworfenen Funktion migrieren oder API und GKE 30 aufeinanderfolgende Tage keine Nutzung der verworfenen APIs erkennen, oder bis die Version des Clusters das Ende ihres Support erreicht. Weitere Informationen finden Sie unter Wann setzt GKE automatische Upgrades fort?.

Empfehlung ablehnen

Wenn Sie die Empfehlung verwerfen möchten, folgen Sie der Anleitung unter Statistiken und Empfehlungen in der Cloud de Confiance Console aufrufen, um die Seitenleiste zu öffnen, in der sie weitere Details finden. Klicken Sie in der Seitenleiste auf die Schaltfläche Verwerfen.

Empfehlungen mit der Google Cloud CLI verwerfen

Wenn Sie eine Empfehlung mit der gcloud CLI verwerfen möchten, müssen Sie den Wert etag der aktiven Empfehlung suchen und sie dann als verworfen markieren.

1. Aktive Empfehlungen auflisten: Wenn Sie die Empfehlung suchen möchten, die Sie verwerfen möchten, listen Sie die aktiven Empfehlungen für Ihren Cluster auf. Wenn Sie Empfehlungen ausschließen möchten, die bereits verworfen wurden oder erfolgreich oder fehlgeschlagen sind, verwenden Sie das --filter Flag:

   gcloud recommender recommendations list \
       --recommender=RECOMMENDER_ID \
       --project=PROJECT_ID \
       --location=LOCATION \
       --filter="stateInfo.state=ACTIVE"
   

   Ersetzen Sie Folgendes:

   • RECOMMENDER_ID: die ID des Recommenders.
   • PROJECT_ID: die Cloud de Confiance by S3NS Projekt-ID für das Projekt, in dem sich die Cluster befinden.
   • LOCATION: Die genaue Region oder Zone des Clusters. Für zonale Cluster müssen Sie die genaue Zone angeben (z. B. us-central1-c). Für regionale Cluster müssen Sie die genaue Region angeben (z. B. us-central1).

2. Etag abrufen: Suchen Sie die RECOMMENDATION_ID aus der vorherigen Ausgabe und beschreiben Sie sie, um den aktuellen Status und das etag abzurufen:

   gcloud recommender recommendations describe RECOMMENDATION_ID \
       --recommender=RECOMMENDER_ID \
       --project=PROJECT_ID \
       --location=LOCATION
   

   Ersetzen Sie Folgendes:

   • RECOMMENDATION_ID: die ID der Empfehlung, die Sie verwerfen möchten.

   Notieren Sie sich den etag Wert in der Ausgabe (z. B. "a770e444b0088a35").

3. Als verworfen markieren: Führen Sie den Befehl mark-dismissed aus. Die Recommender API erfordert das genaue etag, um Race-Bedingungen zu vermeiden.

   gcloud recommender recommendations mark-dismissed RECOMMENDATION_ID \
       --recommender=RECOMMENDER_ID \
       --project=PROJECT_ID \
       --location=LOCATION \
       --etag='"ETAG_VALUE"'
   

   Ersetzen Sie Folgendes:

   • ETAG_VALUE: der Wert etag, der vom Befehl „describe“ zurückgegeben wurde.

Verworfene Empfehlung wiederherstellen

Sie können eine verworfene Empfehlung wiederherstellen. Folgen Sie dazu der Anleitung unter Empfehlung wiederherstellen.

Nächste Schritte

• Weitere Informationen zur Einstellung von Produkten und Funktionen mit GKE finden Sie unter Einstellungen von Features und APIs.
• Weitere Informationen zur Recommender API finden Sie unter API verwenden – Empfehlungen.