awslabs.cloudwatch-appsignals-mcp-server 0.1.9__py3-none-any.whl → 0.1.10__py3-none-any.whl

awslabs/cloudwatch_appsignals_mcp_server/__init__.py

@@ -14,4 +14,4 @@
 
 """AWS Application Signals MCP Server."""
 
-__version__ = '0.1.9'
+__version__ = '0.1.10'

awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py

@@ -402,6 +402,26 @@ async def query_sampled_traces(
                 return obj.isoformat()
             return obj
 
+        # Helper function to extract fault message from root causes for deduplication
+        def get_fault_message(trace_data):
+            """Extract fault message from a trace for deduplication.
+
+            Only checks FaultRootCauses (5xx server errors) since this is the primary
+            use case for root cause investigation. Traces without fault messages are
+            not deduplicated.
+            """
+            # Only check FaultRootCauses for deduplication
+            root_causes = trace_data.get('FaultRootCauses', [])
+            if root_causes:
+                for cause in root_causes:
+                    services = cause.get('Services', [])
+                    for service in services:
+                        exceptions = service.get('Exceptions', [])
+                        if exceptions and exceptions[0].get('Message'):
+                            return exceptions[0].get('Message')
+            return None
+
+        # Build trace summaries (original format)
         trace_summaries = []
         for trace in traces:
             # Create a simplified trace data structure to reduce size
@@ -417,17 +437,11 @@ async def query_sampled_traces(
 
             # Only include root causes if they exist (to save space)
             if trace.get('ErrorRootCauses'):
-                trace_data['ErrorRootCauses'] = trace.get('ErrorRootCauses', [])[
-                    :3
-                ]  # Limit to first 3
+                trace_data['ErrorRootCauses'] = trace.get('ErrorRootCauses', [])[:3]
             if trace.get('FaultRootCauses'):
-                trace_data['FaultRootCauses'] = trace.get('FaultRootCauses', [])[
-                    :3
-                ]  # Limit to first 3
+                trace_data['FaultRootCauses'] = trace.get('FaultRootCauses', [])[:3]
             if trace.get('ResponseTimeRootCauses'):
-                trace_data['ResponseTimeRootCauses'] = trace.get('ResponseTimeRootCauses', [])[
-                    :3
-                ]  # Limit to first 3
+                trace_data['ResponseTimeRootCauses'] = trace.get('ResponseTimeRootCauses', [])[:3]
 
             # Include limited annotations for key operations
             annotations = trace.get('Annotations', {})
@@ -447,15 +461,50 @@ async def query_sampled_traces(
             # Convert any datetime objects to ISO format strings
             for key, value in trace_data.items():
                 trace_data[key] = convert_datetime(value)
+
             trace_summaries.append(trace_data)
 
+        # Deduplicate trace summaries by fault message
+        seen_faults = {}
+        deduped_trace_summaries = []
+
+        for trace_summary in trace_summaries:
+            # Check if this trace has an error
+            has_issues = (
+                trace_summary.get('HasError')
+                or trace_summary.get('HasFault')
+                or trace_summary.get('HasThrottle')
+            )
+
+            if not has_issues:
+                # Always include healthy traces
+                deduped_trace_summaries.append(trace_summary)
+                continue
+
+            # Extract fault message for deduplication (only checks FaultRootCauses)
+            fault_msg = get_fault_message(trace_summary)
+
+            if fault_msg and fault_msg in seen_faults:
+                # Skip this trace - we already have one with the same fault message
+                seen_faults[fault_msg]['count'] += 1
+                logger.debug(
+                    f'Skipping duplicate trace {trace_summary.get("Id")} - fault message already seen: {fault_msg[:100]}...'
+                )
+                continue
+            else:
+                # First time seeing this fault (or no fault message) - include it
+                deduped_trace_summaries.append(trace_summary)
+                if fault_msg:
+                    seen_faults[fault_msg] = {'count': 1}
+
         # Check transaction search status
         is_tx_search_enabled, tx_destination, tx_status = check_transaction_search_enabled(region)
 
+        # Build response with original format but deduplicated traces
         result_data = {
-            'TraceSummaries': trace_summaries,
-            'TraceCount': len(trace_summaries),
-            'Message': f'Retrieved {len(trace_summaries)} traces (limited to prevent size issues)',
+            'TraceSummaries': deduped_trace_summaries,
+            'TraceCount': len(deduped_trace_summaries),
+            'Message': f'Retrieved {len(deduped_trace_summaries)} unique traces from {len(trace_summaries)} total (deduplicated by fault message)',
             'SamplingNote': "⚠️ This data is from X-Ray's 5% sampling. Results may not show all errors or issues.",
             'TransactionSearchStatus': {
                 'enabled': is_tx_search_enabled,
@@ -467,9 +516,18 @@ async def query_sampled_traces(
             },
         }
 
+        # Add dedup stats if we actually deduped anything
+        if len(deduped_trace_summaries) < len(trace_summaries):
+            duplicates_removed = len(trace_summaries) - len(deduped_trace_summaries)
+            result_data['DeduplicationStats'] = {
+                'OriginalTraceCount': len(trace_summaries),
+                'DuplicatesRemoved': duplicates_removed,
+                'UniqueFaultMessages': len(seen_faults),
+            }
+
         elapsed_time = timer() - start_time_perf
         logger.info(
-            f'query_sampled_traces completed in {elapsed_time:.3f}s - retrieved {len(trace_summaries)} traces'
+            f'query_sampled_traces completed in {elapsed_time:.3f}s - retrieved {len(deduped_trace_summaries)} unique traces from {len(trace_summaries)} total'
         )
         return json.dumps(result_data, indent=2)
 

{awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info → awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.cloudwatch-appsignals-mcp-server
-Version: 0.1.9
+Version: 0.1.10
 Summary: An AWS Labs Model Context Protocol (MCP) server for AWS Application Signals
 Project-URL: Homepage, https://awslabs.github.io/mcp/
 Project-URL: Documentation, https://awslabs.github.io/mcp/servers/cloudwatch-appsignals-mcp-server/

{awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info → awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info}/RECORD

@@ -1,5 +1,5 @@
 awslabs/__init__.py,sha256=WuqxdDgUZylWNmVoPKiK7qGsTB_G4UmuXIrJ-VBwDew,731
-awslabs/cloudwatch_appsignals_mcp_server/__init__.py,sha256=cPlKPRqNSL5d4RkWGdDJ_7jay1qZs4ppnntzxDdr4nw,681
+awslabs/cloudwatch_appsignals_mcp_server/__init__.py,sha256=zmAQBvB227-Fwnes1CNk2nNM9eZwfTvbfkycgYypGKk,682
 awslabs/cloudwatch_appsignals_mcp_server/audit_presentation_utils.py,sha256=xYJz0I-wdigYKxAaVLjyoMUh2UQpwlZM7sFxfL2pPmw,8923
 awslabs/cloudwatch_appsignals_mcp_server/audit_utils.py,sha256=Mqa8q3MUMpDKRFJQgUoKYikknGO4sBIe2_-0e2BWlCA,30765
 awslabs/cloudwatch_appsignals_mcp_server/aws_clients.py,sha256=I-amnrnVLGv-gAPkEYo-AxvmqktBjpdEuB1pjeTO1Fs,3542
@@ -8,11 +8,11 @@ awslabs/cloudwatch_appsignals_mcp_server/service_audit_utils.py,sha256=i-6emomFi
 awslabs/cloudwatch_appsignals_mcp_server/service_tools.py,sha256=iJnkROnR0FdxEgF0LJb5zYNcD-CCSa9LVXwUqxU1_tI,29093
 awslabs/cloudwatch_appsignals_mcp_server/sli_report_client.py,sha256=LGs7tDLVVa3mbT_maTefwGEA3cl3fNVft9brh3lVTzM,12374
 awslabs/cloudwatch_appsignals_mcp_server/slo_tools.py,sha256=dMLGqeZYHu2adk9uquBGIZkMZStb-puzlI0xtKhxYNI,17824
-awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py,sha256=F-vanuK8preiRHyI-EbZoOcxTueycDk-rRRPtjmKg5E,28990
+awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py,sha256=SMIaxStaJNZOU4GaAFkUiNXrb978bPTlF7MRBRJVEP8,31785
 awslabs/cloudwatch_appsignals_mcp_server/utils.py,sha256=nZBqiCBAUewQft26FVf4IGL4P1b152VAcG9Y7Mh0gZY,5782
-awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info/METADATA,sha256=WQuVsqGbrqcKZp0SA4cPBIGA0fSRRc_UNJ1ueUcjW78,27162
-awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info/entry_points.txt,sha256=iGwIMLU6AsBawl2Fhqi9GoeWdMGIVtg86-McaaNQqAQ,114
-awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info/licenses/LICENSE,sha256=zE1N4JILDTkSIDtdmqdnKKxKEQh_VdqeoAV2230eNOI,10141
-awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info/licenses/NOTICE,sha256=Pfbul2Ga0IJU2RMZFHC8QwDvNk72WO2XMn9l3390VYs,108
-awslabs_cloudwatch_appsignals_mcp_server-0.1.9.dist-info/RECORD,,
+awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info/METADATA,sha256=JxgaSJRwabngeigjaRlEx3uFMOq-ATyMEZxxN4cQtxQ,27163
+awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info/entry_points.txt,sha256=iGwIMLU6AsBawl2Fhqi9GoeWdMGIVtg86-McaaNQqAQ,114
+awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info/licenses/LICENSE,sha256=zE1N4JILDTkSIDtdmqdnKKxKEQh_VdqeoAV2230eNOI,10141
+awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info/licenses/NOTICE,sha256=Pfbul2Ga0IJU2RMZFHC8QwDvNk72WO2XMn9l3390VYs,108
+awslabs_cloudwatch_appsignals_mcp_server-0.1.10.dist-info/RECORD,,