While using LangWatch, you may encounter issues or have questions that need further assistance. This page outlines the steps you can take to troubleshoot problems and how to reach out for support when you need it.

Troubleshooting Steps

Before reaching out for support, here are a few steps you can take to resolve common issues:

  1. Check Environment Variables: Ensure that your LANGWATCH_API_KEY is correctly set in your environment. This is a common issue that can prevent LangWatch from functioning properly.

  2. Review Integration Code: Go through your integration code to ensure that you’ve followed the steps outlined in the Getting Started documentation. Sometimes, issues arise from a missed step or incorrect implementation.

  3. Consult the Documentation: Look through the documentation for sections relevant to the issue you’re facing. There might be specific notes or sections that address your problem.

  4. Update LangWatch: Ensure that you are using the latest version of the langwatch library. Outdated versions may contain bugs that have been resolved in newer releases.

    You can update the library using pip:

    pip install --upgrade langwatch

    Or if you are using typescript:

    npm install langwatch@latest
  5. Examine Error Messages: If there are error messages being returned from LangWatch or your LLM provider, inspect them closely as they often provide clues to the root cause.

Opening an Issue

If the troubleshooting steps do not resolve your issue, you can open an issue on our GitHub repository:


When opening an issue, please include the following:

  • A clear and descriptive title.
  • A detailed description of the issue. Include any error messages you’re seeing, and steps to reproduce the problem if possible.
  • The version of the langwatch library you’re using.
  • Any relevant snippets of your code (avoid sharing your API keys or sensitive information).

Our community and maintainers will look into the issue and work with you to find a solution.

Email Support

If you are prefer direct assistance or have inquiries that require privacy, you can reach out to our support team via email at [email protected].

When writing to support, please provide:

  • A summary of the issue or your question.
  • Details about your environment, such as the LLM provider and language you’re using.
  • Any relevant logs or error messages (with sensitive information redacted).

Our support team aims to respond to inquiries as quickly as possible, typically within one business day.

Discord Channel

You can also join our Discord channel and ask questions directly for the community and the core team.

We’re Here to Help

At LangWatch, we’re committed to ensuring that your experience is as smooth and beneficial as possible. Whether it’s a technical hiccup or a general question, our team is here to support your journey in harnessing the full potential of LLMs with our platform.