Managing Micro-Integrations

After you have created a Micro-Integration, you can perform actions to change its states, such as moving it from Deployed to Undeployed. You can also manage the Micro-Integration by modifying the configuration settings as required. When you have finished making your changes, you can redeploy the Micro-Integration.

To manage the Micro-Integration, you can perform the following actions:

Opening a Micro-Integration

You can open a Micro-Integration to view its information and configuration details. You can also view metrics for Micro-Integrations that are in a deployed state. For more information, see Viewing Micro-Integration Metrics .

To open a Micro-Integration, perform the following steps:

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. On the navigation bar, select Micro-Integration.

  3. On the Micro-Integrations page, click the name of the Micro-Integration.

    The Micro-Integration Details page opens.

Viewing Micro-Integration Metrics

Metrics appear at the top of the Micro-Integration Details page and provide information about Micro-Integration performance and usage, including:

  • the state of the Micro-Integration

  • message and byte usage

  • total messages and errors

We collect metric data at a high frequency and you can see up-to-the minute data by refreshing the Cloud Console browser tab. The table below explains the metrics shown on the card:

Metric Definition
Micro-Integration State

The current status of the Micro-Integration. The status for a Micro-Integration can be:

  • Not Deployed—The Micro-Integration has not been deployed.

  • Unable to deploy—The Micro-Integration cannot be deployed. There may be configuration problems. Review the Micro-Integration.

  • Deploying—The Micro-Integration is being deployed.

  • Running—The Micro-Integration is deployed and active.
Messages Per Second The amount of messages being handled by the Micro-Integration per second.
Bytes Per Second The amount of bytes being handled by the Micro-Integration per second.
Total Messages The total amount of messages handled since the Micro-Integration was deployed.
Total Errors The total amount of errors that have occurred since the Micro-Integration was deployed.
Last Updated The time that the metrics were last updated.
Update Interval The frequency in minutes that we collect metric data.

Editing a Micro-Integration

You can change the configuration details to correct your existing Micro-Integration.

You can only edit a Micro-Integration if it is not deployed.

To edit a Micro-Integration, perform the following steps:

  1. On the navigation bar, select Micro-Integrations.

  2. On the Micro-Integrations page, click the name of the Micro-Integration to open the Micro-Integration Details Page.

  3. In the top-right corner, click Edit Micro-Integration. For more information, see Opening a Micro-Integration.

Deploying a Micro-Integration

You can deploy a Micro-Integration to have data and messages flow between your external system and event broker service. After the Micro-Integration has been successfully deployed, you can verify that it functions by observing that messages flow between your external system and the PubSub+ event broker service.

To deploy a Micro-Integration, perform the following steps:

  1. On the navigation bar, select Micro-Integrations

  2. On the Micro-Integrations page, click the name of the Micro-Integration to open the Micro-Integration Details Page.

  3. In the top-right corner, click the ellipsis () and select Deploy.

Deploying takes a few minutes. After the Micro-Integration successfully deploys, its state shows as Deployed. If there are issues deploying, you may need to modify and troubleshoot your Micro-Integration. For more information, see Troubleshooting Micro-Integrations.

Undeploying a Micro-Integration

You may want to take your Micro-Integration out of service to edit it or disconnect it so that messages and data no longer flow between the external system and the event broker service.

To undeploy a Micro-Integration, perform the following steps:

  1. On the navigation bar, select Micro-Integrations.

  2. On the Micro-Integrations page, click the name of the Micro-Integration to open the Micro-Integration Details Page.

  3. In the top-right corner, click the ellipsis () and select Undeploy.

Deleting a Micro-Integration

You can delete a Micro-Integration that you no longer require.

  • Deleting a Micro-Integration does not delete the event broker service.

  • If an event broker service gets deleted in  Cluster Manager, the Micro-Integration gets deleted as well.

To delete a Micro-Integration, perform the following steps:

  1. On the navigation bar, select Micro-Integrations.

  2. On the Micro-Integrations page, click the name of the Micro-Integration to open the Micro-Integration Details Page.

  3. In the top-right corner, click the ellipsis () and select Delete.