Skip to main content

Troubleshooting

CLOUD

Common issues and solutions for Cloud Platform.

Authentication Issues​

"Unauthorized" Error​

Symptom: API requests return 401 Unauthorized

Solutions:

  1. Check API token is valid
  2. Verify token is included in Authorization header
  3. Check token hasn't been revoked
  4. Regenerate token if needed
# Verify token
curl -X GET \
  -H "Authorization: Bearer $MSH_API_TOKEN" \
  https://api.msh.io/api/msh/projects/

"Forbidden" Error​

Symptom: API requests return 403 Forbidden

Solutions:

  1. Check token has access to the project
  2. Verify project ID is correct
  3. Check user permissions

Metadata Upload Issues​

Upload Fails​

Symptom: Metadata upload returns error

Solutions:

  1. Check context pack format is valid JSON
  2. Verify project ID exists
  3. Check API token permissions
  4. Review error message for details
# Validate context pack
msh ai context --json | jq .

# Try upload again
curl -X POST \
  -H "Authorization: Bearer $MSH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"context_pack\": $(cat context.json), \"source\": \"cli\"}" \
  https://api.msh.io/api/msh/metadata/projects/$MSH_PROJECT_ID/upload

Assets Not Syncing​

Symptom: Assets don't appear in Cloud Platform

Solutions:

  1. Check upload was successful
  2. Verify asset IDs are unique
  3. Check for duplicate assets
  4. Review sync response for errors

Glossary Issues​

Terms Fail to Create​

Symptom: Term creation returns error

Solutions:

  1. Check term ID is unique
  2. Verify required fields are present
  3. Check for duplicate terms
  4. Review error message

Symptom: Term linking returns error

Solutions:

  1. Verify term exists
  2. Check asset exists
  3. Verify column name is correct
  4. Check for duplicate links

AI Feature Issues​

"AI config not set"​

Symptom: AI features return configuration error

Solutions:

  1. Configure AI provider in project settings
  2. Check AI provider is enabled
  3. Verify model is available
  4. Check API quota

Semantic Search Returns No Results​

Symptom: Search returns empty results

Solutions:

  1. Check metadata is uploaded
  2. Try different query wording
  3. Check entity types filter
  4. Verify project ID is correct

Query Console Fails​

Symptom: Query execution fails

Solutions:

  1. Check warehouse connection is configured
  2. Verify SQL is valid
  3. Check query limits
  4. Review error message

Rate Limiting​

"Rate limit exceeded"​

Symptom: API requests return rate limit error

Solutions:

  1. Wait for rate limit reset
  2. Upgrade to higher tier
  3. Reduce request frequency
  4. Implement request queuing

Check Rate Limits:

curl -X GET \
  -H "Authorization: Bearer $MSH_API_TOKEN" \
  -I https://api.msh.io/api/msh/projects/
# Check X-RateLimit-* headers

CI/CD Issues​

Sync Fails in CI/CD​

Symptom: Automated sync fails in pipeline

Solutions:

  1. Check secrets are set correctly
  2. Verify API token has correct permissions
  3. Check project ID is correct
  4. Review CI/CD logs

Webhook Not Triggering​

Symptom: Webhook not called

Solutions:

  1. Check webhook URL is configured
  2. Verify webhook is enabled
  3. Check webhook endpoint is accessible
  4. Review webhook logs

Getting Help​

If you're still experiencing issues:

  1. Check Documentation: Review relevant documentation pages
  2. Review Error Messages: Check error details for clues
  3. Contact Support: Reach out to support@msh.io
  4. Check Status: Visit status.msh.io