Pipelinemesswerte aufrufen

Nachdem Sie eine Pipeline definiert, erstellt und ausgeführt haben, können Sie Messwerte, die sich auf den Pipelinejob oder die Pipelineaufgaben beziehen, im Metrics Explorer ansehen. Darüber hinaus können Sie mit Cloud Logging benutzerdefinierte logbasierte Messwerte und Benachrichtigungen erstellen, um Ereignisse wie Pipelinefehler zu überwachen.

Auf dieser Seite wird Folgendes beschrieben:

Das Erstellen und Aufrufen benutzerdefinierter Messwerte in Cloud Logging ist mit Kosten verbunden. Weitere Informationen finden Sie unter Cloud Logging – Preise.

Vertex AI Pipelines-Standardmesswerte im Metrics Explorer ansehen

Sie können die folgenden Messwerte zu Vertex AI Pipelines im Metrics Explorer aufrufen:

Laufzeitdauer von Pipelinejobs aufrufen

Gehen Sie nach der folgenden Anleitung vor, um den Messwert Vertex Pipelines Job - PipelineJob duration in der Google Cloud Console aufzurufen:

  1. Rufen Sie den Metrics Explorer auf:

    Zum Metrics Explorer

  2. Wählen Sie in der Liste Messwert die Option Vertex Pipelines-Job > Pipelinejob > PipelineJob-Dauer aus.

  3. Klicken Sie auf Anwenden.

  4. Optional: Geben Sie zum Filtern der Abfrage ein oder mehrere Kriterien an, indem Sie auf Filter klicken. Beispiel:

    • Verwenden Sie den Filter pipeline_job_id, um die Laufzeitdauer eines bestimmten Pipelinejobs aufzurufen.

    • Verwenden Sie den Filter location, um die Laufzeitdauer von Pipelinejobs für einen bestimmten Standort aufzurufen.

    • Verwenden Sie den Filter run_state, um die Laufzeitdauer von Pipelinejobs im Status PIPELINE_JOB_RUNNING, PIPELINE_JOB_CANCELLED oder PIPELINE_JOB_PENDING aufzurufen.

Anzahl der Pipelineausführungen ansehen

Gehen Sie nach der folgenden Anleitung vor, um den Messwert Location - Executing PipelineJobs in der Google Cloud Console aufzurufen:

  1. Rufen Sie den Metrics Explorer auf:

    Zum Metrics Explorer

  2. Wählen Sie in der Liste Messwert Location > Executing_vertexai_pipeline_jobs > PipelineJobs ausführen aus.

  3. Klicken Sie auf Anwenden.

  4. Optional: Geben Sie zum Filtern der Abfrage ein oder mehrere Kriterien an, indem Sie auf Filter klicken. Verwenden Sie beispielsweise den Filter location, um die Anzahl der Pipelinejobs für einen bestimmten Standort aufzurufen.

Anzahl der abgeschlossenen Pipelineaufgaben ansehen

Gehen Sie nach der folgenden Anleitung vor, um den Messwert Vertex Pipelines Job - Completed PipelineTasks in der Google Cloud Console aufzurufen:

  1. Rufen Sie den Metrics Explorer auf:

    Zum Metrics Explorer

  2. Wählen Sie in der Liste Messwert die Option Vertex Pipelines-Job > Pipelinejob > Abgeschlossene PipelineTasks aus.

  3. Klicken Sie auf Anwenden.

  4. Optional: Geben Sie zum Filtern der Abfrage ein oder mehrere Kriterien an, indem Sie auf Filter klicken. Beispiel:

    • Verwenden Sie den Filter pipeline_job_id, um die Anzahl der Aufgaben anzusehen, die in einer bestimmten Pipelineausführung abgeschlossen wurden.

    • Verwenden Sie den Filter location, um die Anzahl der Aufgaben anzuzeigen, die in Pipelineausführungen für einen bestimmten Standort abgeschlossen wurden.

Anzahl der ausgeführten Pipelineaufgaben ansehen

Gehen Sie nach der folgenden Anleitung vor, um den Messwert Location - Executing PipelineTasks in der Google Cloud Console aufzurufen:

  1. Rufen Sie den Metrics Explorer auf:

    Zum Metrics Explorer

  2. Wählen Sie in der Liste Messwert Location > Executing_vertexai_pipeline_tasks > PipelineTasks ausführen aus.

  3. Klicken Sie auf Anwenden.

  4. Optional: Geben Sie zum Filtern der Abfrage ein oder mehrere Kriterien an, indem Sie auf Filter klicken. Verwenden Sie beispielsweise den Filter location, um die Anzahl der Pipelineaufgaben anzusehen, die für einen bestimmten Standort ausgeführt werden.

Benutzerdefinierte Messwerte im Log-Explorer erstellen und aufrufen

Sie können den Log-Explorer in der Google Cloud Console nutzen, um benutzerdefinierte logbasierte Messwerte zu erstellen, die Muster in Ihren Pipelinelogs verfolgen und analysieren.

Beispiele für benutzerdefinierte Messwerte

In diesem Abschnitt werden Beispiele für benutzerdefinierte Messwerte gezeigt, die Sie erstellen können. Dazu gehören die folgenden:

Benutzerdefinierten Messwert für fehlgeschlagene Pipelinejobs erstellen

So erstellen Sie einen benutzerdefinierten logbasierten Zählermesswert, der fehlgeschlagene Pipelinejobs überwacht:

  1. Rufen Sie den Log-Explorer auf:

    Zu „Log-Explorer“

  2. Wählen Sie das entsprechende Google Cloud-Projekt aus.

  3. Wählen Sie im Drop-down-Menü Ressource die Option Vertex-Pipeline-Job aus.

  4. Wählen Sie im Drop-down-Menü Standort den Speicherort Ihrer Pipeline aus.

  5. Wählen Sie im Drop-down-Menü Alle Pipelinejob-IDs die ID Ihres Pipelinejobs aus.

  6. Klicken Sie auf Anwenden.

  7. Klicken Sie auf Messwert erstellen.

  8. Im Bildschirm Logmesswert erstellen:

    1. Legen Sie den Messwerttyp fest: Wählen Sie Zähler aus.

    2. Legen Sie im Abschnitt Details die folgenden Felder fest:

      • Name des Logmesswerts: Geben Sie einen Namen für den Logmesswert ein, z. B. pipelinejob_failed. Wählen Sie einen Namen aus, der unter den logbasierten Messwerten in Ihrem Google Cloud-Projekt nur einmal vorkommt. Für die Benennung gelten einige Einschränkungen. Weitere Informationen finden Sie unter Fehlerbehebung.
      • Beschreibung: Geben Sie eine Beschreibung für den Messwert ein.
      • Einheiten: Lassen Sie dieses Feld leer oder geben Sie die Ziffer 1 ein.

    3. Definieren Sie den Messwertfilter im Abschnitt Filterauswahl. Erstellen Sie einen Filter, der nur die Logeinträge erfasst, die Sie in Ihrem Messwert mit der Logging-Abfragesprache zählen möchten. Beispiel:

      resource.type="aiplatform.googleapis.com/PipelineJob"
jsonPayload.state="PIPELINE_STATE_FAILED"

      Sie können auch reguläre Ausdrücke verwenden, um Filter des Messwerts zu erstellen.

      Klicken Sie auf Logs ansehen, um ein Steuerfeld zu öffnen, in dem die Logeinträge angezeigt werden, die dem Filter entsprechen.

    4. Optional: Fügen Sie im Abschnitt Labels ein Label hinzu. Eine Anleitung zum Erstellen von Labels finden Sie unter Label erstellen.

    5. Klicken Sie auf Messwert erstellen, um den Messwert zu erstellen.

Benutzerdefinierten Messwert für den endgültigen Pipelinestatus erstellen

So erstellen Sie einen benutzerdefinierten logbasierten Zählermesswert, der den endgültigen Zustand Ihrer Pipelinejobs überwacht:

  1. Rufen Sie den Log-Explorer auf:

    Zu „Log-Explorer“

  2. Wählen Sie das entsprechende Google Cloud-Projekt aus.

  3. Wählen Sie im Drop-down-Menü Ressource die Option Vertex-Pipeline-Job aus.

  4. Wählen Sie im Drop-down-Menü Standort den Speicherort Ihrer Pipeline aus.

  5. Wählen Sie im Drop-down-Menü Alle Pipelinejob-IDs die ID Ihres Pipelinejobs aus.

  6. Klicken Sie auf Anwenden.

  7. Klicken Sie auf Messwert erstellen.

  8. Im Bildschirm Logmesswert erstellen:

    1. Legen Sie den Messwerttyp fest: Wählen Sie Zähler aus.

    2. Legen Sie im Abschnitt Details die folgenden Felder fest:

      • Name des Logmesswerts: Geben Sie einen Namen für den Logmesswert ein, z. B. Pipeline_state_final. Wählen Sie einen Namen aus, der unter den logbasierten Messwerten in Ihrem Google Cloud-Projekt nur einmal vorkommt. Für die Benennung gelten einige Einschränkungen. Weitere Informationen finden Sie unter Fehlerbehebung.
      • Beschreibung: Geben Sie eine Beschreibung für den Messwert ein.
      • Einheiten: Lassen Sie dieses Feld leer oder geben Sie die Ziffer 1 ein.

    3. Definieren Sie den Messwertfilter im Abschnitt Filterauswahl. Erstellen Sie einen Filter, der nur die Logeinträge erfasst, die Sie in Ihrem Messwert mit der Logging-Abfragesprache zählen möchten. Beispiel:

      resource.type="aiplatform.googleapis.com/PipelineJob"
jsonPayload.state="PIPELINE_STATE_SUCCEEDED" OR
"PIPELINE_STATE_FAILED" OR "PIPELINE_STATE_CANCELLED"

      Sie können auch reguläre Ausdrücke verwenden, um Filter des Messwerts zu erstellen.

      Klicken Sie auf Logs ansehen, um ein Steuerfeld zu öffnen, in dem die Logeinträge angezeigt werden, die dem Filter entsprechen.

    4. Optional: Fügen Sie im Abschnitt Labels ein Label hinzu. Eine Anleitung zum Erstellen von Labels finden Sie unter Label erstellen.

    5. Klicken Sie auf Messwert erstellen, um den Messwert zu erstellen.

Fehlerrate der Pipelinejobs anzeigen

Die Fehlerrate der Pipelinejobs wird als Verhältnis der Anzahl der Pipelinejobs im endgültigen Zustand gegenüber der Anzahl der fehlgeschlagenen Pipelinejobs berechnet. So erstellen Sie ein Dashboard, um die Fehlerrate des Pipelinejobs zu überwachen:

  1. Erstellen Sie einen Messwert, um die Pipelinejobs im endgültigen Zustand zu überwachen. Weitere Informationen finden Sie unter Benutzerdefinierten Messwert für den endgültigen Pipelinezustand erstellen.

  2. Erstellen Sie einen Messwert, um die Pipelinejobs im fehlgeschlagenen Zustand zu überwachen. Weitere Informationen finden Sie unter Benutzerdefinierten Messwert für fehlgeschlagene Pipelinejobs erstellen.

  3. Rufen Sie im Abschnitt Monitoring der Google Cloud Console die Seite „Metrics Explorer“ auf.

    Seite Metrics Explorer aufrufen

  4. Führen Sie auf dem Tab Konfiguration folgende Schritte aus:

    1. Klicken Sie auf Weiteren Messwert hinzufügen.

    2. Wählen Sie die Option Messwerte als Verhältnis anzeigen aus. Wenn Sie diese Option auswählen:

      • Der Bereich Zeitreihe A wird in Zähler umbenannt.

      • Der Bereich Zeitreihe B wird in Nenner umbenannt.

    3. Klicken Sie im Bereich Zähler auf Messwert auswählen, um den Messwert auszuwählen, der für fehlgeschlagene Pipelinejobs erstellt wurde.

    4. Klicken Sie im Bereich Nenner auf Messwert auswählen, um den Messwert auszuwählen, der für endgültige Pipelinejobs erstellt wurde.

    5. (Optional) Konfigurieren Sie den Zähler und den Nenner, indem Sie Filter hinzufügen oder die Gruppierungsfelder und Ausrichtungsparameter aktualisieren.

      Weitere Informationen zum Hinzufügen von Filtern oder zum Aktualisieren der Gruppierungsfelder und Ausrichtungsparameter finden Sie unter Verhältnis von Messwerten grafisch darstellen.

    Nachdem Sie den Zähler und den Nenner ausgewählt haben, wird die Fehlerrate des Pipelinejobs in der Grafik angezeigt.

    • Nachdem Sie das Diagramm für die Fehlerrate des Pipelinejobs generiert haben, können Sie es Ihrem benutzerdefinierten Dashboard hinzufügen. Weitere Informationen finden Sie unter Diagramm zur späteren Verwendung speichern.

    • Um die URL zu kopieren, die die Diagrammkonfiguration enthält, klicken Sie auf das Dreipunkt-Symbol oben rechts im Diagramm und dann auf Nach URL freigeben.