v1.3.0

We are excited to announce the relesae of nginx-datadog v1.3.0. This version brings several improvements, important fixes, and introduces remote configuration support for Application Security (AppSec). Please review the breaking changes and updates below to ensure a smooth upgrade.

Known Issues

• Unexpected logs: Logs may be generated when there is no tracing context available. The frequency of these logs depends on how often the server initiates traces. Please upgrade to v1.3.1.

⚠️ Breaking Changes ⚠️

As of PR #101, trace-log correlation is no longer supported out-of-the-box.
Users who rely on this functionality must now manually configure a custom log format to include trace and span IDs in the logs. Here's an example configuration:

Plaintext format:

log_format datadog_text '$remote_addr - $http_x_forwarded_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$http_x_forwarded_for" "$datadog_trace_id" "$datadog_span_id"';

JSON format:

log_format datadog_json escape=json '{"remote_addr": "$remote_addr", "forwarded_user": "$http_x_forwarded_user", "time_local": "$time_local", "request": "$request", "status": $status, "body_bytes_sent": $body_bytes_sent, "referer": "$http_referer", "user_agent": "$http_user_agent", "forwarded_for": "$http_x_forwarded_for", "dd.trace_id": "$datadog_trace_id", "dd.span_id": "$datadog_span_id"}';

Ensure that the custom log format is defined in your NGINX configuration file. For more details, you can view an example in our repository

New Features

• feature: Add trace and span IDs 128-bit hexadecimal representation by @dmehala in #103. Please use$datadog_trace_id_hex and $datadog_parent_id_hex variables.
• feature: Added remote configuration support for AppSec by @cataphract in #71

What's Changed

• fix: Resolved an issue with Datadog script execution by @dmehala in #95
• improvements: Improved logging to include module information by @dmehala in #96
• build: bump dd-trace-cpp from v0.2.2 to v1.0.0 by @dmehala in #111

New Contributors

• @HadrienPatte made their first contribution in #99
• @Anilm3 made their first contribution in #105
• @smola made their first contribution in #108

Full Changelog: v1.2.1...v1.3.0