@confluentinc/mcp-confluent 1.1.0 → 1.2.1

package/dist/confluent/tools/handlers/flink/diagnostics/detect-issues-handler.js

@@ -0,0 +1,248 @@
+import { getEnsuredParam } from "../../../../../confluent/helpers.js";
+import { BaseToolHandler, } from "../../../../../confluent/tools/base-tools.js";
+import { getStatementMetrics, analyzeMetrics, } from "../../../../../confluent/tools/handlers/flink/diagnostics/metrics-helper.js";
+import { ToolName } from "../../../../../confluent/tools/tool-name.js";
+import env from "../../../../../env.js";
+import { wrapAsPathBasedClient } from "openapi-fetch";
+import { z } from "zod";
+const detectIssuesArguments = z.object({
+    baseUrl: z
+        .string()
+        .describe("The base URL of the Flink REST API.")
+        .url()
+        .default(() => env.FLINK_REST_ENDPOINT ?? "")
+        .optional(),
+    organizationId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the organization."),
+    environmentId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The unique identifier for the environment."),
+    computePoolId: z
+        .string()
+        .trim()
+        .optional()
+        .describe("The compute pool ID. Required for metrics analysis."),
+    statementName: z
+        .string()
+        .regex(new RegExp("[a-z0-9]([-a-z0-9]*[a-z0-9])?(\\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*"))
+        .nonempty()
+        .max(100)
+        .describe("The name of the Flink SQL statement to detect issues for."),
+    includeMetrics: z
+        .boolean()
+        .default(true)
+        .describe("Include performance metrics analysis (backpressure, lag, etc.). Requires CONFLUENT_CLOUD_API_KEY."),
+});
+export class DetectIssuesHandler extends BaseToolHandler {
+    async handle(clientManager, toolArguments) {
+        const { statementName, environmentId, organizationId, computePoolId, baseUrl, includeMetrics, } = detectIssuesArguments.parse(toolArguments);
+        const organization_id = getEnsuredParam("FLINK_ORG_ID", "Organization ID is required", organizationId);
+        const environment_id = getEnsuredParam("FLINK_ENV_ID", "Environment ID is required", environmentId);
+        const compute_pool_id = computePoolId || env.FLINK_COMPUTE_POOL_ID;
+        if (baseUrl !== undefined && baseUrl !== "") {
+            clientManager.setConfluentCloudFlinkEndpoint(baseUrl);
+        }
+        const pathBasedClient = wrapAsPathBasedClient(clientManager.getConfluentCloudFlinkRestClient());
+        // Get statement status
+        const { data: statementData, error: statusError } = await pathBasedClient["/sql/v1/organizations/{organization_id}/environments/{environment_id}/statements/{statement_name}"].GET({
+            params: {
+                path: {
+                    organization_id: organization_id,
+                    environment_id: environment_id,
+                    statement_name: statementName,
+                },
+            },
+        });
+        if (statusError) {
+            return this.createResponse(`Failed to get statement status: ${JSON.stringify(statusError)}`, true);
+        }
+        // Get exceptions
+        const { data: exceptionsData } = await pathBasedClient["/sql/v1/organizations/{organization_id}/environments/{environment_id}/statements/{statement_name}/exceptions"].GET({
+            params: {
+                path: {
+                    organization_id: organization_id,
+                    environment_id: environment_id,
+                    statement_name: statementName,
+                },
+            },
+        });
+        const phase = statementData?.status?.phase || "UNKNOWN";
+        const detail = statementData?.status?.detail || "";
+        const exceptions = exceptionsData?.data || [];
+        const issues = [];
+        // Detect issues based on state
+        if (phase === "FAILED") {
+            issues.push({
+                type: "statement_failed",
+                severity: "critical",
+                description: `Statement has failed: ${detail}`,
+                suggestion: "Check the exceptions for root cause. Consider fixing the SQL or configuration and resubmitting.",
+            });
+        }
+        if (phase === "FAILING") {
+            issues.push({
+                type: "statement_failing",
+                severity: "high",
+                description: `Statement is in a failing state and may stop soon.${detail ? ` Detail: ${detail}` : ""}`,
+                suggestion: "Investigate exceptions immediately. The statement may recover or fail completely.",
+            });
+        }
+        if (phase === "DEGRADED") {
+            issues.push({
+                type: "statement_degraded",
+                severity: "high",
+                description: `Statement is in a degraded state: ${detail || "Performance may be impacted."}`,
+                suggestion: "This typically indicates an internal system issue. Contact Confluent support if the issue persists.",
+            });
+        }
+        if (phase === "STOPPED") {
+            issues.push({
+                type: "statement_stopped",
+                severity: "medium",
+                description: "Statement has been stopped.",
+                suggestion: "Resume the statement if processing should continue.",
+            });
+        }
+        // Check for error details even when phase is RUNNING or other states
+        if (detail &&
+            phase !== "FAILED" &&
+            phase !== "DEGRADED" &&
+            phase !== "FAILING") {
+            // Only report if detail contains error-like keywords
+            const errorKeywords = [
+                "error",
+                "fail",
+                "issue",
+                "problem",
+                "attention",
+                "contact support",
+            ];
+            const hasErrorKeyword = errorKeywords.some((keyword) => detail.toLowerCase().includes(keyword));
+            if (hasErrorKeyword) {
+                issues.push({
+                    type: "status_warning",
+                    severity: "medium",
+                    description: `Status detail: ${detail}`,
+                    suggestion: "Review the status message for potential issues.",
+                });
+            }
+        }
+        // Analyze exceptions for patterns
+        for (const exception of exceptions) {
+            const message = exception.message || "";
+            const name = exception.name || "";
+            // Common error patterns
+            if (message.includes("OutOfMemory") ||
+                name.includes("OutOfMemoryError")) {
+                issues.push({
+                    type: "memory_issue",
+                    severity: "high",
+                    description: "Out of memory error detected.",
+                    suggestion: "Consider increasing compute pool resources or optimizing the query to reduce state size.",
+                });
+            }
+            if (message.includes("timeout") || message.includes("Timeout")) {
+                issues.push({
+                    type: "timeout",
+                    severity: "medium",
+                    description: `Timeout detected: ${message}`,
+                    suggestion: "Check network connectivity and source/sink availability. Consider increasing timeout configurations.",
+                });
+            }
+            if (message.includes("serialization") ||
+                message.includes("Serialization")) {
+                issues.push({
+                    type: "serialization_error",
+                    severity: "high",
+                    description: `Serialization error: ${message}`,
+                    suggestion: "Check schema compatibility between source and sink. Ensure data types match expected formats.",
+                });
+            }
+            if (message.includes("permission") ||
+                message.includes("Permission") ||
+                message.includes("Access denied")) {
+                issues.push({
+                    type: "permission_error",
+                    severity: "high",
+                    description: `Permission error: ${message}`,
+                    suggestion: "Verify API keys and permissions for accessing Kafka topics and other resources.",
+                });
+            }
+            if (message.includes("not found") || message.includes("does not exist")) {
+                issues.push({
+                    type: "resource_not_found",
+                    severity: "high",
+                    description: `Resource not found: ${message}`,
+                    suggestion: "Verify that all referenced tables, topics, and databases exist.",
+                });
+            }
+        }
+        // Check for exception frequency (multiple exceptions indicate ongoing issues)
+        if (exceptions.length >= 5) {
+            issues.push({
+                type: "frequent_exceptions",
+                severity: "medium",
+                description: `High exception frequency: ${exceptions.length} exceptions in recent history.`,
+                suggestion: "The statement is experiencing repeated failures. Investigate the root cause before exceptions accumulate.",
+            });
+        }
+        // Query and analyze metrics if enabled and compute pool is available
+        let metricsSummary = "";
+        if (includeMetrics && compute_pool_id) {
+            const metricsResult = await getStatementMetrics(clientManager, {
+                statementName,
+                computePoolId: compute_pool_id,
+                intervalMinutes: 5,
+            });
+            if (metricsResult.success && metricsResult.metrics) {
+                const analysis = analyzeMetrics(metricsResult.metrics);
+                metricsSummary = analysis.summary;
+                // Add metrics-based issues
+                for (const metricsIssue of analysis.issues) {
+                    issues.push(metricsIssue);
+                }
+            }
+            else if (metricsResult.error) {
+                // Include metrics error in response but don't fail the whole request
+                metricsSummary = `Metrics unavailable: ${metricsResult.error}`;
+            }
+        }
+        if (issues.length === 0 && phase === "RUNNING") {
+            const msg = metricsSummary
+                ? `No issues detected for statement '${statementName}'. Statement is running normally.\nMetrics: ${metricsSummary}`
+                : `No issues detected for statement '${statementName}'. Statement is running normally.`;
+            return this.createResponse(msg);
+        }
+        if (issues.length === 0) {
+            return this.createResponse(`No issues detected for statement '${statementName}'. Current phase: ${phase}`);
+        }
+        const response = {
+            statementName,
+            phase,
+            ...(detail && { statusDetail: detail }),
+            issueCount: issues.length,
+            issues,
+            ...(metricsSummary && { metricsSummary }),
+        };
+        return this.createResponse(`Detected ${issues.length} issue(s) for statement '${statementName}':\n${JSON.stringify(response, null, 2)}`);
+    }
+    getToolConfig() {
+        return {
+            name: ToolName.DETECT_FLINK_STATEMENT_ISSUES,
+            description: "Detect issues for a Flink SQL statement by analyzing status, exceptions, and performance metrics. Identifies problems like failures, backpressure, consumer lag, late data, memory issues, and provides suggested fixes.",
+            inputSchema: detectIssuesArguments.shape,
+        };
+    }
+    getRequiredEnvVars() {
+        return ["FLINK_API_KEY", "FLINK_API_SECRET"];
+    }
+    isConfluentCloudOnly() {
+        return true;
+    }
+}
+//# sourceMappingURL=detect-issues-handler.js.map

package/dist/confluent/tools/handlers/flink/diagnostics/detect-issues-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-issues-handler.js","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/diagnostics/detect-issues-handler.ts"],"names":[],"mappings":"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"}

package/dist/confluent/tools/handlers/flink/diagnostics/metrics-helper.d.ts

@@ -0,0 +1,88 @@
+import { ClientManager } from "../../../../../confluent/client-manager.js";
+/**
+ * Flink statement metrics from the Confluent Cloud Telemetry API.
+ * Based on: https://api.telemetry.confluent.cloud/docs/descriptors/datasets/cloud
+ */
+export interface TaskMetrics {
+    taskId: string;
+    numRecordsIn?: number;
+    numRecordsOut?: number;
+    numBytesIn?: number;
+    numBytesOut?: number;
+    backpressureTimeMsPerSecond?: number;
+    busyTimeMsPerSecond?: number;
+    idleTimeMsPerSecond?: number;
+    stateSizeBytes?: number;
+}
+export interface SplitMetrics {
+    splitName: string;
+    currentWatermarkMs?: number;
+    watermarkActiveTimeMsPerSecond?: number;
+    watermarkPausedTimeMsPerSecond?: number;
+    watermarkIdleTimeMsPerSecond?: number;
+}
+export interface FlinkStatementMetrics {
+    numRecordsIn?: number;
+    numRecordsOut?: number;
+    numRecordsInFromTopics?: number;
+    numRecordsInFromFiles?: number;
+    numBytesIn?: number;
+    numBytesOut?: number;
+    pendingRecords?: number;
+    backpressureTimeMsPerSecond?: number;
+    busyTimeMsPerSecond?: number;
+    idleTimeMsPerSecond?: number;
+    currentInputWatermarkMs?: number;
+    currentOutputWatermarkMs?: number;
+    watermarkLagMs?: number;
+    numLateRecordsIn?: number;
+    maxInputLatenessMs?: number;
+    currentCfus?: number;
+    cfuMinutesConsumed?: number;
+    stateSizeBytes?: number;
+    currentParallelism?: number;
+    maxParallelism?: number;
+    status?: string;
+    byTask?: TaskMetrics[];
+    bySplit?: SplitMetrics[];
+}
+export interface MetricDataPoint {
+    value: number;
+    timestamp: string;
+}
+export interface MetricQueryResult {
+    metric: string;
+    data: MetricDataPoint[];
+}
+/**
+ * Query Flink statement metrics from the Confluent Cloud Telemetry API.
+ *
+ * @param clientManager - The client manager with telemetry client
+ * @param options - Query options
+ * @returns Aggregated metrics for the statement
+ */
+export declare function getStatementMetrics(clientManager: ClientManager, options: {
+    statementName: string;
+    computePoolId: string;
+    intervalMinutes?: number;
+    includeTaskBreakdown?: boolean;
+    includeSplitBreakdown?: boolean;
+}): Promise<{
+    success: boolean;
+    metrics?: FlinkStatementMetrics;
+    error?: string;
+}>;
+/**
+ * Analyze metrics and return diagnostic insights.
+ */
+export declare function analyzeMetrics(metrics: FlinkStatementMetrics): {
+    issues: Array<{
+        type: string;
+        severity: "low" | "medium" | "high" | "critical";
+        description: string;
+        suggestion: string;
+        value?: number;
+    }>;
+    summary: string;
+};
+//# sourceMappingURL=metrics-helper.d.ts.map

package/dist/confluent/tools/handlers/flink/diagnostics/metrics-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-helper.d.ts","sourceRoot":"","sources":["../../../../../../src/confluent/tools/handlers/flink/diagnostics/metrics-helper.ts"],"names":[],"mappings":"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"}