Informationen zu den unterstützten Connectors für Application Integration.

Cloud Scheduler-Trigger

Mit dem Cloud Scheduler-Trigger können Sie die Integrationsausführungen für bestimmte Zeiträume oder regelmäßige Intervalle über mehrere Regionen hinweg planen.

Für Cloud Scheduler-Trigger werden die Cloud Scheduler-Dienste genutzt, um in Application Integration einen vollständig verwalteten Cronjob-Planer für Unternehmen bereitzustellen. Mit diesem Trigger können Sie jetzt alle Cronjobs verwalten, die innerhalb Ihrer Integration erstellt wurden, sowohl über die Application Integration-UI als auch über das Cloud Scheduler-Dashboard. Darüber hinaus können Sie mit dem Cloud Scheduler-Trigger auch regionsübergreifende Cronjobs bereitstellen, um Ihre Integrationsausführungen zu planen.

Wenn Sie beispielsweise die Integration in us-central1 bereitgestellt haben, können Sie mit dem Cloud Scheduler-Trigger einen Cronjob in asia-east1 (oder einem der unterstützten Google Cloud-Regionen für Cloud Scheduler) bereitstellen, um den Endpunkt Ihrer Integration unter us-central1 aufzurufen.

Wichtig:Für die Nutzung der Cloud Scheduler-Dienste in Ihrer Einbindung fallen gesonderte Gebühren an. Die Gebühren richten sich nach der Anzahl der Cronjobs, die mit dem Cloud Scheduler-Trigger in Application Integration erstellt wurden. Weitere Informationen zu den Cloud Scheduler-Gebühren finden Sie unter Cloud Scheduler-Preise.

Hinweise

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie den Cloud Scheduler-Trigger konfigurieren:

1. Aktivieren Sie die Cloud Scheduler API (cloudscheduler.googleapis.com).

   Cloud Scheduler API aktivieren

2. Prüfen Sie, ob Sie ein Google-Dienstkonto mit der Rolle Application Integration Invoker haben. Wenn Sie kein Dienstkonto haben, müssen Sie ein neues erstellen und ihm die Rolle Application Integration Invoker zuweisen.

   Informationen zum Erstellen und Verwalten von Dienstkonten finden Sie unter Dienstkonten erstellen und verwalten.

   Informationen zu den vordefinierten Rollen für Application Integration finden Sie unter Vordefinierte IAM-Rollen.

Cloud Scheduler-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um Ihrer Integration einen Cloud Scheduler-Trigger hinzuzufügen:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration (Anwendungsintegration) auf.

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

   Die Seite Integrations List (Liste der Integrationen) wird angezeigt. Sie enthält eine Liste aller im Google Cloud-Projekt verfügbaren Integrationen.

3. Wähle eine vorhandene Integration aus oder klicke auf Verknüpfung erstellen, um eine neue zu erstellen.

   Wenn Sie eine neue Integration erstellen:

   1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
   2. Wählen Sie eine Region für die Integration aus.
      Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
   3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit im Bereich Zusammenfassung der Integration in der Integrationsleiste ändern oder aktualisieren.
      Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
   4. Klicken Sie auf Erstellen.

   Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.

4. Klicken Sie in der Navigationsleiste des Integrationsdesigners auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie im Integrationsdesigner auf das Element Cloud Scheduler-Trigger und platzieren Sie es dort.

Cloud Scheduler-Trigger konfigurieren

Führen Sie die folgenden Schritte aus, um einen Cloud Scheduler-Trigger zu konfigurieren:

1. Klicken Sie im Integrationsdesigner auf das Element Cloud Scheduler-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.

   Geben Sie den Zeitplan des Cloud Scheduler-Triggers mit einer der folgenden Optionen an:

   • Grundlegende Einstellungen: Verwenden Sie die Benutzeroberfläche, um den Zeitplan für Cronjobs zu konfigurieren.
   • Erweitert: Verwenden Sie einen unix-cron-Ausdruck, um den Cronjob-Zeitplan zu konfigurieren.
2. Wählen Sie bei der Option „Einfach“ den Tab Basic aus und gehen Sie folgendermaßen vor:
   1. Zeiten: Wählen Sie die Zeitintervalle aus, in denen die Integration ausgeführt werden muss.
      • Ausführung zu einem bestimmten Zeitpunkt: Wählen Sie diese Option aus, um die Integration zu einem bestimmten Zeitpunkt auszuführen.
      • Wiederholung nach Stunde: Wählen Sie diese Option aus, um die Integration wiederholt pro Stunde auszuführen.
      • Wiederholung nach Minute: Wählen Sie diese Option aus, um die Integration gemäß der angegebenen Anzahl von Minuten wiederholt auszuführen.
   2. Tage: Wählen Sie die Tage, an denen die Integration ausgeführt werden soll. Sie können die Integration täglich, an bestimmten Wochentagen oder an einem bestimmten Tag im Monat ausführen.
   3. Monate: Wählen Sie den/die Monat(e), in dem/denen die Integration ausgeführt werden muss. Sie können die Integration monatlich oder nur in bestimmten Monaten ausführen.
3. (Für die Option „Erweitert“) Wählen Sie den Tab Erweitert aus und geben Sie mit einem Cron-Ausdruck den Zeitplan des Cronjobs an.

   Der Cron-Ausdruck umfasst fünf Werte, die in der folgenden Reihenfolge angegeben werden müssen:

   1. Minute (0–59)
   2. Stunde (0–23)
   3. Tag des Monats (1–31)
   4. Monat (einer der folgenden Werte):
      • Eine Zahl (1–12)
      • Eine aus drei Buchstaben bestehende monatliche Abkürzung (z. B. Januar, Februar, März)
   5. Wochentag, mit einem der folgenden Werte:
      • Zahl von 0–6, beginnend mit Sonntag als 0
      • Eine Abkürzung aus drei Buchstaben (z. B. Mon, Die, Mit usw.)

   Wenn Sie beispielsweise die Integration am ersten Tag jedes Monats ausführen möchten, verwenden Sie den Cron-Ausdruck * * 1 * *.

   Weitere Informationen finden Sie unter Zeitpläne für Cronjobs konfigurieren.

4. Region : Wählen Sie die Region aus, in der Ihr Cloud Scheduler-Job bereitgestellt wird.
5. E-Mail-Adresse des Dienstkontos: Geben Sie die E-Mail-Adresse des erstellten Google-Dienstkontos ein.

Trigger-Ausgabe

Application Integration erstellt für jeden Cloud Scheduler-Trigger, der in Ihrer Integrationsversion konfiguriert und veröffentlicht ist, einen neuen Cloud Scheduler-Job in Ihrem Google Cloud-Projekt.

Ein Cloud Scheduler-Job wird nach der folgenden Namenskonvention erstellt, um Fehler bei der Duplikation von Jobs zu vermeiden:

    INTEGRATION_NAME__VINTEGRATION_VERSION__CLOUD_SCHEDULER_TRIGGER_NUMBER
    

Beispiel: DemoIntegration__V1__1

Trigger-Logs

Ein Cloud Scheduler-Trigger generiert zu Beginn und am Ende jeder Integrationsausführung Logs. Sie können die Cloud Scheduler-Triggerlogs auf der Seite Log-Explorer von Cloud Logging ansehen:

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

   Zu Cloud Scheduler

2. Suchen Sie Ihren Cloud Scheduler-Job und klicken Sie in der Spalte Logs auf Ansehen.

   Auf der Seite Log-Explorer von Cloud Logging werden die vom Cloud Scheduler-Trigger generierten Logs angezeigt.

Hinweis: Application Integration speichert oder erfasst keine Logs, die vom Cloud Scheduler-Trigger generiert wurden. Diese Logs werden in Ihrem Google Cloud-Projekt gespeichert und können nur über die Seite Cloud Logging-Log-Explorer aufgerufen werden.

Cloud Scheduler-Trigger bearbeiten

Application Integration

Warnung:Wenn Sie einen Cloud Scheduler-Trigger in Application Integration bearbeiten, wird der vorhandene Cronjob durch einen neuen Cronjob in einer neuen Integrationsversion überschrieben.

Führen Sie die folgenden Schritte aus, um den Cloud Scheduler-Trigger aus Application Integration zu bearbeiten:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration (Anwendungsintegration) auf.

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrations List (Liste der Integrationen) wird angezeigt.
3. Wählen Sie die Integration aus, die Sie bearbeiten möchten.
4. Klicken Sie im Integrationsdesigner auf das Drop-down-Menü Version und wählen Sie die Integrationsversion mit dem Cloud Scheduler-Trigger aus, den Sie bearbeiten möchten.
5. Heben Sie die Veröffentlichung auf und aktivieren Sie die Bearbeitung, wenn die ausgewählte Integrationsversion veröffentlicht ist (im aktiven Status).
6. Klicken Sie im Integrationsdesigner auf das Element Cloud Scheduler-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
7. Ändern Sie die Cloud Scheduler-Jobkonfigurationen nach Bedarf.

Cloud Scheduler

Sie können Ihren Cloud Scheduler-Trigger bearbeiten, indem Sie die Konfiguration des Cloud Scheduler-Jobs in Cloud Scheduler ändern:

1. Rufen Sie in der Google Cloud Console Cloud Scheduler auf.

   Zu Cloud Scheduler

2. Wählen Sie den zu bearbeitenden Job Cloud Scheduler aus.
3. Klicken Sie auf Bearbeiten.
4. Ändern Sie die Cloud Scheduler-Jobkonfigurationen nach Bedarf.

Hinweis: Wenn Sie einen Cloud Scheduler-Job in Cloud Scheduler bearbeiten, ändert sich der Status der Zielintegrationsversion nicht.

Cloud Scheduler-Job pausieren, fortsetzen oder kopieren

Application Integration unterstützt keine Vorgänge zum Anhalten, Fortsetzen und Kopieren für einen Cloud Scheduler-Job, der mit dem Cloud Scheduler-Trigger erstellt wurde.

Der Cloud Scheduler-Trigger gibt im Triggerkonfigurationsbereich einen Fehler aus, wenn Sie die Ausführung eines Cloud Scheduler-Jobs manuell über Cloud Scheduler anhalten.

Weitere Informationen zu Fehlermeldungen beim Cloud Scheduler-Trigger finden Sie unter Fehlerbehebung beim Cloud Scheduler-Trigger. Informationen zum Anhalten und Fortsetzen eines Cronjobs mit Cloud Scheduler finden Sie unter Job anhalten oder fortsetzen.

Cloud Scheduler-Job löschen

Sie können einen Cloud Scheduler-Job entweder über Ihre Integration in Application Integration oder über Cloud Scheduler löschen.

Application Integration

Führen Sie die folgenden Schritte aus, um einen Cloud Scheduler-Job aus Application Integration zu löschen:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration (Anwendungsintegration) auf.

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrations List (Liste der Integrationen) wird angezeigt.
3. Wählen Sie die Integration aus, die Sie bearbeiten möchten.
4. Klicken Sie im Integrationsentwickler auf das Drop-down-Menü Version und wählen Sie die Integrationsversion aus, die den Cloud Scheduler-Trigger enthält, den Sie löschen möchten.
5. Heben Sie die Veröffentlichung der ausgewählten Integrationsversion auf.

   Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.

Cloud Scheduler

Führen Sie die folgenden Schritte aus, um einen Cloud Scheduler-Job aus Cloud Scheduler zu löschen:

1. Rufen Sie in der Google Cloud Console Cloud Scheduler auf.

   Zu Cloud Scheduler

2. Wählen Sie den zu löschenden Cloud Scheduler -Job aus.
3. Klicken Sie auf Löschen.

   Der Cloud Scheduler-Job für die entsprechende Integrationsversion wird gelöscht.

Hinweis:

• Wenn Sie einen Cloud Scheduler-Job aus Cloud Scheduler löschen, wird der Cloud Scheduler-Trigger in Ihrer Integration in Application Integration nicht gelöscht.
• Der Cloud Scheduler-Trigger in Ihrer Integration gibt einen Fehler im Triggerkonfigurationsbereich aus, wenn ein Cloud Scheduler-Job mit Cloud Scheduler gelöscht wird. Weitere Informationen zu Fehlermeldungen beim Cloud Scheduler-Trigger finden Sie unter Fehlerbehebung beim Cloud Scheduler-Trigger.

Best Practices

Heben Sie als Best Practice die Veröffentlichung aller Cloud Scheduler-Trigger auf, wenn sie nicht mehr benötigt werden. Wenn Sie einen redundanten Cloud Scheduler-Trigger veröffentlicht lassen, ruft der Trigger die Integration weiterhin automatisch auf, was zusätzliche Kosten verursachen kann.

Fehlerbehebung beim Cloud Scheduler-Trigger

In der folgenden Tabelle werden die Fehler, die im Cloud Scheduler-Trigger auftreten können, und die entsprechenden Fehlerursachen beschrieben.

Fehlerposition	Vorkommen des Fehlers	Fehlermeldung	Mögliche Ursachen	Lösung
Bereich für die Triggerkonfiguration > Fehlermeldung	Wenn der Cloud Scheduler-Job die Ausführung Ihrer Integration stoppt	The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB doesn’t exist. It might be deleted from your Google Cloud project.	Der Cloud Scheduler-Job wird mit Cloud Scheduler gelöscht.	Erstellen Sie eine neue Integrationsversion, um den vorhandenen Cloud Scheduler-Job zu überschreiben.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is PAUSED. You must RESUME the job from your Google Cloud project.	Der Cloud Scheduler-Job wird mit Cloud Scheduler pausiert.	Fortsetzen des Cloud Scheduler-Jobs in Cloud Scheduler.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is DISABLED due to an internal system error.	Prüfen Sie die Triggerlogs, um das Problem zu identifizieren.	Erstellen Sie eine neue Integrationsversion, um den vorhandenen Cloud Scheduler-Job zu überschreiben.
		The configured Cloud Scheduler job CLOUD_SCHEDULER_JOB is in an UPDATE_FAILED state due to a failed CloudScheduler.UpdateJob operation.	Das angegebene Dienstkonto hat nicht die erforderlichen IAM-Berechtigungen.	Wenn Sie einen Job aus diesem Status wiederherstellen möchten, wiederholen Sie den CloudScheduler.UpdateJob-Vorgang, bis Sie eine erfolgreiche Antwort erhalten.
		The last execution of the Cloud Scheduler job CLOUD_SCHEDULER_JOB failed due to CLOUD_SCHEDULER_JOB_ISSUE. Learn more.	CLOUD_SCHEDULER_JOB_ISSUE	–

SLA-Ausschlüsse

Der Cloud Scheduler-Trigger hängt vom Cloud Scheduler-Produkt ab. Da diese Abhängigkeit nicht Bestandteil von Application Integration ist, gelten die Service Level Agreement (SLA) für Application Integration nur, wenn die Ausführung erfolgreich für eine active-Integration geplant wurde.