Docs/Support/Troubleshooting

Troubleshooting

Diagnose and resolve the most common issues with GovernanceAI integrations.

Intermediate5 min readUpdated June 2026
GatewayPolicySDK

This page covers the most common issues developers encounter when integrating or operating GovernanceAI. For each problem, we describe the root cause and the fastest path to resolution.

Authentication errors

Unexpected blocks

Always use the trace IDEvery blocked request includes a trace_id in the response. Paste this into the Observability dashboard or run gov observability trace <id> to see exactly which rule triggered and why.

Performance issues

SDK and integration issues

Getting help

If none of the above resolves your issue, open a support ticket with the following information:

  • The trace_id from the failing request
  • The security profile name and the project ID
  • The SDK version: pip show governance-ai
  • The gateway version from GET /health

Related documentation

Operations

Monitor your deployment proactively.

Security Profiles

Tune risk thresholds and DLP patterns.

API Reference

Verify request format and error codes.

Previous

Operations