Troubleshooting Python App and API Protection

이 페이지는 아직 영어로 제공되지 않습니다. 번역 작업 중입니다.
현재 번역 프로젝트에 대한 질문이나 피드백이 있으신 경우 언제든지 연락주시기 바랍니다.

Common Issues

Verify Agent version
- Ensure you’re running Datadog Agent v7.41.1 or higher
- Check Agent status: datadog-agent status
Check Python tracer version
- Confirm you’re using Python tracer v2.21 or a recent version on v3.0.0
- Check version: python -c "import ddtrace; print(ddtrace.__version__)"
Verify environment variables
- Ensure DD_APPSEC_ENABLED=true is set
- Check DD_SERVICE and DD_ENV are properly configured
- Verify DD_APM_ENABLED=true if using APM features

Check ddtrace installation
- Verify ddtrace is installed: pip show ddtrace
- Install with security extras: pip install ddtrace
Import errors
- Ensure all required dependencies are installed
- Check for conflicting packages
Environment variable issues
- Verify environment variables are set correctly
- Check for typos in variable names

Symptoms: Service appears as “unnamed-service” in Datadog

Solution: Set the DD_SERVICE environment variable:

export DD_SERVICE=your-service-name
export DD_ENV=your-environment
ddtrace-run python app.py

Symptoms: Application fails to start or AAP doesn’t work

Solution: Ensure proper file permissions and that the application can write to /tmp:

chmod 755 /path/to/your/app

Symptoms: AAP works but some features are missing

Solution: Check the compatibility guide for supported frameworks and versions.

Enable debug logging to get more information:

export DD_TRACE_DEBUG=true
export DD_APPSEC_ENABLED=true
ddtrace-run python app.py

If you’re still experiencing problems: