Include exception message in ErrorAnalysisCard subtitle (#4982)

Summary:

Currently, the subtitle only shows a generic message like "AnalysisNotApplicableStateError encountered while computing ParallelCoordinatesPlot." Show the actual exception message, such as "AnalysisNotApplicableStateError: Experiment has no trials", providing immediate context.

The exception message can now be displayed in the ErrorAnalysisCard subtitle, allowing users to immediately see the reasoning (e.g., why an analysis is not applicable).

Differential Revision: D94617700

Author: shrutipatel31

ax/analysis/analysis.py

@@ -206,10 +206,18 @@ def error_card_from_analysis_e(
     analysis_name = analysis_e.analysis.__class__.__name__
     exception_name = analysis_e.exception.__class__.__name__
 
+    # Include the exception message in the subtitle if available, so users can
+    # see the reasoning in the error card.
+    exception_message = str(analysis_e.exception)
+    if exception_message:
+        subtitle = f"{exception_name}: {exception_message}"
+    else:
+        subtitle = f"{exception_name} encountered while computing {analysis_name}."
+
     return ErrorAnalysisCard(
         name=analysis_name,
         title=f"{analysis_name} Error",
-        subtitle=f"{exception_name} encountered while computing {analysis_name}.",
+        subtitle=subtitle,
         df=pd.DataFrame(),
         blob=analysis_e.tb_str() or "",
     )

ax/api/tests/test_client.py

@@ -23,7 +23,6 @@
 from ax.api.protocols.metric import IMetric
 from ax.api.protocols.runner import IRunner
 from ax.api.types import TParameterization
-from ax.core.analysis_card import AnalysisCard
 from ax.core.data import Data
 from ax.core.experiment import Experiment
 from ax.core.map_metric import MapMetric
@@ -1278,14 +1277,13 @@ def test_compute_analyses(self) -> None:
         self.assertEqual(len(cards), 1)
         self.assertEqual(cards[0].name, "ParallelCoordinatesPlot")
         self.assertEqual(cards[0].title, "ParallelCoordinatesPlot Error")
-        self.assertEqual(
+        self.assertIn(
+            "AnalysisNotApplicableStateError",
             cards[0].subtitle,
-            "AnalysisNotApplicableStateError encountered while computing "
-            "ParallelCoordinatesPlot.",
         )
         self.assertIn(
             "Experiment has no trials",
-            assert_is_instance(cards[0], AnalysisCard).blob,
+            cards[0].subtitle,
         )
 
         for trial_index, _ in client.get_next_trials(max_trials=1).items():