Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

[usm] service discovery, fetch only target environment variables from /proc #29574

Open
wants to merge 18 commits into
base: main
Choose a base branch
from

Conversation

yuri-lipnesh
Copy link
Contributor

@yuri-lipnesh yuri-lipnesh commented Sep 25, 2024

What does this PR do?

Creates a new function to read /proc/pid/environ in chunks and save only the target environment variables.

Motivation

A process may have a very long list of environment variables, and some of them may contain sensitive data.
Extracting the entire list of all environment variables into memory may be expensive and unsafe.
Reading the environment file chunks consumes less runtime memory.
Extracting only the variables of interest prevents sensitive data from being loaded into memory and potentially leaked.

Describe how to test/QA your changes

New unit tests compare results of new function to fetch environment variables to results of previously implemented function.

Possible Drawbacks / Trade-offs

Additional Notes

Benchmark comparison with previously implemented env. search function which read entire file into memory.

runtime improved by 20%
bytes allocation improved 2.2 times
number of allocations increased 2 times

BenchmarkGetEnvs-4                     	   73881	     16596 ns/op	   21416 B/op	      46 allocs/op
BenchmarkGetEnvsTarget-4               	   85982	     13679 ns/op	    9799 B/op	      91 allocs/op

@yuri-lipnesh yuri-lipnesh requested review from a team as code owners September 25, 2024 19:32
@yuri-lipnesh yuri-lipnesh added team/usm The USM team qa/done Skip QA week as QA was done before merge and regressions are covered by tests changelog/no-changelog labels Sep 25, 2024
@pr-commenter
Copy link

pr-commenter bot commented Sep 25, 2024

Regression Detector

Regression Detector Results

Run ID: 08edd294-d1eb-4fc3-8110-41a2c936e7a9 Metrics dashboard Target profiles

Baseline: 10d974e
Comparison: 45cc90a

Performance changes are noted in the perf column of each table:

  • ✅ = significantly better comparison variant performance
  • ❌ = significantly worse comparison variant performance
  • ➖ = no significant change in performance

No significant changes in experiment optimization goals

Confidence level: 90.00%
Effect size tolerance: |Δ mean %| ≥ 5.00%

There were no significant changes in experiment optimization goals at this confidence level and effect size tolerance.

Fine details of change detection per experiment

perf experiment goal Δ mean % Δ mean % CI trials links
uds_dogstatsd_to_api_cpu % cpu utilization +3.15 [+2.41, +3.90] 1 Logs
tcp_syslog_to_blackhole ingress throughput +2.16 [+2.06, +2.26] 1 Logs
file_tree memory utilization +1.81 [+1.71, +1.92] 1 Logs
otel_to_otel_logs ingress throughput +1.30 [+0.48, +2.11] 1 Logs
idle memory utilization +0.57 [+0.51, +0.62] 1 Logs
pycheck_lots_of_tags % cpu utilization +0.20 [-2.29, +2.69] 1 Logs
tcp_dd_logs_filter_exclude ingress throughput +0.00 [-0.01, +0.01] 1 Logs
uds_dogstatsd_to_api ingress throughput -0.01 [-0.10, +0.08] 1 Logs
basic_py_check % cpu utilization -2.29 [-4.97, +0.39] 1 Logs

Bounds Checks

perf experiment bounds_check_name replicates_passed
idle memory_usage 10/10

Explanation

A regression test is an A/B test of target performance in a repeatable rig, where "performance" is measured as "comparison variant minus baseline variant" for an optimization goal (e.g., ingress throughput). Due to intrinsic variability in measuring that goal, we can only estimate its mean value for each experiment; we report uncertainty in that value as a 90.00% confidence interval denoted "Δ mean % CI".

For each experiment, we decide whether a change in performance is a "regression" -- a change worth investigating further -- if all of the following criteria are true:

  1. Its estimated |Δ mean %| ≥ 5.00%, indicating the change is big enough to merit a closer look.

  2. Its 90.00% confidence interval "Δ mean % CI" does not contain zero, indicating that if our statistical model is accurate, there is at least a 90.00% chance there is a difference in performance between baseline and comparison variants.

  3. Its configuration does not mark it "erratic".

@pr-commenter
Copy link

pr-commenter bot commented Sep 27, 2024

Test changes on VM

Use this command from test-infra-definitions to manually test this PR changes on a VM:

inv create-vm --pipeline-id=46302915 --os-family=ubuntu

Note: This applies to commit 45cc90a

@yuri-lipnesh yuri-lipnesh requested a review from a team as a code owner October 3, 2024 16:35
Copy link

cit-pr-commenter bot commented Oct 3, 2024

Go Package Import Differences

Baseline: c5bcbc1
Comparison: 45cc90a

binaryosarchchange
agentlinuxamd64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
agentlinuxarm64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
agentwindowsamd64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
agentdarwinamd64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
agentdarwinarm64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
iot-agentlinuxamd64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
iot-agentlinuxarm64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
heroku-agentlinuxamd64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
cluster-agentlinuxamd64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
cluster-agentlinuxarm64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
system-probelinuxamd64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs
system-probelinuxarm64
+1, -0
+github.com/DataDog/datadog-agent/pkg/collector/corechecks/servicediscovery/envs

Comment on lines 66 to 71
if _, ok := targets[name]; !ok {
return "", false
}

val, ok := ev.vars[name]
return val, ok
Copy link
Contributor

Choose a reason for hiding this comment

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

imho, vars should reflect only the allowed environment variables
no need to store (and waste memory) unneeded envs + currently you always pay for 2 map accesses per "supported" environment variable instead of only one map access

Copy link
Contributor

Choose a reason for hiding this comment

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

If vars is guaranteed to have only supported environment variables, then no need to check targets first

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is where unnecessary environment variables are filtered out and ultimately only the requested variables are included in the list.

}, nil
}

// finish closes an open file.
Copy link
Contributor

Choose a reason for hiding this comment

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

neat: rename to Close

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done

@guyarb guyarb removed the request for review from a team October 10, 2024 11:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
changelog/no-changelog component/system-probe qa/done Skip QA week as QA was done before merge and regressions are covered by tests team/apm-onboarding team/usm The USM team
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants