​
Troubleshooting Saiku

Experiencing issues with Saiku? This troubleshooting guide addresses common problems, providing practical solutions and tips to help you resolve them quickly.

​
Common Issues and Solutions

​
1. Installation Problems

  • Issue: Difficulty installing Saiku or its dependencies.
  • Solution: Ensure your system meets the prerequisites. Follow the installation guide step-by-step. If issues persist, consider using a virtual environment or container.

​
2. API Connectivity Issues

  • Issue: Trouble connecting to external APIs like OpenAI.
  • Solution: Check your internet connection. Verify that the API keys are correctly set in your environment variables. Ensure you’re not exceeding API rate limits.

​
3. Unexpected Behavior or Errors

  • Issue: Saiku is not behaving as expected or is throwing errors.
  • Solution: Check for any common coding mistakes. Refer to the API documentation for expected behaviors and parameters. Look at the error logs for clues.

​
4. Action Module Issues

  • Issue: Custom actions not working as intended.
  • Solution: Verify the action’s code and parameters. Test the action in isolation. Check if the action is compatible with the current version of Saiku.

​
General Troubleshooting Tips

  • Check Logs: Often, the logs will contain valuable information about what went wrong.
  • Update Saiku: Ensure you’re using the latest version of Saiku, as updates often fix known issues.
  • Community Support: Reach out to the Saiku community. Other users may have faced and solved similar issues.

​
Reporting Issues

Encountered an issue that you can’t resolve? Report it on Saiku’s GitHub issues page:
  1. Provide a detailed description of the issue.
  2. Include any error messages or screenshots.
  3. Describe the steps to reproduce the problem.
  4. Mention the version of Saiku you’re using.
Keep an eye on the Saiku release notes and documentation for updates and solutions to known issues.
Troubleshooting is an integral part of working with any software. We hope this guide helps you resolve any issues you encounter and enhances your Saiku experience.