airbyte-internal-ops 0.2.3__tar.gz → 0.3.0__tar.gz

{airbyte_internal_ops-0.2.3 → airbyte_internal_ops-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: airbyte-internal-ops
-Version: 0.2.3
+Version: 0.3.0
 Summary: MCP and API interfaces that let the agents do the admin work
 Author-email: Aaron Steers <aj@airbyte.io>
 Keywords: admin,airbyte,api,mcp

{airbyte_internal_ops-0.2.3 → airbyte_internal_ops-0.3.0}/src/airbyte_ops_mcp/cli/cloud.py

@@ -17,6 +17,7 @@ import shutil
 import signal
 import socket
 import subprocess
+import sys
 import tempfile
 import time
 from pathlib import Path
@@ -44,6 +45,7 @@ from airbyte_ops_mcp.constants import (
     DEFAULT_CLOUD_SQL_PROXY_PORT,
     ENV_GCP_PROD_DB_ACCESS_CREDENTIALS,
 )
+from airbyte_ops_mcp.gcp_logs import GCPSeverity, fetch_error_logs
 from airbyte_ops_mcp.mcp.cloud_connector_versions import (
     get_cloud_connector_version,
     set_cloud_connector_version_override,
@@ -98,6 +100,10 @@ cloud_app.command(connector_app)
 db_app = App(name="db", help="Database operations for Airbyte Cloud Prod DB Replica.")
 cloud_app.command(db_app)
 
+# Create the logs sub-app under cloud
+logs_app = App(name="logs", help="GCP Cloud Logging operations for Airbyte Cloud.")
+cloud_app.command(logs_app)
+
 
 @db_app.command(name="start-proxy")
 def start_proxy(
@@ -1128,3 +1134,76 @@ def fetch_connection_config_cmd(
     else:
         print_error(result.message)
     print_json(result.model_dump())
+
+
+@logs_app.command(name="lookup-cloud-backend-error")
+def lookup_cloud_backend_error(
+    error_id: Annotated[
+        str,
+        Parameter(
+            help=(
+                "The error ID (UUID) to search for. This is typically returned "
+                "in API error responses as {'errorId': '...'}"
+            )
+        ),
+    ],
+    lookback_days: Annotated[
+        int,
+        Parameter(help="Number of days to look back in logs."),
+    ] = 7,
+    min_severity_filter: Annotated[
+        GCPSeverity | None,
+        Parameter(
+            help="Optional minimum severity level to filter logs.",
+        ),
+    ] = None,
+    raw: Annotated[
+        bool,
+        Parameter(help="Output raw JSON instead of formatted text."),
+    ] = False,
+) -> None:
+    """Look up error details from GCP Cloud Logging by error ID.
+
+    When an Airbyte Cloud API returns an error response with only an error ID
+    (e.g., {"errorId": "3173452e-8f22-4286-a1ec-b0f16c1e078a"}), this command
+    fetches the full stack trace and error details from GCP Cloud Logging.
+
+    Requires GCP credentials with Logs Viewer role on the target project.
+    Set up credentials with: gcloud auth application-default login
+    """
+    print(f"Searching for error ID: {error_id}", file=sys.stderr)
+    print(f"Lookback days: {lookback_days}", file=sys.stderr)
+    if min_severity_filter:
+        print(f"Severity filter: {min_severity_filter}", file=sys.stderr)
+    print(file=sys.stderr)
+
+    result = fetch_error_logs(
+        error_id=error_id,
+        lookback_days=lookback_days,
+        min_severity_filter=min_severity_filter,
+    )
+
+    if raw:
+        print_json(result.model_dump())
+        return
+
+    print(f"Found {result.total_entries_found} log entries", file=sys.stderr)
+    print(file=sys.stderr)
+
+    if result.payloads:
+        for i, payload in enumerate(result.payloads):
+            print(f"=== Log Group {i + 1} ===")
+            print(f"Timestamp: {payload.timestamp}")
+            print(f"Severity: {payload.severity}")
+            if payload.resource.labels.pod_name:
+                print(f"Pod: {payload.resource.labels.pod_name}")
+            print(f"Lines: {payload.num_log_lines}")
+            print()
+            print(payload.message)
+            print()
+    elif result.entries:
+        print("No grouped payloads, showing raw entries:", file=sys.stderr)
+        for entry in result.entries:
+            print(f"[{entry.timestamp}] {entry.severity}: {entry.payload}")
+    else:
+        print_error("No log entries found for this error ID.")