diff --git a/content/en/security/application_security/setup/go/troubleshooting.md b/content/en/security/application_security/setup/go/troubleshooting.md new file mode 100644 index 0000000000000..1f51a0610530b --- /dev/null +++ b/content/en/security/application_security/setup/go/troubleshooting.md @@ -0,0 +1,47 @@ +--- +title: Troubleshooting Go App and API Protection +--- + +## Common Issues + +### No security signals appearing + +1. **Verify Agent version** + - Ensure you're running Datadog Agent v7.41.1 or higher + - Check Agent status: `datadog-agent status` + +2. **Check Go tracer version** + - Confirm you're using Go tracer v1.53.0 or higher + +3. **Verify environment variables** + - Ensure `DD_APPSEC_ENABLED=true` is set + - Check `DD_SERVICE` and `DD_ENV` are properly configured + +4. **Check file system permissions** + - Ensure the application has write access to `/tmp` if you are not on linux + +5. **Check your framework is actually compatible** + - Review the [Go compatibility requirements][1] to ensure your framework and libraries are supported + +### Application fails to start + +TODO: linker & shared libraries issues + +TODO: Incompatible libc version + +### Build failures + +TODO: Building on alpine and running on glibc-based systems and the other way around + +TODO: Bazel build issues + +### Still having issues? + +If you're still experiencing problems: +1. Check the [Application Security Monitoring troubleshooting guide][1] +2. Review the [Go tracer documentation][2] +3. Contact [Datadog support][3] + +[1]: /security/application_security/troubleshooting +[2]: /tracing/trace_collection/compatibility/go +[3]: /help