Manage integrations

You can modify an integration by configuring tasks, triggers, or edge connections. You can also update the integration details, such as modifying the setting for masking variables in logs, Cloud Logging, local logging, and updating the service account and the description of your integration.

Integration edit locks

Integrations are design time entities that are often developed in collaboration with multiple authors. Although an integration can only be actively edited by one author at a time, teams can collaborate on an integration and track changes in state through itsversions.

You can edit only aDRAFT version of the integration, and execute only theACTIVE version of the integration. For information about different integration versions, seeIntegration versions.

When you open an integration, you might find a message similar to the following in the integration editor:

• If you open the integration that is being edited by another user, the following message appears in the integration editor because only one user can update the integration at a given time:

  test-user@gmail.com is currently editing the integration. Edit features are temporarily disabled.

  Note: The integration is locked for editing by others for 15 minutes from the last update. Locks are released after 15 minutes from the last update.

  To edit the integration, clickTake Over. A new version in theDRAFT state is created in the integration for you and the editing capability is disabled for the other users. The following figure shows the edit lock in the integration editor.

  

• If you open a published integration, then the integration version is in theACTIVE state. To edit the integration, clickEnable Editing. A new version is created with theDRAFT state.

  This version is currently active. Editing features are disabled.

  To edit the integration, clickEnable Editing. A new version in theDRAFT state is created in the integration for you.The following figure shows the edit lock in the integration editor.

  

Edit an integration

To view and edit an integration flow, follow these steps:

1. In the Google Cloud console, go to theApplication Integration page.

   Go to Application Integration

2. In the navigation menu, clickIntegrations.

   TheIntegrations page appears, listing all the integrations available in the Google Cloud project.

3. Click the integration that you want to edit. This opens the integration in the integration editor.

   If the integration is not inDRAFT state, then the integration is locked for editing. For information about edit locks, seeIntegration edit locks.

Delete integrations

1. In the Google Cloud console, go to theApplication Integration page.

   Go to Application Integration

2. ClickIntegrations from the left navigation menu to open theIntegrations page.
3. Do any one of the following steps in theIntegrations List page:
   1. For the existing integration that you want to delete, click more_vertActions.
   2. SelectDelete in the drop-down menu.

      A confirmation dialog appears.

   Or
   1. Click the existing integration that you want to delete.

      This opens the integration in theintegration editor.

   2. In the designer toolbar, click more_vert (Actions menu) and selectClone integration > Delete all versions.

      A confirmation dialog appears.

   3. ClickDelete to permanently delete the integration.

Manage integration details

You can view the integration summary and update settings for your integration. The following image shows thesettings Integration settings andinfo Integration information icons on the Application Integration editor toolbar:

View integration details

To view the details of an integration, open the integration in the integration editor and clickinfo (Integration information) in the designer toolbar. The following image shows the integration details:

The integration summary includes the following information:

• Integration name: The name of the integration.
• Version: The current version of the integration along with the version name (if any). For information about versioning, seeVersions.
• Publish status: The publish status of the current version of the integration;Published orUnpublished.
• Total versions: The count of the total number of integration versions created for the integration.
• Last modified: The date and time when the current integration version was last edited or modified.
• Last modified by The name of the user who last edited or modified the integration version.
• Region: The regional location where the integration was created.
• Description: The integration description. To generate integration description using Gemini, seeBuild integrations with Gemini Code Assist.

Edit integration details

To edit the details of an integration, open the integration in the integration editor and clicksettings (Integration settings) in the designer toolbar. The following image shows theIntegration Settings pane:

The integration summary includes the following information:

• Service account: The service account attached to the integration.
• Enable Variable Masking in logs (preview): The setting to enable masking of variables in the integration execution logs. If you enable masking for your integration, ensure that you have also enabled masking at theregion and thevariable levels.

  For information about masking, seeMask sensitive data in logs.

• Enable Cloud Logging: The setting to enable or disable Cloud Logging. For more information, seeView logs in Cloud Logging.
• Local logging: The setting to enable or disable saving integration's data or metadata during its execution. By default, local logging is set toEnable(async). In this mode, the integration takes a relatively lesser time to execute when compared to theEnable(sync) mode, because Application Integration writes the log data asynchronously during the integration execution. However, this mode doesn't guarantee the generation of logs for all the executions. In rare cases–such as a physical server failure–it's possible that logs aren't generated for an integration execution. For more information, seeLocal logging.

• Learn how totest and publish integrations.
• Learn how tocreate an integration.
• Learn how toclone integrations.
• Learn aboutlogs in Application Integration.