Cloud Assist-Prüfung erstellen

Auf dieser Seite wird beschrieben, wie Sie Gemini Cloud Assist-Prüfungen erstellen und prüfen.

Vorbereitung

  1. Prüfen Sie, ob in Ihrem Projekt die folgenden APIs aktiviert sind:

    • cloudaicompanion.googleapis.com
    • cloudasset.googleapis.com
    • cloudresourcemanager.googleapis.com
    • geminicloudassist.googleapis.com
    • logging.googleapis.com (empfohlen)
    • monitoring.googelapis.com (empfohlen)

    Eine Anleitung zum Aktivieren von APIs finden Sie unter Dienste aktivieren und deaktivieren.

  2. Um die erforderlichen Berechtigungen zum Erstellen einer Prüfung zu bekommen, bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Investigation Creator (roles/geminicloudassist.investigationCreator) für das Projekt zuzuweisen.

    Diese vordefinierte Rolle enthält die Berechtigung, die zum Erstellen einer Prüfung in Ihrem Projekt erforderlich ist. Wenn Sie eine Prüfung erstellen, wird Ihnen die IAM-Rolle Investigation Owner (roles/geminicloudassist.investigationOwner) für diese Prüfung zugewiesen. So können Sie die Ergebnisse der Prüfung einsehen.

  3. Der Zugriff auf das geprüfte Produkt hängt von Ihrem Zugriff ab.

    Wenn Sie eine Prüfung durchführen, verwendet Gemini Cloud Assist Ihre Anmeldedaten, um auf APIs und Informationen zuzugreifen. Das bedeutet, dass der Zugriff der Prüfung von Ihrem Zugriff abhängt bzw. auf diesen beschränkt ist.

  4. Wenn Sie eine Anwendung prüfen möchten, muss sie in einem für die Verwaltung von Anwendungen konfigurierten Ordner enthalten sein.

Prüfung erstellen

Console

  1. Wenn Sie eine neue Prüfung erstellen möchten, klicken Sie auf die Schaltfläche Prüfen, die mit Ihrem Einstiegspunkt verknüpft ist. Ein typischer Einstiegspunkt für das Erstellen einer Prüfung ist die Seite Cloud Assist-Prüfungen.

    Zu Cloud Assist-Prüfungen

  2. Optional: Geben Sie unter Name einen Namen für die Prüfung ein.

    Der von Ihnen gewählte Name dient zur Identifizierung dieser Prüfung in Ihrem Prüfungsverlauf. Wenn Sie diesen Schritt überspringen, wird der Name für die Prüfung automatisch generiert.

  3. Beschreiben Sie das Problem, das bei Ihnen auftritt.

    Sie können die genaue Fehlermeldung, die Sie erhalten haben, kopieren und einfügen, das Problem in natürlicher Sprache beschreiben oder beides ausführen.

  4. Wählen Sie die Startzeit aus, zu der das Problem, das Sie untersuchen, aufgetreten ist.

  5. (Optional) Wählen Sie die Endzeit aus, zu der das Problem, das Sie untersuchen, nicht mehr bestand.

  6. Wenn Anwendungsprüfungen von Ihrem Einstiegspunkt unterstützt werden, wählen Sie im Feld Anwendung eine Anwendung aus, die geprüft werden soll.

    • Bei Einstiegspunkten, die keine App-Prüfungen unterstützen, wird Ihr aktuelles Projekt als Zielprojekt aufgeführt und kann nicht geändert werden.

  7. (Optional) Klicken Sie auf + Ressource hinzufügen, um die Ressourcen auszuwählen, die von dem Problem betroffen sind.

    Sie können Ressourcen entweder über die Ressourcenauswahl oder manuell hinzufügen. Wenn Sie Ressourcen manuell eingeben, sollten Sie in der Referenzdokumentation der Ressource nachsehen, ob Sie das richtige Format verwenden.

    Eine Prüfung kann nicht fortgesetzt werden, wenn Folgendes enthalten ist:

    • Ressourcen, die sich in einem Projekt oder einer Anwendung außerhalb des Geltungsbereichs der Prüfung befinden.
    • Ressourcen, die nicht unterstützt werden.
    • Ressourcen, die nicht erkannt werden.

  8. Klicken Sie auf Erstellen, um die Prüfung zu starten.

Es kann einige Minuten dauern, bis die Prüfung abgeschlossen ist. Sie können den Status der Prüfung über die Schaltfläche Benachrichtigungen () einsehen.

API

  1. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

    {
"title": "INVESTIGATION_NAME",
"observations": {
  "user.project": {
    "id": "user.project",
    "observationType": "OBSERVATION_TYPE_STRUCTURED_INPUT",
    "observerType": "OBSERVER_TYPE_USER",
    "text": "PROJECT_NAME"
  },
  "user.input.text": {
    "id": "user.input.text",
    "observationType": "OBSERVATION_TYPE_TEXT_DESCRIPTION",
    "observerType": "OBSERVER_TYPE_USER",
    "timeIntervals": [
      {
        "startTime": "ISSUE_START_TIME"
      }
    ],
    "text": "ISSUE_DESCRIPTION",
    "relevantResources": [
      "AFFECTED_RESOURCE"
    ],
  },
}

    Ersetzen Sie Folgendes:

    • INVESTIGATION_NAME: Geben Sie einen Namen für die Prüfung ein. Beispiel: Missing Cloud Storage bucket.

    • PROJECT_NAME: Geben Sie den Namen des Projekts ein, in dem die Prüfung erstellt wird. Beispiel: my-project.

    • ISSUE_START_TIME: Geben Sie das Datum und die Uhrzeit ein, zu der das Problem, das Sie untersuchen, aufgetreten ist. Beispiel: 2025-07-08T17:23:00Z

    • ISSUE_DESCRIPTION: Geben Sie eine Beschreibung des Problems ein. Sie können die genaue Fehlermeldung, die Sie erhalten haben, angeben, das Problem in natürlicher Sprache beschreiben oder Sie können beides angeben.

    • AFFECTED_RESOURCE: Geben Sie den Namen der Ressource ein, die von dem Problem betroffen ist. Beispiel: //storage.googleapis.com/my-bucket Um sicherzustellen, dass Sie das richtige Format für eine Ressource verwenden, sollten Sie die Referenzdokumentation der Ressource aufrufen.

    Eine vollständige Darstellung einer Prüfungsressource finden Sie in der Ressourcenspezifikation.

  2. Zugriffstoken abrufen:

    TOKEN=$(gcloud auth print-access-token)

  3. Verwenden Sie die Methode investigations.create, um die Prüfung zu erstellen.

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"

    Ersetzen Sie Folgendes:

    • JSON_FILE_NAME: Geben Sie den Pfad zur JSON-Datei ein, die Sie zuvor erstellt haben. Beispiel: Desktop/my-investigation.json

    • PROJECT_NAME: Geben Sie denselben Projektnamen ein, den Sie in die user.project-Beobachtung aufgenommen haben.

  4. Kopieren Sie in der Antwort den Wert des Parameters revision.

  5. Verwenden Sie die Methode investigations.revisions.run, um die Prüfung auszuführen:

    curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"

    Ersetzen Sie REVISION_RESOURCE durch den Wert, den Sie aus dem Parameter revision kopiert haben.

Es kann einige Minuten dauern, bis die Prüfung abgeschlossen ist. Sie können den Status der Prüfung prüfen, indem Sie den Wert des name-Parameters kopieren, der in der investigations.revisions.run-Antwort zurückgegeben wurde, und ihn im name-Parameter einer operations.get-Anfrage verwenden.

Prüfung ansehen

Nach Abschluss der Prüfung können Sie die Prüfungsdetails über den Einstiegspunkt aufrufen, über den Sie die Prüfung gestartet haben, oder über den Prüfungsverlauf Ihres Projekts.

Eine Prüfung enthält die folgenden Abschnitte:

  1. Das Problem

    Dieser Abschnitt enthält die Eingabeinformationen, die zum Generieren der Prüfungsergebnisse verwendet wurden, z. B. die Problembeschreibung, Zeitstempel und Listen relevanter Ressourcen. Es gibt drei Arten von Ressourcenlisten, die mit der Prüfung verknüpft sein können:

    • Vom Nutzer bereitgestellte Ressourcen: Ressourcen, die vom Nutzer bereitgestellt oder aus dem ursprünglichen Fehler abgerufen werden.
    • Gefundene Ressourcen: Zusätzliche Ressourcen, die von Gemini für die Prüfung berücksichtigt wurden.
    • Relevante Ressourcen: Die Ressourcen, die Gemini als relevant für die Hypothesen zur Ursache des Problems betrachtet. Dazu gehören immer die vom Nutzer bereitgestellten Ressourcen.

  2. Die Beobachtungen

    Dieser Abschnitt enthält Beobachtungen, die im Rahmen der Prüfung generiert wurden. Die Beobachtungen basieren auf der Überprüfung von Verfahrenshandbüchern, Protokollen, Ausfallmeldungen und Benachrichtigungen. Aus diesen Beobachtungen generiert Gemini Hypothesen zur Ursache des Problems, das Sie untersuchen.

  3. Die Hypothesen

    Dieser Abschnitt enthält eine oder mehrere Hypothesen, die auf den Daten basieren, die bei der Prüfung erhoben wurden, und auf den dabei gemachten Beobachtungen. Eine Hypothese enthält eine Übersicht darüber, was das Problem sein könnte, und empfohlene Korrekturen. Das sind Maßnahmen, mit denen Sie das Problem beheben können oder die Ihnen zusätzliche Schritte zur Fehlerbehebung bieten, um die Hypothese zu bestätigen oder zu widerlegen.

Sie können die Eingabe für die Prüfung überarbeiten, indem Sie auf die Schaltfläche Bearbeiten klicken. So können Sie die Prüfung mit aktualisierten Informationen noch einmal ausführen. Wenn einer Prüfung mehrere Ausführungen zugeordnet sind, können Sie die Ergebnisse der vorherigen Läufe der Prüfung über das Drop-down-Menü Revision aufrufen.

Weitere Informationen