There are a few things that you can do to monitor and troubleshoot your flows in App Connect:
- Validate your flow
- Use the dashboard
- Use the logs (IBM Cloud instances only)
- Use the following resources: the App Connect status page, forums, and documentation
Validate your flow
Ensure there are no validation errors in your flow. If validation errors are detected, a warning icon is displayed on any nodes that require your attention. For more information about validating your flow, see Validating your flow is ready to run.
Use the dashboard
Look at the tile for a running flow on the App Connect dashboard.
- If there’s a green tick, the flow has run successfully; click the tick to see when the flow was last triggered.
- If there’s a red exclamation point, there’s a problem; click the exclamation point to find out what’s gone wrong.
Tip: You can also view errors by clicking View errors in the tile’s options menu [⋮].
Review the error messages shown in the “Error messages” panel. If you see an arrow to the left of an entry in this panel, you can expand that entry to view additional details. To see other related messages for this flow, click the Actions menu (…) for an entry and then click View logs to open the log viewer.
Use the logs (IBM Cloud instances only)
You can view App Connect logs for your event-driven and API flows. Logs are forwarded to a built-in log viewer and can also be sent to an IBM Log Analysis with LogDNA service instance that’s configured to receive logs from enabled services in IBM Cloud.
- To view logs for all your running flows in the log viewer, open the App Connect menu and then click Manage > Logs. Error and information messages for your flows are shown by default. If you’ve enhanced the log details with custom messages and fields, as described in Enhancing logging with customized log messages, you’ll also see these messages and fields in the log viewer. For more information about using the log viewer, see Viewing App Connect logs in the log viewer.
Note: In addition to logs for your flows, you’ll also see logs for your App Connect Enterprise integration servers that are running in the App Connect on IBM Cloud instance, within the log viewer. For more information, see Viewing logs for your integration servers in App Connect on IBM Cloud.
- To view debugging information for a flow, open the menu on a flow tile in the App Connect dashboard and click Enable debug logging. Then restart your flow to start debug logging for that flow, and open the log viewer to view the log entries. For more information, see Debugging your flows in IBM App Connect on IBM Cloud.
- To view logs for your flows (and integration servers) within an IBM Log Analysis with LogDNA instance, you’ll need to configure, and then access the instance in IBM Cloud. IBM Log Analysis with LogDNA enables you to extend the logging capability of your App Connect instance. For more information, see Monitoring and managing App Connect logs in IBM Log Analysis with LogDNA.
Use the following resources: the App Connect status page, forums, and documentation
- Check the following page to see if there are any current known issues with App Connect, and if there are any planned maintenance windows during which App Connect will be unavailable: IBM App Connect status.
- Check the forum to see if an answer is already provided there.
- Ask a question about your problem in the forum, providing as much detail as possible to help answer your question. Include the tags “bluemix” and “app_connect” (with an underscore). The forum is monitored by the IBM App Connect team and by other App Connect users.
- (IBM Cloud instances only) If you have technical questions about developing or deploying an application with IBM App Connect, post your question on Stack Overflow and tag your question with “ibm-bluemix” and “app-connect” (with a hyphen).
- Follow step-by-step instructions about how to connect your applications, APIs, and web services in the How to guides and Tutorials for IBM App Connect.
Help! The connection to an application is broken
- When you configure App Connect to connect to an application like Gmail, a notification that you have authorized App Connect to use your account details is recorded in your account profile for that application. For example, if you provide App Connect with your Google credentials, so that App Connect can connect to your Gmail account, you can see this authorization specified in your Google account (under Sign in & security > Connected apps and sites). If you remove the authorization from your Google account, App Connect can no longer connect to your Gmail account and any flows that use Gmail as a target application will become inactive.
To reconnect App Connect to an application where the authorization has been removed, go to the Applications tab on the Catalog page in App Connect. There, you can choose either to update the account, or to remove the account, and then add the account again (or add a new account).