datadog-agent
datadog-agent copied to clipboard
DataDog
[AMLII-1693] Allow integration logs configuration types
What does this PR do?
Creates a new "integration" type for custom integrations, then creates files for those integrations. This is a WIP and is subject to change.
Motivation
Additional Notes
Possible Drawbacks / Trade-offs
Describe how to test/QA your changes
Regression Detector
Regression Detector Results
Run ID: 76eaa1d4-bf9c-4033-9434-500ac3d03fbe Metrics dashboard Target profiles
Baseline: ab2f289b60120969fa36940e9ce8c08db33402e0 Comparison: 963a6c29eaa867ff723ccab27f11e853235edf97
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 | links |
|---|---|---|---|---|---|
| ➖ | tcp_syslog_to_blackhole | ingress throughput | +1.80 | [-11.29, +14.90] | Logs |
| ➖ | otel_to_otel_logs | ingress throughput | +0.28 | [-0.53, +1.09] | Logs |
| ➖ | file_tree | memory utilization | +0.08 | [+0.03, +0.14] | Logs |
| ➖ | tcp_dd_logs_filter_exclude | ingress throughput | +0.00 | [-0.01, +0.01] | Logs |
| ➖ | uds_dogstatsd_to_api | ingress throughput | -0.00 | [-0.00, +0.00] | Logs |
| ➖ | idle | memory utilization | -0.16 | [-0.19, -0.12] | Logs |
| ➖ | pycheck_1000_100byte_tags | % cpu utilization | -0.70 | [-5.41, +4.01] | Logs |
| ➖ | uds_dogstatsd_to_api_cpu | % cpu utilization | -0.73 | [-1.61, +0.15] | Logs |
| ➖ | basic_py_check | % cpu utilization | -0.77 | [-3.40, +1.86] | Logs |
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:
-
Its estimated |Δ mean %| ≥ 5.00%, indicating the change is big enough to merit a closer look.
-
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.
-
Its configuration does not mark it "erratic".
![pr-commenter[bot] avatar](https://avatars.githubusercontent.com/u/365230?v=4 "Published by a pub.dev verified publisher"){kind=small}
Go Package Import Differences
Baseline: ab2f289b60120969fa36940e9ce8c08db33402e0 Comparison: 963a6c29eaa867ff723ccab27f11e853235edf97
| binary | os | arch | change |
|---|---|---|---|
| agent | linux | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| agent | linux | arm64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| agent | windows | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| agent | darwin | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| agent | darwin | arm64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| iot-agent | linux | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| iot-agent | linux | arm64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| heroku-agent | linux | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| cluster-agent | linux | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| cluster-agent | linux | arm64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| security-agent | linux | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| security-agent | linux | arm64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| system-probe | linux | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| system-probe | linux | arm64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
| system-probe | windows | amd64 | +1, -0
+github.com/DataDog/datadog-agent/pkg/logs/launchers/integration
|
![cit-pr-commenter[bot] avatar](https://avatars.githubusercontent.com/in/330445?v=4 "Published by a pub.dev verified publisher"){kind=small}
Serverless Benchmark Results
BenchmarkStartEndInvocation comparison between 81bf3b2e412d67dfe68e2e6cfa2fe885d032e552 and 6904ef406cd2d0764d7966ba45bf4e49e4e5c9c0.
tl;dr
Use these benchmarks as an insight tool during development.
-
Skim down the
vs basecolumn in each chart. If there is a~, then there was no statistically significant change to the benchmark. Otherwise, ensure the estimated percent change is either negative or very small. -
The last row of each chart is the
geomean. Ensure this percentage is either negative or very small.
What is this benchmarking?
The BenchmarkStartEndInvocation compares the amount of time it takes to call the start-invocation and end-invocation endpoints. For universal instrumentation languages (Dotnet, Golang, Java, Ruby), this represents the majority of the duration overhead added by our tracing layer.
The benchmark is run using a large variety of lambda request payloads. In the charts below, there is one row for each event payload type.
How do I interpret these charts?
The charts below comes from benchstat. They represent the statistical change in duration (sec/op), memory overhead (B/op), and allocations (allocs/op).
The benchstat docs explain how to interpret these charts.
Before the comparison table, we see common file-level configuration. If there are benchmarks with different configuration (for example, from different packages), benchstat will print separate tables for each configuration.
The table then compares the two input files for each benchmark. It shows the median and 95% confidence interval summaries for each benchmark before and after the change, and an A/B comparison under "vs base". ... The p-value measures how likely it is that any differences were due to random chance (i.e., noise). The "~" means benchstat did not detect a statistically significant difference between the two inputs. ...
Note that "statistically significant" is not the same as "large": with enough low-noise data, even very small changes can be distinguished from noise and considered statistically significant. It is, of course, generally easier to distinguish large changes from noise.
Finally, the last row of the table shows the geometric mean of each column, giving an overall picture of how the benchmarks changed. Proportional changes in the geomean reflect proportional changes in the benchmarks. For example, given n benchmarks, if sec/op for one of them increases by a factor of 2, then the sec/op geomean will increase by a factor of ⁿ√2.
I need more help
First off, do not worry if the benchmarks are failing. They are not tests. The intention is for them to be a tool for you to use during development.
If you would like a hand interpreting the results come chat with us in #serverless-agent in the internal DataDog slack or in #serverless in the public DataDog slack. We're happy to help!
Benchmark stats
goos: linux
goarch: amd64
pkg: github.com/DataDog/datadog-agent/pkg/serverless/daemon
cpu: AMD EPYC 7763 64-Core Processor
│ baseline/benchmark.log │ current/benchmark.log │
│ sec/op │ sec/op vs base │
api-gateway-appsec.json 85.95µ ± 3% 85.93µ ± 7% ~ (p=0.529 n=10)
api-gateway-kong-appsec.json 69.01µ ± 3% 67.86µ ± 2% -1.66% (p=0.023 n=10)
api-gateway-kong.json 68.11µ ± 2% 66.65µ ± 2% -2.14% (p=0.003 n=10)
api-gateway-non-proxy-async.json 107.9µ ± 1% 105.6µ ± 2% -2.09% (p=0.011 n=10)
api-gateway-non-proxy.json 107.9µ ± 3% 106.3µ ± 1% -1.45% (p=0.004 n=10)
api-gateway-websocket-connect.json 72.22µ ± 1% 69.85µ ± 2% -3.28% (p=0.000 n=10)
api-gateway-websocket-default.json 63.30µ ± 2% 62.73µ ± 1% -0.89% (p=0.019 n=10)
api-gateway-websocket-disconnect.json 63.83µ ± 1% 62.19µ ± 1% -2.56% (p=0.000 n=10)
api-gateway.json 115.5µ ± 1% 115.4µ ± 1% ~ (p=0.436 n=10)
application-load-balancer.json 64.19µ ± 2% 62.67µ ± 1% -2.36% (p=0.000 n=10)
cloudfront.json 47.87µ ± 2% 48.04µ ± 2% ~ (p=0.739 n=10)
cloudwatch-events.json 38.32µ ± 2% 38.13µ ± 2% ~ (p=0.631 n=10)
cloudwatch-logs.json 65.95µ ± 1% 65.58µ ± 2% ~ (p=0.190 n=10)
custom.json 30.70µ ± 2% 31.10µ ± 2% +1.30% (p=0.022 n=10)
dynamodb.json 94.60µ ± 2% 94.52µ ± 1% ~ (p=0.579 n=10)
empty.json 29.41µ ± 3% 29.70µ ± 2% ~ (p=0.247 n=10)
eventbridge-custom.json 42.70µ ± 3% 41.77µ ± 2% -2.17% (p=0.015 n=10)
http-api.json 73.80µ ± 2% 72.67µ ± 1% ~ (p=0.052 n=10)
kinesis-batch.json 71.44µ ± 1% 71.00µ ± 1% ~ (p=0.393 n=10)
kinesis.json 54.48µ ± 2% 54.08µ ± 1% ~ (p=0.089 n=10)
s3.json 59.99µ ± 2% 59.28µ ± 2% ~ (p=0.138 n=10)
sns-batch.json 92.24µ ± 2% 87.59µ ± 3% -5.04% (p=0.000 n=10)
sns.json 67.00µ ± 3% 64.19µ ± 2% -4.19% (p=0.000 n=10)
snssqs.json 117.6µ ± 2% 111.3µ ± 1% -5.43% (p=0.000 n=10)
snssqs_no_dd_context.json 102.66µ ± 3% 99.66µ ± 2% -2.92% (p=0.002 n=10)
sqs-aws-header.json 57.96µ ± 4% 56.12µ ± 2% -3.18% (p=0.000 n=10)
sqs-batch.json 98.71µ ± 1% 95.95µ ± 2% -2.80% (p=0.003 n=10)
sqs.json 72.30µ ± 2% 69.85µ ± 3% -3.40% (p=0.000 n=10)
sqs_no_dd_context.json 65.59µ ± 2% 62.77µ ± 3% -4.30% (p=0.003 n=10)
geomean 68.28µ 67.03µ -1.83%
│ baseline/benchmark.log │ current/benchmark.log │
│ B/op │ B/op vs base │
api-gateway-appsec.json 37.25Ki ± 0% 37.26Ki ± 0% ~ (p=0.927 n=10)
api-gateway-kong-appsec.json 26.92Ki ± 0% 26.91Ki ± 0% ~ (p=0.839 n=10)
api-gateway-kong.json 24.41Ki ± 0% 24.41Ki ± 0% ~ (p=0.986 n=10)
api-gateway-non-proxy-async.json 48.01Ki ± 0% 48.01Ki ± 0% ~ (p=0.985 n=10)
api-gateway-non-proxy.json 47.24Ki ± 0% 47.23Ki ± 0% ~ (p=0.159 n=10)
api-gateway-websocket-connect.json 25.45Ki ± 0% 25.45Ki ± 0% ~ (p=0.927 n=10)
api-gateway-websocket-default.json 21.35Ki ± 0% 21.35Ki ± 0% ~ (p=0.127 n=10)
api-gateway-websocket-disconnect.json 21.14Ki ± 0% 21.13Ki ± 0% ~ (p=0.287 n=10)
api-gateway.json 49.52Ki ± 0% 49.54Ki ± 0% ~ (p=0.148 n=10)
application-load-balancer.json 22.32Ki ± 0% 22.31Ki ± 0% ~ (p=0.196 n=10)
cloudfront.json 17.65Ki ± 0% 17.64Ki ± 0% ~ (p=0.782 n=10)
cloudwatch-events.json 11.69Ki ± 0% 11.68Ki ± 0% ~ (p=0.617 n=10)
cloudwatch-logs.json 53.36Ki ± 0% 53.36Ki ± 0% ~ (p=0.101 n=10)
custom.json 9.708Ki ± 0% 9.730Ki ± 0% +0.23% (p=0.000 n=10)
dynamodb.json 40.68Ki ± 0% 40.68Ki ± 0% ~ (p=0.591 n=10)
empty.json 9.265Ki ± 1% 9.289Ki ± 0% ~ (p=0.697 n=10)
eventbridge-custom.json 13.40Ki ± 0% 13.39Ki ± 0% ~ (p=0.239 n=10)
http-api.json 23.73Ki ± 0% 23.71Ki ± 0% ~ (p=0.353 n=10)
kinesis-batch.json 27.01Ki ± 0% 27.02Ki ± 0% ~ (p=0.182 n=10)
kinesis.json 17.79Ki ± 0% 17.80Ki ± 0% ~ (p=0.809 n=10)
s3.json 20.29Ki ± 1% 20.35Ki ± 0% +0.31% (p=0.011 n=10)
sns-batch.json 38.66Ki ± 0% 38.63Ki ± 0% ~ (p=0.109 n=10)
sns.json 24.00Ki ± 0% 23.97Ki ± 0% ~ (p=0.128 n=10)
snssqs.json 50.77Ki ± 0% 50.74Ki ± 0% ~ (p=0.218 n=10)
snssqs_no_dd_context.json 44.83Ki ± 0% 44.81Ki ± 0% ~ (p=0.796 n=10)
sqs-aws-header.json 18.84Ki ± 1% 18.82Ki ± 1% ~ (p=0.436 n=10)
sqs-batch.json 41.69Ki ± 0% 41.70Ki ± 0% ~ (p=0.631 n=10)
sqs.json 25.62Ki ± 1% 25.59Ki ± 0% ~ (p=0.631 n=10)
sqs_no_dd_context.json 20.74Ki ± 1% 20.69Ki ± 0% ~ (p=0.143 n=10)
geomean 25.70Ki 25.70Ki -0.00%
│ baseline/benchmark.log │ current/benchmark.log │
│ allocs/op │ allocs/op vs base │
api-gateway-appsec.json 629.0 ± 0% 629.5 ± 0% ~ (p=1.000 n=10)
api-gateway-kong-appsec.json 488.0 ± 0% 488.0 ± 0% ~ (p=1.000 n=10)
api-gateway-kong.json 466.0 ± 0% 466.0 ± 0% ~ (p=1.000 n=10) ¹
api-gateway-non-proxy-async.json 725.0 ± 0% 725.5 ± 0% ~ (p=1.000 n=10)
api-gateway-non-proxy.json 716.0 ± 0% 716.0 ± 0% ~ (p=1.000 n=10)
api-gateway-websocket-connect.json 453.0 ± 0% 453.0 ± 0% ~ (p=1.000 n=10)
api-gateway-websocket-default.json 379.0 ± 0% 379.0 ± 0% ~ (p=1.000 n=10)
api-gateway-websocket-disconnect.json 370.0 ± 0% 370.0 ± 0% ~ (p=1.000 n=10)
api-gateway.json 790.0 ± 0% 791.0 ± 0% ~ (p=0.656 n=10)
application-load-balancer.json 352.0 ± 0% 352.0 ± 0% ~ (p=1.000 n=10) ¹
cloudfront.json 284.0 ± 0% 284.0 ± 0% ~ (p=0.582 n=10)
cloudwatch-events.json 220.0 ± 0% 220.0 ± 0% ~ (p=1.000 n=10)
cloudwatch-logs.json 215.0 ± 0% 215.0 ± 0% ~ (p=1.000 n=10)
custom.json 168.0 ± 0% 168.0 ± 1% ~ (p=0.124 n=10)
dynamodb.json 589.0 ± 0% 589.0 ± 0% ~ (p=1.000 n=10)
empty.json 159.0 ± 1% 160.0 ± 1% ~ (p=0.370 n=10)
eventbridge-custom.json 254.0 ± 0% 253.0 ± 0% ~ (p=0.057 n=10)
http-api.json 433.0 ± 0% 432.0 ± 0% ~ (p=0.328 n=10)
kinesis-batch.json 390.5 ± 0% 391.0 ± 0% +0.13% (p=0.033 n=10)
kinesis.json 285.0 ± 0% 285.0 ± 0% ~ (p=1.000 n=10)
s3.json 357.0 ± 1% 358.0 ± 0% +0.28% (p=0.006 n=10)
sns-batch.json 455.0 ± 0% 455.0 ± 0% ~ (p=0.190 n=10)
sns.json 323.0 ± 0% 323.0 ± 0% ~ (p=0.376 n=10)
snssqs.json 451.0 ± 0% 450.0 ± 0% -0.22% (p=0.010 n=10)
snssqs_no_dd_context.json 399.5 ± 0% 399.5 ± 0% ~ (p=0.744 n=10)
sqs-aws-header.json 274.0 ± 1% 274.0 ± 1% ~ (p=0.947 n=10)
sqs-batch.json 504.5 ± 0% 504.0 ± 0% ~ (p=0.766 n=10)
sqs.json 352.0 ± 1% 351.0 ± 0% ~ (p=0.804 n=10)
sqs_no_dd_context.json 325.5 ± 1% 324.5 ± 0% ~ (p=0.194 n=10)
geomean 376.8 376.7 -0.01%
¹ all samples are equal
![github-actions[bot] avatar](https://avatars.githubusercontent.com/in/15368?v=4 "Published by a pub.dev verified publisher"){kind=small}
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=40339153 --os-family=ubuntu
Note: This applies to commit 963a6c29
:steam_locomotive: MergeQueue: pull request added to the queue
The median merge time in main is 22m.
Use /merge -c to cancel this operation!