Skip to main content

Troubleshooting

CLI says config is missing​

Run:

tiden setup

Or set config manually:

tiden config set baseUrl https://app.tiden.ai
printf '%s' "$TOKEN" | tiden config set apiToken -
tiden config verify

Check environment variables if CI behaves differently from local:

env | grep TIDEN_

CLI returns auth error​

API token errors return exit code 2.

Fixes:

  • Confirm the token was copied correctly.
  • Confirm it has not been revoked.
  • Confirm TIDEN_BASE_URL points to the right Tiden instance.
  • Run tiden config verify.

API token cannot call an endpoint​

API tokens can call only the public API surface. If the endpoint manages organization members, billing, credentials, token creation, profile security, or other web-only admin state, use the web app.

Review link proposals before merge:

tiden branch link-proposals list --product-id <product-id> --name <branch-name>

Accept or reject proposals:

tiden branch link-proposals review \
  --product-id <product-id> \
  --name <branch-name> \
  --decision accepted \
  --all-proposed

Branch merge has conflicts​

Open the Branches page, inspect each conflict, and choose keep branch or keep main. Use CLI auto-resolve only when the direction is obvious.

Error events do not appear​

Check:

  • The DSN came from the same product you are viewing.
  • The app is sending to the ingest host in the DSN.
  • The SDK has a release and environment if you are filtering by them.
  • The body is under 1 MiB.
  • The DSN key has not been revoked.
  • The Issues page is not still showing a processing banner.

Source maps do not symbolicate frames​

Check:

  • The runtime SDK release matches the source map plugin release.
  • Build output includes source maps.
  • Upload ran in CI and did not skip files.
  • The source map plugin had a valid API token.
  • Uploaded maps appear on the Source maps page.

Laravel events do not appear​

Check:

  • TIDEN_DSN is set in the runtime environment.
  • The installed Laravel bridge version supports your Laravel version.
  • The application is reporting exceptions through Laravel's exception handler.
  • Network egress to the ingest host is allowed.

Agent configuration says it needs an LLM credential​

Create and test a workspace LLM credential. Then edit the agent configuration and select that credential.

Quality gate is blocked​

Open the gate detail and expand blocking components. Common fixes are:

  • Add missing tests.
  • Link tests to requirements.
  • Resolve failing tests.
  • Triage production issues.
  • Assign components consistently.
  • Recompute after fixes land.