Skip to content

chore(asm): improve logs for appsec #12928

New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Merged

Conversation

christophe-papazian
Copy link
Contributor

@christophe-papazian christophe-papazian commented Mar 27, 2025

APPSEC-57090

Improve log semantic for the tracer logger.

Motivation: current default rate limit for the tracer log is based on log position in the file and is the same for all logs. But AppSec would like to be able to get different rate limit for different logs.

  • without any extra arguments, we almost keep the legacy behavior (the skip message is shorter)
  • with extra={"product":"asm"} (replace asm by any product or integration), the main message of the log is considered as a the main log tag, while the extra dictionary can contains further formatting options and additions, allowing more context. The main log tag is used as a key for the rate limiter.
  • a function set_tag_rate_limit allows to change the rate limit duration for any specific tag
  • At debug level, we still disable any rate limiter.
  • We handle the exec_info and stack_info directly to allow customize depth stack size in reported logs

Checklist

  • PR author has checked that all the criteria below are met
  • The PR description includes an overview of the change
  • The PR description articulates the motivation for the change
  • The change includes tests OR the PR description describes a testing strategy
  • The PR description notes risks associated with the change, if any
  • Newly-added code is easy to change
  • The change follows the library release note guidelines
  • The change includes or references documentation updates if necessary
  • Backport labels are set (if applicable)

Reviewer Checklist

  • Reviewer has checked that all the criteria below are met
  • Title is accurate
  • All changes are related to the pull request's stated goal
  • Avoids breaking API changes
  • Testing strategy adequately addresses listed risks
  • Newly-added code is easy to change
  • Release note makes sense to a user of the library
  • If necessary, author has acknowledged and discussed the performance implications of this PR as reported in the benchmarks PR comment
  • Backport labels are set in a manner that is consistent with the release branch maintenance policy

@christophe-papazian christophe-papazian added changelog/no-changelog A changelog entry is not required for this PR. ASM Application Security Monitoring labels Mar 27, 2025
Copy link
Contributor

github-actions bot commented Mar 27, 2025

CODEOWNERS have been resolved as:

ddtrace/appsec/_asm_request_context.py                                  @DataDog/asm-python
ddtrace/appsec/_metrics.py                                              @DataDog/asm-python
ddtrace/internal/logger.py                                              @DataDog/apm-core-python
tests/appsec/appsec/test_asm_request_context.py                         @DataDog/asm-python
tests/tracer/test_logger.py                                             @DataDog/apm-sdk-api-python

Copy link
Contributor

github-actions bot commented Mar 27, 2025

Bootstrap import analysis

Comparison of import times between this PR and base.

Summary

The average import time from this PR is: 243 ± 5 ms.

The average import time from base is: 244 ± 4 ms.

The import time difference between this PR and base is: -0.8 ± 0.2 ms.

Import time breakdown

The following import paths have grown:

ddtrace.auto 0.052 ms (0.02%)
ddtrace.bootstrap.sitecustomize 0.052 ms (0.02%)
ddtrace.appsec._common_module_patches 0.052 ms (0.02%)
ddtrace.appsec._asm_request_context 0.052 ms (0.02%)

The following import paths have shrunk:

ddtrace.auto 1.970 ms (0.81%)
ddtrace.bootstrap.sitecustomize 1.282 ms (0.53%)
ddtrace.bootstrap.preload 1.282 ms (0.53%)
ddtrace.internal.products 1.282 ms (0.53%)
ddtrace.internal.remoteconfig.client 0.609 ms (0.25%)
ddtrace 0.688 ms (0.28%)
ddtrace._logger 0.045 ms (0.02%)
ddtrace.internal.telemetry 0.045 ms (0.02%)
ddtrace.internal.logger 0.045 ms (0.02%)

@pr-commenter
Copy link

pr-commenter bot commented Mar 27, 2025

Benchmarks

Benchmark execution time: 2025-04-03 08:29:08

Comparing candidate commit 6278805 in PR branch christophe-papazian/improving_appsec_log_mechanism with baseline commit 15a926d in branch main.

Found 0 performance improvements and 0 performance regressions! Performance is the same for 498 metrics, 2 unstable metrics.

Copy link
Contributor

CODEOWNERS have been resolved as:

ddtrace/appsec/_asm_request_context.py                                  @DataDog/asm-python
ddtrace/appsec/_metrics.py                                              @DataDog/asm-python
ddtrace/internal/logger.py                                              @DataDog/apm-core-python
ddtrace/settings/_config.py                                             @DataDog/apm-core-python
tests/appsec/appsec/test_asm_request_context.py                         @DataDog/asm-python

@christophe-papazian christophe-papazian marked this pull request as ready for review April 1, 2025 12:40
@christophe-papazian christophe-papazian requested review from a team as code owners April 1, 2025 12:40
Copy link
Member

@avara1986 avara1986 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! nice job!

Copy link
Contributor

github-actions bot commented Apr 3, 2025

CODEOWNERS have been resolved as:

ddtrace/appsec/_asm_request_context.py                                  @DataDog/asm-python
ddtrace/appsec/_metrics.py                                              @DataDog/asm-python
ddtrace/internal/logger.py                                              @DataDog/apm-core-python
tests/appsec/appsec/test_asm_request_context.py                         @DataDog/asm-python
tests/tracer/test_logger.py                                             @DataDog/apm-sdk-api-python

@christophe-papazian christophe-papazian enabled auto-merge (squash) April 3, 2025 08:24
@christophe-papazian christophe-papazian merged commit fe197c9 into main Apr 3, 2025
735 of 737 checks passed
@christophe-papazian christophe-papazian deleted the christophe-papazian/improving_appsec_log_mechanism branch April 3, 2025 08:30
chojomok pushed a commit that referenced this pull request Apr 7, 2025
APPSEC-57090

Improve log semantic for the tracer logger.

Motivation: current default rate limit for the tracer log is based on
log position in the file and is the same for all logs. But AppSec would
like to be able to get different rate limit for different logs.

- without any extra arguments, we almost keep the legacy behavior (the
skip message is shorter)
- with `extra={"product":"asm"}` (replace asm by any product or
integration), the main message of the log is considered as a the main
log tag, while the extra dictionary can contains further formatting
options and additions, allowing more context. The main log tag is used
as a key for the rate limiter.
- a function `set_tag_rate_limit` allows to change the rate limit
duration for any specific tag
- At debug level, we still disable any rate limiter.
- We handle the exec_info and stack_info directly to allow customize
depth stack size in reported logs

## Checklist
- [x] PR author has checked that all the criteria below are met
- The PR description includes an overview of the change
- The PR description articulates the motivation for the change
- The change includes tests OR the PR description describes a testing
strategy
- The PR description notes risks associated with the change, if any
- Newly-added code is easy to change
- The change follows the [library release note
guidelines](https://ddtrace.readthedocs.io/en/stable/releasenotes.html)
- The change includes or references documentation updates if necessary
- Backport labels are set (if
[applicable](https://ddtrace.readthedocs.io/en/latest/contributing.html#backporting))

## Reviewer Checklist
- [x] Reviewer has checked that all the criteria below are met 
- Title is accurate
- All changes are related to the pull request's stated goal
- Avoids breaking
[API](https://ddtrace.readthedocs.io/en/stable/versioning.html#interfaces)
changes
- Testing strategy adequately addresses listed risks
- Newly-added code is easy to change
- Release note makes sense to a user of the library
- If necessary, author has acknowledged and discussed the performance
implications of this PR as reported in the benchmarks PR comment
- Backport labels are set in a manner that is consistent with the
[release branch maintenance
policy](https://ddtrace.readthedocs.io/en/latest/contributing.html#backporting)
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
ASM Application Security Monitoring changelog/no-changelog A changelog entry is not required for this PR.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants