Correlate Logs and Tests

Docs > Test Optimization in Datadog > Correlate Logs and Tests

Overview

You can correlate Test Optimization data with logs injected into Datadog, which allows you to view and analyze logs for specific test cases.

Examine logs for specific test cases with logs and tests correlation.

Setup

Correlation can be configured differently depending on how you send your tests data to Datadog.

Java

Agentless log submission is supported for the following languages and frameworks:

dd-trace-java >= 1.35.2 and Log4j2.

Use the following environment variables to enable and configure Agentless log submission:

Name	Description	Default value
`DD_AGENTLESS_LOG_SUBMISSION_ENABLED` (required)	Enables/disables log submission	`false`
`DD_AGENTLESS_LOG_SUBMISSION_LEVEL` (optional)	Sets log level for Agentless submission	`INFO`
`DD_AGENTLESS_LOG_SUBMISSION_QUEUE_SIZE` (optional)	Sets the maximum size of pending logs queue	`1024`
`DD_AGENTLESS_LOG_SUBMISSION_URL` (optional)	Sets custom URL for submitting logs	-

Javascript/Typescript

Agentless log submission is supported for the following languages and frameworks:

dd-trace-js >= 5.24.0 and dd-trace-js >= 4.48.0 and winston.

Use the following environment variables to enable and configure Agentless log submission:

Name	Description	Default value
`DD_AGENTLESS_LOG_SUBMISSION_ENABLED` (required)	Enables/disables log submission	`false`
`DD_AGENTLESS_LOG_SUBMISSION_URL` (optional)	Sets custom URL for submitting logs	-

.NET

Agentless log submission is supported for the following languages and frameworks:

dd-trace-dotnet >= 2.50.0 and XUnit TestOutputHelper.

Use the following environment variables to enable and configure Agentless log submission:

Name	Description	Default value
`DD_CIVISIBILITY_LOGS_ENABLED` (required)	Enables/disables CI Visibility log submission	`false`

Swift

Use the following environment variables to enable and configure log submission:

Name	Description	Default value
`DD_ENABLE_STDOUT_INSTRUMENTATION`	Enables/disables stdout log submission	`false`
`DD_ENABLE_STDERR_INSTRUMENTATION`	Enables/disables stderr log submission	`false`

Python

Requirements: ddtrace >= 4.8.0.

Log submission is supported for the pytest test framework, and only when logs are emitted with the standard library logging module.

Use the following environment variable to enable log submission for agentless mode:

Name	Description	Default value
`DD_AGENTLESS_LOG_SUBMISSION_ENABLED` (required)	Enables/disables log submission	`false`

If you use the Datadog Agent instead of agentless mode, set instead DD_LOGS_INJECTION=true in the environment.

Ruby

Agentless logs submission with Test Optimization is supported for Rails applications. Before enabling, ensure that your application is instrumented with Datadog tracing.

To use agentless log submission, you need datadog-ci version 0.16 or later. The following logging libraries are supported: