Troubleshooting and Q&A - Amazon EMR
TroubleshootingQ&A

Troubleshooting and Q&A

Troubleshooting

The error message from the Spark Troubleshooting Agent is available in different ways for different MCP clients. In this page, we list some general guidance for common issues you may see using Apache Spark troubleshooting agent for Amazon EMR.

Topics

Error: MCP Server Failed to Load

  • Verify your MCP configurations are properly configured.

  • Validate JSON syntax:

    • Ensure your JSON is valid with no syntax errors

    • Check for missing commas, quotes, or brackets

  • Verify your local AWS credentials and verify the policy for the MCP IAM role is properly configured.

  • Run /mcp to verify MCP server availability for Kiro-CLI case

Observation: Slow Tool Loading

  • Tools may take a few seconds to be loaded on first attempt of launching the server.

  • If tools don't appear, try restarting the chat.

  • Run /tools command to verify tool availability.

  • Run /mcp if the server is launched without error.

Error: Tool Invocation Failed with Throttling Error

  • If you hit your service limit, please wait for a few seconds to issue a tool invocation if you see the throttling exception.

Error: Tool Responds With User Error

  • AccessDeniedException - check the error message and fix the permission issue.

  • InvalidInputException - check the error message and correct the tool input parameters.

  • ResourceNotFoundException - check the error message and fix the input parameter for resource reference.

Error: Tool Responds With Internal Error

  • If you see The service is handling high-volume requests please retry the tool invocation in a few seconds.

  • If you see INTERNAL SERVICE EXCEPTION please document the analysis id, tool name, any error message available from the mcp log or tool response and optional sanitized conversation history and reach out to the AWS support.

Q&A

1. Should I enable "trust" setting for the tools by default?

Do not turn on "trust" setting by default for all tool calls initially and operate on git-versioned build environment when accepting code recommendations. Review each tool execution to understand what changes are being made.

2. What are the common example prompts to leverage the troubleshooting tools?

Please refer to Prompt Examples for the prompt examples about leveraging troubleshooting tools.