Configure BA Insight logging and troubleshooting

The BA Insight logging and troubleshooting framework provides visibility into the operational state of your environment acrossConnectivity Hub, AutoClassifier, SmartHub, and Smart Previews. Logging captures detailed event data, job activity, and user actions to help administrators monitor system health, diagnose issues, and ensure reliable performance throughout the BA Insight ecosystem.

This section outlines how to configure, access, and interpret log data, as well as how to use advanced diagnostic tools and auditing features to investigate problems quickly. It also explains how to manage log retention, view detailed activity for connectors, pipelines, and preview services, and gather the information needed for technical support or maintenance reviews.

By following the guidance in this section, you can proactively identify configuration errors, optimize system performance, and maintain a secure and auditable environment for all BA Insight services.

Recommended order of tasks:

  1. Enable and configure logging for each BA Insight sub-product: Set log levels and destinations to capture detailed runtime information.

  2. Monitor operational activity: Review job execution, user actions, and system events for potential issues.

  3. Analyze logs for troubleshooting: Use built-in log viewers and diagnostic utilities to trace component behavior.

  4. Audit user and controller interactions: Validate that all customer-facing controllers and administrative actions are tracked for compliance.

  5. Maintain log health and performance: Implement log rotation, archival, and cleanup procedures to preserve storage efficiency.

  6. Engage support with relevant logs: Gather targeted diagnostic files to assist in root cause analysis and support escalation.