App Hub einrichten

In diesem Dokument wird beschrieben, wie Sie den App Hub einrichten, um Anwendungen in Google Cloud zu entwickeln, zu betreiben und zu verwalten. Es richtet sich an Nutzer, die den App Hub einrichten und verwalten.

Wenn Sie den App Hub einrichten, sind folgende Hauptaufgaben zu erledigen:

  1. Entscheiden Sie, ob Sie ein neues App Hub-Hostprojekt erstellen oder ein vorhandenes Projekt als Hostprojekt verwenden möchten.
    • Wenn Sie mehr als ein Hostprojekt haben möchten, empfehlen wir Ihnen dringend, sie im selben Ordner zu erstellen.
    • Hostprojekte im App Hub sind nicht mit Hostprojekten in einer freigegebene VPC identisch und unterliegen nicht denselben Anforderungen. Sie benötigen beispielsweise kein freigegebene VPC-Netzwerk, um den App Hub zu verwenden. In diesem Dokument beziehen sich alle Verweise auf Hostprojekte auf App Hub-Hostprojekte.
    • Ein Hostprojekt kann nur ein Dienstprojekt für sich selbst sein.
  2. Aktivieren Sie die App Hub API im Hostprojekt.
  3. Fügen Sie dem Hostprojekt ein oder mehrere App Hub-Dienstprojekte hinzu.
    • Dienstprojekte im App Hub sind nicht mit freigegebene VPC-Dienstprojekten identisch und unterliegen nicht denselben Anforderungen. In diesem Dokument beziehen sich alle Verweise auf Dienstprojekte auf App Hub-Dienstprojekte.
  4. App Hub-Nutzer als App Hub-Administratoren, App Hub-Bearbeiter oder App Hub-Betrachter festlegen
  5. Anwendungen erstellen
  6. Registrieren Sie Dienste und Arbeitslasten für die Anwendung.

Dienste und Arbeitslasten

Im App Hub stehen Ihnen die Ressourcen aus Dienstprojekten, die an das Hostprojekt angehängt sind, als Dienste und Arbeitslasten zur Verfügung. Wenn Sie Ihre Dienste und Arbeitslasten bei einer Anwendung registrieren, können Sie die Ressourcen beobachten und überwachen. Sie können die folgenden Ressourcen als App Hub-Dienste festlegen und für App Hub-Anwendungen registrieren:

  • Weiterleitungsregeln
  • URL-Zuordnungen
  • Backend-Dienste

Sie können verwaltete Instanzgruppen (MIGs), aber keine einzelnen VMs, als Arbeitslasten festlegen und sie für App Hub-Anwendungen registrieren.

App Hub unterstützt globale (Vorabversion) und regionale Ressourcen. Weitere Informationen finden Sie unter Vom App Hub unterstützte Ressourcen.

Einrichtung

In der folgenden Liste sind die Schritte zur Einrichtung des App Hubs zusammengefasst:

  1. Legen Sie fest, welche vorhandenen Ressourcen in Ihre Anwendung aufgenommen werden sollen und zu welchen Projekten sie gehören.
  2. Erstellen Sie ein App Hub-Hostprojekt und aktivieren Sie die App Hub API im Projekt. Je nach Organisationsstruktur Ihres Unternehmens können Sie auch mehrere Hostprojekte erstellen. Wenn Sie mehrere Projekte erstellen, empfehlen wir, sie in einem neuen Ordner zu erstellen.
  3. Dienstprojekte anhängen Nachdem Sie ein Hostprojekt konfiguriert haben, hängen Sie Dienstprojekte mit den zugrunde liegenden Ressourcen an, die Ihre Anwendungen benötigen. Beachten Sie Folgendes:
    1. Die Dienstprojekte müssen sich in derselben Organisation wie das Hostprojekt befinden. Nachdem Sie ein Dienstprojekt an ein Hostprojekt angehängt haben, können Sie es nicht in eine andere Organisation verschieben. Wenn Sie das Dienstprojekt in eine andere Organisation verschieben möchten, müssen Sie der Anleitung in diesem Dokument folgen, um die Verknüpfung des Dienstprojekts mit dem Hostprojekt zu entfernen oder aufzuheben. Anschließend können Sie das Dienstprojekt einer anderen Organisation zuordnen.
    2. Ein Dienstprojekt kann nicht an mehr als ein Hostprojekt angehängt werden.
    3. Ein Hostprojekt kann ein eigenes Dienstprojekt sein, aber kein Dienstprojekt für ein anderes Hostprojekt.
    4. Nachdem Sie Dienstprojekte an ein Hostprojekt angehängt haben, werden beim Abfragen des Hostprojekts nach Diensten oder Arbeitslasten automatisch alle Dienste und Arbeitslasten in allen Dienstprojekten zurückgegeben.
  4. Eine Anwendung zum Organisieren mehrerer Arbeitslasten und Dienste erstellen. Wichtige Hinweise:
    1. Der Name der Anwendung muss im Hostprojekt und am Speicherort eindeutig sein.
    2. Ein Dienstprojekt kann an ein Hostprojekt mit mehreren Anwendungen angehängt werden, seine einzelnen Ressourcen können jedoch nur für eine Anwendung registriert werden.
  5. Nach Diensten und Arbeitslasten suchen und sie für Ihre Anwendung registrieren Nachdem Sie eine Anwendung erstellt haben, fragen Sie das Hostprojekt nach verfügbaren Diensten und Arbeitslasten ab. Die Abfragen werden für das Hostprojekt und alle Dienstprojekte ausgeführt, die an das Hostprojekt angehängt sind. Außerdem werden alle Dienste und Arbeitslasten in diesen Projekten zurückgegeben. Beachten Sie Folgendes:
    1. Sie können einen Dienst oder eine Arbeitslast nur bei einer einzelnen Anwendung registrieren.
    2. Sie müssen Dienste und Arbeitslasten aus einer bestimmten Region bei einer regionalen Anwendung in derselben Region oder bei einer globalen Anwendung registrieren. In den folgenden Anleitungen und Befehlen wird davon ausgegangen, dass sich alle Ressourcen in derselben Region befinden. Informationen dazu, welche Regionen Sie festlegen können, finden Sie unter Standorte.
    3. Registrierte Dienste und Arbeitslasten sind von Aktualisierungen der zugrunde liegenden Infrastrukturressource nicht betroffen. Wenn Sie also die zugrunde liegenden Ressourcen löschen, die als Dienste und Arbeitslasten dienen, werden die zugehörigen Arbeitslasten und Dienste nicht aus Ihrer Anwendung gelöscht. Sie müssen die Registrierung der Arbeitslast oder des Dienstes separat aufheben.

Vorbereitung

Führen Sie die folgenden Aufgaben aus, bevor Sie den App Hub einrichten.

  1. Legen Sie fest, welches vorhandene Projekt das Hostprojekt ist, oder erstellen Sie ein neues Projekt als Hostprojekt. Wir empfehlen Ihnen dringend, ein neues Projekt zu erstellen.
  2. Sie müssen festgelegt haben, welche Personen die IAM-Rollen (Identity and Access Management) für den App Hub haben: App Hub-Administrator, App Hub-Bearbeiter und App Hub-Betrachter.

Wichtige Hinweise:

  • Hostprojekte können ein oder mehrere Dienstprojekte haben.
  • Ein Dienstprojekt kann nicht an mehr als ein Hostprojekt angehängt werden.
  • Die Person, die ein Dienstprojekt an ein Hostprojekt anhängt, muss sowohl im Dienstprojekt als auch im Hostprojekt die IAM-Rolle „App Hub Admin“ haben. Weitere Informationen finden Sie unter App Hub-Rollen und ‑Berechtigungen.

App Hub einrichten

In diesem Abschnitt erstellen Sie eine Beispielarchitektur für den App Hub.

In diesem Beispiel hat eine Organisation drei Dienstprojekte, deren Infrastrukturressourcen in den Projekten wie folgt bereitgestellt werden:

  • Dienstprojekt 1 hat zwei Infrastrukturressourcen: Dienst 1 und Dienst 2.
  • Dienstprojekt 2 hat drei Infrastrukturressourcen: Dienst 3, Arbeitslast 1 und Arbeitslast 2.
  • Dienstprojekt 3 hat drei Infrastrukturressourcen: Dienst 4, Arbeitslast 3 und Arbeitslast 4.

Achten Sie darauf, dass die von Ihnen zum Erstellen des Beispiels ausgewählten Projekte die in diesem Abschnitt beschriebenen Ressourcen enthalten. Andernfalls müssen Sie das Beispiel während der Anleitung anpassen.

In den folgenden Abschnitten finden Sie eine Anleitung zum Erstellen eines App Hub-Beispiels. Sie erstellen ein Hostprojekt und fügen dem Hostprojekt Dienstprojekte hinzu. Anschließend erstellen Sie eine Anwendung und hängen der Anwendung Dienste und Arbeitslasten an. Im Beispiel sind drei Dienstprojekte enthalten, Sie können aber auch weniger oder mehr hinzufügen.

In diesem Beispiel wird davon ausgegangen, dass alle hinzugefügten Dienstprojekte bereits vorhanden sind und Dienste und Arbeitslasten enthalten, die Sie Ihrer Anwendung hinzufügen. Bevor Sie das Beispiel erstellen, müssen Sie ermitteln, welche Dienstprojekte die Dienste und Arbeitslasten enthalten, die Sie in die Anwendung aufnehmen möchten.

App Hub aktivieren

In diesem Abschnitt wählen Sie ein neues Hostprojekt aus oder erstellen eines, aktivieren die App Hub API und gewähren Personen in Ihrer Organisation die entsprechenden Rollen und Berechtigungen. Außerdem hängen Sie Dienstprojekte an das Hostprojekt an.

Console

  1. Rufen Sie in der Google Cloud Console die Seite für die Projektauswahl auf.

    Zur Projektauswahl

  2. Wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines, das als Hostprojekt für den App Hub verwendet werden soll.

  3. Enable the required API.

    Enable the API

  4. Wenn Sie der Projektersteller sind, wird Ihnen die einfache Rolle „Inhaber“ (roles/owner) zugewiesen. Standardmäßig enthält diese IAM-Rolle die Berechtigungen, die für den vollständigen Zugriff auf die meisten Google Cloud-Ressourcen erforderlich sind.

    Wenn Sie nicht der Project Creator sind, müssen dem entsprechenden Hauptkonto die erforderlichen Berechtigungen für das Projekt erteilt werden. Ein Hauptkonto kann beispielsweise ein Google-Konto (für Endnutzer) oder ein Dienstkonto (für Anwendungen und Computing-Arbeitslasten) sein. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen dieser Anleitung benötigen:

    1. Öffnen Sie in der Google Cloud Console die Seite IAM.

      IAM aufrufen

    2. Klicken Sie auf Zugriff gewähren. Der Bereich Zugriff gewähren wird geöffnet.

    3. Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse der Person ein, die den App Hub verwalten soll, also die Rolle „App Hub Admin“ im Hostprojekt.

    4. Klicken Sie auf Rolle auswählen und geben Sie im Feld Filter App Hub ein.

    5. Wählen Sie die Rolle „App Hub-Administrator“ aus und klicken Sie auf Speichern.

    6. Weisen Sie in jedem der App Hub-Dienstprojekte demselben Nutzer die Rolle „App Hub Admin“ zu.

  5. Rufen Sie in der Google Cloud Console die Seite Einstellungen des App Hubs auf.

    Einstellungen aufrufen

  6. Klicken Sie auf der Seite Einstellungen auf Projekte anhängen.

  7. Führen Sie einen der folgenden Schritte aus:

    • Klicken Sie in der Projektliste die Kästchen für die Projekte an, die Sie als Dienstprojekte hinzufügen möchten.
    • Suchen Sie nach Projekten und wählen Sie die Projekte aus, die Sie als Dienstprojekte hinzufügen möchten.
  8. Klicken Sie auf Auswählen. In der Tabelle Angehängte Dienstprojekte werden die ausgewählten Dienstprojekte angezeigt.

  9. Klicken Sie auf Schließen.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Prüfen Sie, ob die neueste Version der Google Cloud CLI installiert ist. Führen Sie in Cloud Shell den folgenden Befehl aus:

    gcloud components update
  3. Erstellen oder wählen Sie ein neues Projekt namens HOST_PROJECT_ID als Hostprojekt für den App Hub aus.

    • Erstellen Sie ein Google Cloud-Projekt:
      gcloud projects create HOST_PROJECT_ID
    • Wählen Sie das von Ihnen erstellte Google Cloud-Projekt aus:
      gcloud config set project HOST_PROJECT_ID
  4. Aktivieren Sie die App Hub API im gerade erstellten Hostprojekt.

    gcloud services enable apphub.googleapis.com \
        --project=HOST_PROJECT_ID
    
  5. Wenn Sie der Projektersteller sind, wird Ihnen die einfache Rolle „Inhaber“ (roles/owner) zugewiesen. Standardmäßig enthält diese IAM-Rolle die Berechtigungen, die für den vollständigen Zugriff auf die meisten Google Cloud-Ressourcen erforderlich sind.

    Wenn Sie nicht der Project Creator sind, müssen dem entsprechenden Hauptkonto die erforderlichen Berechtigungen für das Projekt erteilt werden. Ein Hauptkonto kann beispielsweise ein Google-Konto (für Endnutzer) oder ein Dienstkonto (für Anwendungen und Computing-Arbeitslasten) sein. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen dieser Anleitung benötigen:

    1. Optional können Sie den Personen, die den App Hub verwalten, die Rolle „App Hub-Administrator“ im Hostprojekt zuweisen. Wiederholen Sie den folgenden Befehl für jeden Administrator.

      gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      Ersetzen Sie HOST_PROJECT_ADMIN durch den Nutzer, der im Hostprojekt die Rolle „App Hub-Administrator“ hat. Dieser Wert hat das Format username@yourdomain, z. B. robert.smith@example.com.

    2. Weisen Sie den Personen, die den App Hub verwalten, die Rolle „App Hub Admin“ in den Dienstprojekten zu. Sie müssen die Rolle „App Hub Admin“ haben, um dem Hostprojekt Dienstprojekte hinzuzufügen. Für jedes Dienstleistungsprojekt ist mindestens eine Person mit dieser Rolle erforderlich. Eine einzelne Person kann die Rolle in mehreren Serviceprojekten haben.

      gcloud projects add-iam-policy-binding SERVICE_PROJECT_1 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      
      gcloud projects add-iam-policy-binding SERVICE_PROJECT_2 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      
      gcloud projects add-iam-policy-binding SERVICE_PROJECT_3 \
          --member='user:HOST_PROJECT_ADMIN' \
          --role='roles/apphub.admin'
      

      Ersetzen Sie Folgendes:

      • SERVICE_PROJECT_1: das erste von drei Dienstprojekten in diesem Beispiel.
      • SERVICE_PROJECT_2: das zweite von drei Dienstprojekten in diesem Beispiel.
      • SERVICE_PROJECT_3: das dritte von drei Dienstprojekten in diesem Beispiel.
  6. Fügen Sie Ihre Dienstprojekte dem App Hub-Hostprojekt hinzu.

    gcloud apphub service-projects add SERVICE_PROJECT_1 \
        --project=HOST_PROJECT_ID
    
    gcloud apphub service-projects add SERVICE_PROJECT_2 \
        --project=HOST_PROJECT_ID
    
    gcloud apphub service-projects add SERVICE_PROJECT_3 \
        --project=HOST_PROJECT_ID
    

Optional: Dienstprojekte dem Messwertbereich des Hostprojekts hinzufügen

Sie können die Systemmesswerte für die Anwendungen in Ihrem Hostprojekt aufrufen, indem Sie die Dienstprojekte dem Messwertbereich des Hostprojekts als Ressourcencontainer hinzufügen. Ein App Hub-Hostprojekt dient als Scoping-Projekt, in dem ein Messwertbereich gehostet wird. Der Messwertbereich eines Google Cloud-Projekts definiert die festgelegten Ressourcencontainer, deren Zeitreihendaten im Hostprojekt grafisch dargestellt und überwacht werden können. Weitere Informationen zu Ressourcencontainern, Messwertbereichen und Scoping-Projekten finden Sie unter Cloud Monitoring: Datenmodell.

Wenn Sie die Systemmesswerte für eine Anwendung aufrufen möchten, müssen Sie die überwachten Dienstprojekte bei Bedarf manuell zu den Hostprojekten hinzufügen oder daraus löschen. Wenn Sie das Hostprojekt jedoch als eigenes Dienstprojekt verwenden, da sich die App Hub-Anwendungen im selben Projekt befinden, fügen Sie das Projekt dem Messwertbereich nicht hinzu.

Sie benötigen die folgenden IAM-Rollen:

  • Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Viewer (roles/monitoring.viewer) für die Hauptbenutzer zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Aufrufen von Messwerten für App Hub-Anwendungen benötigen. Weitere Informationen finden Sie unter Zugriff auf Monitoring gewähren.
  • Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Monitoring Admin (roles/monitoring.admin) für das Projekt, für das Sie den Messwertbereich festlegen möchten, und für jeden Ressourcencontainer zuzuweisen, den Sie dem Messwertbereich hinzufügen möchten, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren eines Messwertbereichs benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

    Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Console

  1. Öffnen Sie in der Google Cloud Console die Seite Einstellungen.

    Einstellungenaufrufen

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Wählen Sie Messwertumfang aus.

    Auf dem Tab Messwertbereich sind die Ressourcen aufgeführt, die vom aktuellen Google Cloud-Projekt überwacht werden. Außerdem werden die Google Cloud-Projekte aufgeführt, deren Messwertbereich das aktuelle Google Cloud-Projekt enthält.

  3. So fügen Sie dem Messwertbereich Google Cloud-Projekte hinzu:

    1. Klicken Sie im Bereich Google Cloud-Projekte auf Projekte hinzufügen.
    2. Klicken Sie im Dialogfeld Google Cloud-Projekte hinzufügen auf Projekte auswählen und setzen Sie dann ein Häkchen in die Kästchen für die erforderlichen Dienstprojekte, die Sie überwachen möchten.
    3. Klicken Sie auf Projekte hinzufügen, um die Änderungen zu speichern.

      Die Seite Einstellungen wird angezeigt. Die Tabelle auf dieser Seite enthält nun Ihre Auswahl.

Nachdem Sie einem Messwertbereich Projekte hinzugefügt haben, dauert es etwa 60 Sekunden, bis Änderungen auf alle Monitoringsysteme angewendet werden.

Weitere Informationen zum Konfigurieren der Messwertbereiche mit der Google Cloud Console finden Sie unter Messwertbereich konfigurieren.

gcloud

So fügen Sie Ihre Dienstprojekte dem App Hub-Hostprojekt als überwachten Ressourcencontainer hinzu:

gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_1 \
    --project=HOST_PROJECT_ID
gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_2 \
    --project=HOST_PROJECT_ID
gcloud beta monitoring metrics-scopes create projects/SERVICE_PROJECT_3 \
    --project=HOST_PROJECT_ID

Weitere Informationen zum Konfigurieren von Messwertbereichen mit der Google Cloud CLI finden Sie unter Messwertbereich mithilfe der API konfigurieren.

Anwendung erstellen

Erstellen Sie eine Anwendung, die als Container für Ihre Dienste und Arbeitslasten dient, falls Sie noch keine haben. Erstellen Sie je nach Umfang Ihrer Dienste und Arbeitslasten in Ihren Dienstprojekten eine globale (Vorabversion) oder regionale Anwendung.

  • Mit einer globalen Anwendung (Vorabversion) können Sie erkannte Dienste und Arbeitslasten aus regionalen und globalen Google Cloud-Ressourcen registrieren.
  • Mit einer regionalen Anwendung können Sie erkannte Dienste und Arbeitslasten aus regionalen Google Cloud-Ressourcen registrieren.

Hinweis: Nachdem Sie eine Anwendung erstellt haben, können Sie den Anwendungsumfang nicht mehr ändern. Weitere Informationen zu globalen und regionalen Apps finden Sie unter Globale und regionale App Hub-Apps.

Console

  1. Achten Sie darauf, dass Sie sich im Hostprojekt befinden.
  2. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

    Wechseln Sie zu „Anwendungen“

  3. Klicken Sie auf Anwendung erstellen.

  4. Führen Sie auf der Seite Anwendung erstellen im Bereich Region und Name der Anwendung auswählen je nach Umfang der Dienste und Arbeitslasten, die Sie für die Anwendung registrieren möchten, einen der folgenden Schritte aus:

    • Wenn Sie eine Anwendung erstellen möchten, mit der Sie Dienste und Arbeitslasten von einem globalen Standort aus registrieren können, wählen Sie Global (Vorabversion) aus.

    • So erstellen Sie eine Anwendung, mit der Sie Dienste und Arbeitslasten an einem einzigen Ort registrieren können:

      1. Wählen Sie Regional aus.
      2. Wählen Sie eine Region aus.
  5. Geben Sie den Anwendungsnamen ein und klicken Sie auf Weiter.

  6. Optional können Sie in den folgenden Feldern weitere Details zur Anwendung hinzufügen. Weitere Informationen finden Sie in diesem Dokument unter Vorhandene App Hub-Anwendung aktualisieren.

  7. Klicken Sie auf Erstellen.

gcloud

  1. Erstellen Sie eine neue Anwendung namens APPLICATION_NAME und geben Sie ihr den Anzeigenamen APPLICATION_DISPLAY_NAME.

    gcloud apphub applications create APPLICATION_NAME \
      --scope-type=SCOPE_TYPE \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Ersetzen Sie Folgendes:

    • APPLICATION_NAME ist der Name Ihrer Anwendung. Der Name darf nur Kleinbuchstaben und alphanumerische Zeichen ohne Leerzeichen enthalten.
    • SCOPE_TYPE: Der Umfang Ihrer Anwendung, der festlegt, welche Dienste und Arbeitslasten Sie bei der Anwendung registrieren können. Verwenden Sie einen der folgenden Werte:
    • REGION: die Region der Anwendung. Geben Sie je nach --scope-type den Wert us-east1 oder global (Vorschau) an.
  2. Listen Sie die Anwendungen in Ihrem Hostprojekt auf.

    gcloud apphub applications list \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID                DISPLAY_NAME              CREATE_TIME
    APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
    
  3. Details zur von Ihnen erstellten Anwendung abrufen

    gcloud apphub applications describe APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Der Befehl gibt Informationen im YAML-Format zurück, die in etwa so aussehen:

    createTime: '2023-10-31T18:33:48.199394108Z'
    displayName: APPLICATION_DISPLAY_NAME
    name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
    scope:
      type: SCOPE_TYPE
    state: ACTIVE
    uid: [APPLICATION_UID]
    updateTime: '2023-10-31T18:33:48.343303819Z'
    
    

Vorhandene App Hub-Anwendung aktualisieren

Sie können die Attribute Ihrer Anwendung auch nach der Erstellung aktualisieren.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

    Wechseln Sie zu „Anwendungen“

  2. Klicken Sie in der Liste der Anwendungen neben der Anwendung, die Sie aktualisieren möchten, auf  Bearbeiten.

  3. Bearbeiten Sie die Felder nach Bedarf und klicken Sie auf Speichern.

  4. Optional: Wählen Sie in der Liste Kritisch eine der folgenden Optionen aus, um die Wichtigkeit der Anwendung anzugeben:

    • Geschäftskritisch
    • Hoch
    • Mittel
    • Niedrig
  5. Optional: Wählen Sie in der Liste Umgebung eine der folgenden Optionen aus, um die Phase des Softwarelebenszyklus anzugeben:

    • Produktion
    • Staging
    • Entwicklung
    • Test
  6. Optional: Fügen Sie die folgenden Details hinzu, sofern erforderlich für Entwicklerinhaber, Betreiberinhaber und Geschäftsinhaber. Wenn Sie einen Anzeigenamen hinzufügen, müssen Sie die E-Mail-Adresse des Inhabers eingeben.

    1. Geben Sie den Anzeigenamen eines Eigentümers ein.
    2. Geben Sie die E-Mail-Adresse des Inhabers ein. Dieser Wert muss das Format username@yourdomain haben, z. B. 222larabrown@gmail.com.
  7. Wiederholen Sie diese Schritte für jeden Entwickler, Betreiber und Geschäftsinhaber.

  8. Klicken Sie auf Speichern.

gcloud

  1. Aktualisieren Sie Ihre Anwendung mit den Attributen criticality-type, environment-type und „Owner type“ (Inhabertyp):

    gcloud apphub applications update APPLICATION_NAME \
      --display-name='APPLICATION_DISPLAY_NAME' \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
      --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
      --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Ersetzen Sie Folgendes:

    • APPLICATION_DISPLAY_NAME: Der Anzeigename Ihrer Anwendung.
    • CRITICALITY_LEVEL: Gibt an, wie wichtig eine Anwendung, ein Dienst oder eine Arbeitslast für Ihr Unternehmen ist. Geben Sie einen der folgenden Werte an:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: gibt die Phasen des Softwarelebenszyklus an. Geben Sie einen der folgenden Werte an:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR und DISPLAY-NAME-BUSINESS: Anzeigenamen des Entwicklers, Betreibers und Inhabers des Unternehmens.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR und EMAIL-NAME-BUSINESS: E-Mail-Adressen des Entwicklers, Betreibers und des Unternehmensinhabers. Diese Werte müssen das Format username@yourdomain haben, z. B. 222larabrown@gmail.com.
  2. Listen Sie die Anwendungen auf, bei denen das Attribut environment-type den Wert PRODUCTION hat.

    gcloud apphub applications list \
        --filter='attributes.environment.type=PRODUCTION' \
        --project=HOST_PROJECT_ID \
        --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID                DISPLAY_NAME              CREATE_TIME
    APPLICATION_NAME  APPLICATION_DISPLAY_NAME  2023-10-31T18:33:48
    

Dienste und Arbeitslasten registrieren

Wenn Sie Infrastrukturdienste und Arbeitslasten für eine Anwendung registrieren, werden die Dienste und Arbeitslasten als App Hub-Ressourcen registriert. Verwenden Sie eine globale Anwendung (Vorabversion), um globale oder auf mehrere Regionen verteilte Ressourcen zu registrieren. Verwenden Sie eine regionale Anwendung, um Ressourcen aus derselben Region wie die Anwendung zu registrieren. Wenn Sie die Platzhalter verwenden, um die Anwendung mit der gcloud CLI zu erstellen, sehen die Dienste und Arbeitslasten in den drei Dienstprojekten so aus:

  • Dienstprojekt 1 hat zwei Infrastrukturressourcen: Dienst 1 und Dienst 2.
  • Dienstprojekt 2 hat drei Infrastrukturressourcen: Dienst 3, Arbeitslast 1 und Arbeitslast 2.
  • Dienstprojekt 3 hat drei Infrastrukturressourcen: Dienst 4, Arbeitslast 3 und Arbeitslast 4.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

    Wechseln Sie zu „Anwendungen“

  2. Klicken Sie auf den Namen Ihrer Anwendung. Auf dem Tab Dienste und Arbeitslasten wird eine Liste der registrierten Dienste und Arbeitslasten in Ihren Dienstprojekten angezeigt.

  3. Gehen Sie für jeden Dienst oder jede Arbeitslast, die Sie registrieren möchten, so vor:

    1. Klicken Sie auf dem Tab Dienste und Arbeitslasten auf Dienst/Arbeitslast registrieren.
    2. Klicken Sie auf der Seite Dienst oder Arbeitslast registrieren im Bereich Ressource auswählen auf Durchsuchen, um den Dienst oder die Arbeitslast als Ressource auszuwählen.
    3. Wählen Sie im Bereich Ressource auswählen einen Dienst oder eine Arbeitslast aus und klicken Sie auf Auswählen.
    4. Geben Sie im Bereich Ressource auswählen einen Namen für den Dienst oder die Arbeitslast ein und klicken Sie auf Weiter.
    5. Optional können Sie im Bereich Attribute hinzufügen in den folgenden Feldern weitere Details für den Dienst oder die Arbeitslast angeben. Weitere Informationen finden Sie in diesem Dokument unter Vorhandene App Hub-Anwendung aktualisieren. Sie können für die Felder Criticality (Kritisch) und Environment (Umgebung) Werte auswählen, die sich von den Werten unterscheiden, die Sie beim Erstellen der Anwendung festgelegt haben.
    6. Klicken Sie auf Weiter.
    7. Optional können Sie im Abschnitt Inhaber hinzufügen in den folgenden Feldern weitere Details zu den Inhabern des Dienstes oder der Arbeitslast angeben. Weitere Informationen finden Sie unter Vorhandene App Hub-Anwendung aktualisieren.
    8. Klicken Sie auf Registrieren.

Auf dem Tab Dienste und Arbeitslasten wird der registrierte Dienst oder die registrierte Arbeitslast angezeigt. Weitere Informationen zu den Registrierungsstatus finden Sie unter Eigenschaften und Attribute des App Hub.

gcloud

  1. Fügen Sie eine Person mit den Berechtigungen „App Hub-Bearbeiter“ hinzu.

    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
      --member='user:APP_HUB_EDITOR' \
      --role='roles/apphub.editor'
    

    Ersetzen Sie APP_HUB_EDITOR durch den Nutzer, der im Hostprojekt die Rolle „App Hub-Bearbeiter“ hat. Dieser Wert hat das Format username@yourdomain, z. B. robert.smith@example.com.

  2. Liste der erkannten Arbeitslasten aus Dienstprojekt 2, das an das Hostprojekt angehängt ist Dieser Befehl gibt Arbeitslasten zurück, die für eine Anwendung registriert werden können.

    gcloud apphub discovered-workloads list \
      --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
    [DISCOVERED_WORKLOAD_ID_1]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
    [DISCOVERED_WORKLOAD_ID_2]   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}
    

    Kopieren Sie die Arbeitslast-ID aus der Ausgabe, um sie im nächsten Schritt zu verwenden.

  3. Registrieren Sie eine Arbeitslast aus dem vorherigen Schritt in Ihrer Anwendung.

    gcloud apphub applications workloads create WORKLOAD_NAME \
      --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
      --display-name='mywebserver-deployment1' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Ersetzen Sie Folgendes:

    • WORKLOAD_NAME: Ein Name, unter dem die Arbeitslast registriert werden soll.
    • DISCOVERED_WORKLOAD_ID_2: die Arbeitslast-ID aus der Ausgabe des vorherigen Schritts
  4. Wiederholen Sie die beiden vorherigen Schritte, um die gewünschten Arbeitslasten aus Dienstprojekt 3 zu filtern und zu registrieren.

  5. Optional: Sie können die Arbeitslasten mit den Attributen criticality-type, environment-type und „Inhaber“ aktualisieren.

    gcloud apphub applications workloads update WORKLOAD_NAME \
      --application=APPLICATION_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
      --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
      --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Sie müssen einen der angegebenen Werte für criticality-type und environment-type angeben. Der Wert kann sich jedoch von den Werten unterscheiden, die Sie beim Erstellen der Anwendung festgelegt haben.

  6. Liste der registrierten Arbeitslasten in der Anwendung.

    gcloud apphub applications workloads list \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID                DISPLAY_NAME                 WORKLOAD_REFERENCE                                                                                                    CREATE_TIME
    WORKLOAD_NAME     mywebserver-deployment1      {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}   2023-10-31T18:34:23
    

    Registrierte, aber getrennte Arbeitslasten werden durch einen leeren Wert im Feld WORKLOAD_REFERENCE gekennzeichnet. Weitere Informationen zu den Registrierungsstatus finden Sie unter Eigenschaften und Attribute des App Hub.

  7. Listen Sie die erkannten Dienste mit Weiterleitungsregeln im Dienstprojekt 1 auf, das an das Hostprojekt angehängt ist. Dieser Befehl gibt Dienste zurück, die für eine Anwendung registriert werden können.

    gcloud apphub discovered-services list \
      --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht in etwa so aus:

    ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
    [DISCOVERED_SERVICE_ID_1]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
    [DISCOVERED_SERVICE_ID_2]    {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}     {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}
    

    Kopieren Sie die Dienst-ID DISCOVERED_SERVICE_ID_2 aus der Ausgabe, um sie im nächsten Schritt zu verwenden.

  8. Registrieren Sie die Weiterleitungsregel testing-forwarding-rule-2 in Dienstprojekt 1 als Dienst.

    gcloud apphub applications services create SERVICE_NAME \
      --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
      --display-name='mywebserver-service1' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Ersetzen Sie Folgendes:

    • SERVICE_NAME: Ein Name, unter dem der Dienst registriert werden soll.
    • DISCOVERED_SERVICE_ID_2: die Dienst-ID aus der Ausgabe des vorherigen Schritts
  9. Wiederholen Sie die vorherigen Schritte zum Auflisten, Filtern und Registrieren von Diensten in den Dienstprojekten 1, 2 und 3.

  10. Aktualisieren Sie einen Dienst mit dem Attribut criticality-type und dem Attribut environment-type.

    gcloud apphub applications services update SERVICE_NAME \
      --criticality-type='CRITICALITY_LEVEL' \
      --environment-type='ENVIRONMENT' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID  \
      --location=REGION
    
  11. Registrierte Dienste in der Anwendung APPLICATION_NAME und im Hostprojekt HOST_PROJECT_ID auflisten.

    gcloud apphub applications services list \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Ausgabe sieht für jeden Dienst in etwa so aus:

    ID                DISPLAY_NAME                 SERVICE_REFERENCE                                                                                                                  CREATE_TIME
    SERVICE_NAME      mywebserver-service1         {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}   2023-11-01T21:38:08
    

    Registrierte, aber getrennte Dienste sind durch einen leeren Wert im Feld SERVICE_REFERENCE gekennzeichnet.

  12. Filtern Sie die Dienste in der Anwendung APPLICATION_NAME und im Hostprojekt HOST_PROJECT_ID auf diejenigen, bei denen das Attribut environment-type auf PRODUCTION festgelegt ist.

    gcloud apphub applications services list \
      --filter='attributes.environment.type=PRODUCTION' \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

Die Einrichtung von App Hub ist abgeschlossen.

Dienstprojekte hinzufügen oder entfernen

Sie können Anhänge von Dienstprojekten ändern, um verschiedene Infrastrukturressourcen für die Gruppierung in einer Anwendung verfügbar zu machen.

Wenn Sie die Systemmesswerte für Anwendungen in Ihrem Hostprojekt aufrufen möchten, fügen Sie dem Messumfang des Hostprojekts die Dienstprojekte als Ressourcencontainer hinzu, nachdem Sie dem Hostprojekt ein Dienstprojekt hinzugefügt haben. Weitere Informationen finden Sie unter Dienstprojekte dem Messwertbereich des Hostprojekts hinzufügen. Wenn Sie ein Dienstprojekt aus einem Hostprojekt entfernen, sollten Sie die Dienstprojekte als Ressourcencontainer aus dem Messwertbereich des Hostprojekts entfernen, falls Sie zuvor die Systemmesswerte der Anwendungen in Ihrem Hostprojekt angezeigt haben. Weitere Informationen finden Sie in diesem Dokument unter Dienstprojekte aus dem Messwertbereich des Hostprojekts entfernen.

Console

So fügen Sie einem Hostprojekt ein Dienstprojekt hinzu:

  1. Rufen Sie in der Google Cloud Console die Seite Einstellungen des App Hubs auf.

    Einstellungen aufrufen

  2. Klicken Sie auf der Seite Einstellungen auf Projekte anhängen.

  3. Suchen Sie im angezeigten Bereich nach Projekten in der Liste und klicken Sie die Kästchen der Projekte an, die Sie als Dienstprojekte hinzufügen möchten.

  4. Klicken Sie auf Auswählen. In der Tabelle Angehängte Dienstprojekte werden die ausgewählten Projekte als Dienstprojekte für das Hostprojekt angezeigt.

  5. Klicken Sie auf Schließen.

So entfernen Sie ein Dienstprojekt aus einem Hostprojekt:

  1. Rufen Sie in der Google Cloud Console die Seite Einstellungen des App Hubs auf.

    Einstellungen aufrufen

  2. Klicken Sie auf der Seite Einstellungen die Kästchen für alle Projekte an, die Sie als Dienstprojekte entfernen möchten.

  3. Klicken Sie auf Projekte trennen. Die Tabelle Angehängte Dienstprojekte wird aktualisiert und zeigt nur die Projekte an, die weiterhin an das Hostprojekt angehängt sind.

gcloud

So fügen Sie einem Hostprojekt ein Dienstprojekt hinzu:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID
Ersetzen Sie SERVICE_PROJECT_ID durch den Namen des Dienstprojekts, das Sie dem Hostprojekt hinzufügen möchten.
So entfernen Sie ein Dienstprojekt aus dem Hostprojekt:
gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Vorhandene Anwendungen, Dienste und Arbeitslasten ansehen

Sie können sich Anwendungen in einem Projekt ansehen und Dienste und Arbeitslasten in einer Anwendung auflisten.

Console

  • Wenn Sie sich die Anwendungen in einem Projekt ansehen möchten, rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

    Wechseln Sie zu „Anwendungen“

  • So listen Sie Dienste und Arbeitslasten auf:

    Anwendungen

    1. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

      Wechseln Sie zu „Anwendungen“

    2. Klicken Sie auf den Namen einer Anwendung. Daraufhin wird eine Seite mit einer Liste der Dienste und Arbeitslasten angezeigt, die für Ihre Anwendung registriert sind.

    3. Optional: So filtern Sie die Dienste oder Arbeitslasten:

      1. Wählen Sie im Feld Filter einen Filter aus, z. B. Kritisch.
      2. Wählen Sie als Wert Hoch aus.
        Es wird eine Liste der Dienste und Arbeitslasten mit hoher Kritikalität angezeigt, die für die Anwendung registriert sind.

    Dienste und Arbeitslasten

    1. Rufen Sie in der Google Cloud Console die Seite Dienste und Arbeitslasten des App Hubs auf.

      Zu „Dienste und Arbeitslasten“

    2. Wählen Sie in der Liste Region die Regionen aus, für die Sie die Dienste und Arbeitslasten aufrufen möchten. Wählen Sie beispielsweise us-east1 aus.
      Auf der Seite Dienste und Arbeitslasten werden alle Dienste und Arbeitslasten aus den angehängten Dienstprojekten angezeigt, die mit us-east1 verknüpft sind.

    3. Optional: So filtern Sie die Dienste oder Arbeitslasten:

      1. Wählen Sie im Feld Filter einen Filter aus, z. B. Umgebung.
      2. Wählen Sie Produktion als Wert aus.
        Es wird eine Liste der Dienste und Arbeitslasten in der Produktionsumgebung angezeigt, die bei einer Anwendung registriert sind.

gcloud

So rufen Sie Anwendungen in einem Projekt auf:

gcloud apphub applications list \
    --project=HOST_PROJECT_ID \
    --location=REGION

So listen Sie registrierte Dienste in einer Anwendung auf:

gcloud apphub applications services list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

So listen Sie registrierte Arbeitslasten in einer Anwendung auf:

gcloud apphub applications workloads list \
    --application=APPLICATION_NAME \
    --project=HOST_PROJECT_ID \
    --location=REGION

Optional: Anwendungsmesswerte ansehen

Sie können die Systemmesswerte für die Anwendungen aufrufen, die in Ihrem App Hub-Hostprojekt erstellt wurden. Diese Messwerte entsprechen den Goldenen Signalen – Traffic, Fehler, Latenz und Sättigung –, mit denen sich die Leistung und der Zustand der Anwendung überwachen lassen.

  1. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

    Wechseln Sie zu „Anwendungen“

  2. Klicken Sie auf den Namen einer Anwendung.

    Auf dem Tab Dienste und Arbeitslasten werden die Metadaten der Dienste und Arbeitslasten angezeigt, die für Ihre Anwendung registriert sind.

  3. Optional: Mit der Zeitraumauswahl können Sie den Zeitraum ändern, für den die Messwerte angezeigt werden. Der Standardzeitraum ist 1 Stunde.

  4. Wenn Sie die Systemmesswerte der registrierten Dienste und Arbeitslasten aufrufen möchten, klicken Sie auf bar_chart Messwerte.

    Eine Tabelle mit den folgenden Golden Signals wird angezeigt:

    • Traffic: Die Rate der eingehenden Anfragen an die Ressource im ausgewählten Zeitraum.
    • Serverfehlerrate: Der durchschnittliche Prozentsatz der eingehenden Anfragen, die im ausgewählten Zeitraum HTTP-Fehlercodes der 5xx-Reihe generieren.
    • P95-Latenz: Das 95. Perzentil der Latenz für eine Dienstanfrage, aggregiert über den ausgewählten Zeitraum, in Millisekunden.
    • CPU-Auslastung: Die durchschnittliche prozentuale CPU-Auslastung für eine Arbeitslast, aggregiert über den angegebenen Zeitraum. Die Werte liegen in der Regel zwischen 0,0 und 100,0, können aber auch über 100,0 liegen.
    • Speicherauslastung: Der durchschnittliche Prozentsatz der Arbeitsspeicherauslastung für eine Arbeitslast, aggregiert über den angegebenen Zeitraum.

Optional: Messwerte mithilfe von Diagrammen untersuchen

Verwenden Sie den Metrics Explorer, um Messwerte für Ihre App Hub-Projekte in Diagrammen darzustellen. Sie können einschränken, welche Daten in Diagrammen dargestellt werden, indem Sie Filter anwenden, die auf Labels basieren. Weitere Informationen finden Sie unter Diagramme mit dem Metrics Explorer erstellen.

Die folgenden App Hub-Systemmetadatenlabels stehen für die Filterung zur Verfügung (Vorabversion):

  • apphub_application_host_project_id
  • apphub_application_id
  • apphub_application_location
  • apphub_workload_criticality_type
  • apphub_workload_environment_type
  • apphub_workload_id

So visualisieren Sie die Metadatenlabels des App Hubs in einem Diagramm: Für die anderen Systemmetadatenlabels und App Hub-Messwerte können Sie das gleiche Verfahren verwenden.

  1. Rufen Sie in der Google Cloud Console die Seite Metrics Explorer auf.

    Zum Metrics Explorer

    Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

  2. Maximieren Sie im Element Messwert das Menü Messwert auswählen, geben Sie VM Instance in die Filterleiste ein und wählen Sie dann über die Untermenüs einen bestimmten Ressourcentyp und Messwert aus:
    1. Wählen Sie im Menü Aktive Ressourcen die Option VM-Instanz aus.
    2. Wählen Sie im Menü Aktive Messwertkategorien die Option Beliebte Messwerte aus.
    3. Wählen Sie im Menü Aktive Messwerte die Option CPU-Auslastung aus.
    4. Klicken Sie auf Anwenden.
    Der voll qualifizierte Name für diesen Messwert ist compute.googleapis.com/instance/cpu/utilization.
  3. Konfigurieren Sie, wie die Daten angezeigt werden. So rufen Sie nur die Messwerte für ein bestimmtes Label auf:
    1. Klicken Sie im Element Filter auf Filter hinzufügen und wählen Sie dann apphub_application_id aus. Geben Sie als Wert einen bestimmten App-Hub-Namen ein.
    2. Legen Sie im Eintrag Aggregation das erste Menü auf Nicht aggregiert fest.

    Weitere Informationen zum Konfigurieren eines Diagramms finden Sie unter Messwerte bei Verwendung von Metrics Explorer auswählen.

Bereinigen

Bereinigen Sie eine vorhandene Anwendung und entfernen Sie einen Dienstprojektanhang aus dem Hostprojekt, um die mit dem Projekt verknüpften Ressourcen zu entfernen. Dadurch wird die automatische Erkennung von Ressourcen im Dienstprojekt beendet.

Dazu müssen Sie zuerst die für die Anwendung registrierten Arbeitslasten und Dienste löschen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Anwendungen des App Hubs auf.

    Wechseln Sie zu „Anwendungen“

  2. Klicken Sie auf den Namen einer Anwendung. Eine Liste der für die Anwendung registrierten Dienste und Arbeitslasten wird angezeigt.

  3. Dienst oder Arbeitslast abmelden

    1. Klicken Sie auf dem Tab Dienste und Arbeitslasten im Bereich Registrierte Dienste und Arbeitslasten auf den Namen des Dienstes oder der Arbeitslast, die Sie abmelden möchten.
    2. Klicken Sie auf dem Tab Details auf Registrierung aufheben, um den Dienst oder die Arbeitslast als Gefunden zu aktualisieren.
      Auf dem Tab Dienste und Arbeitslasten wird in einer Benachrichtigung angezeigt, dass die Arbeitslast nicht registriert ist.
    3. Wiederholen Sie diese Anleitung für jeden Dienst und jede Arbeitslast.
  4. Rufen Sie die Seite Anwendungen im App Hub auf.

    Wechseln Sie zu „Anwendungen“

  5. Klicken Sie auf den Namen einer Anwendung.

  6. Klicken Sie auf der Seite mit den Anwendungsdetails auf Löschen.

  7. Informationen zum Entfernen der Dienstprojekte aus Ihrem Hostprojekt finden Sie im Abschnitt Dienstprojekte hinzufügen oder entfernen dieses Dokuments.

  8. So entfernen Sie die Dienstprojekte aus dem Messwertbereich des Hostprojekts:

    1. Öffnen Sie in der Google Cloud Console die Seite Einstellungen.

      Einstellungenaufrufen

      Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Monitoring ist.

    2. Wählen Sie Messwertumfang aus.
    3. Klicken Sie im Bereich Google Cloud-Projekte auf Projekt entfernen und schließen Sie das Bestätigungsdialogfeld ab.

gcloud

  1. Listen Sie die registrierten Arbeitslasten in der Anwendung auf:

    gcloud apphub applications workloads list \
      --application=APPLICATION_NAME --project=HOST_PROJECT_ID \
      --location=REGION
    
  2. So melden Sie die Arbeitslast von der Anwendung ab:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Die Arbeitslast ist jetzt eine erkannte Arbeitslast, die bei der Anwendung registriert werden kann.

  3. Wiederholen Sie den vorherigen Befehl, um die verbleibenden registrierten Arbeitslasten aus der Anwendung zu löschen.

  4. Listen Sie die registrierten Dienste in der Anwendung auf:

    gcloud apphub applications services list \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    
  5. Melden Sie den Dienst von der Anwendung ab:

    gcloud apphub applications services delete SERVICE_NAME \
      --application=APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    

    Der Dienst ist jetzt ein gefundener Dienst, der für die Anwendung registriert werden kann.

  6. Wiederholen Sie den vorherigen Befehl, um die Registrierung der verbleibenden registrierten Dienste von der Anwendung aufzuheben.

  7. So löschen Sie die Anwendung:

    gcloud apphub applications delete APPLICATION_NAME \
      --project=HOST_PROJECT_ID \
      --location=REGION
    
  8. So entfernen Sie ein Dienstprojekt aus dem Hostprojekt:

    gcloud apphub service-projects remove SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    
  9. Wiederholen Sie den vorherigen Befehl, um alle Dienstprojekte aus dem Hostprojekt zu entfernen.

  10. Entfernen Sie die Dienstprojekte aus dem Messwertbereich des Hostprojekts (Vorabversion):

    gcloud beta monitoring metrics-scopes delete projects/SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    
  11. Wiederholen Sie den vorherigen Befehl, um alle Dienstprojekte aus dem Hostprojekt mit Messumfang zu entfernen.

Nächste Schritte