Skip to content

Latest commit

 

History

History
42 lines (33 loc) · 2.85 KB

README.md

File metadata and controls

42 lines (33 loc) · 2.85 KB
Raw

Datadog Test Visibility installation script

A script that installs Datadog tracing libraries and prints environment variables necessary for configuring Datadog Test Visibility. The variables are printed in the following format: variableName=variableValue

Supported languages are .NET, Java, Javascript, and Python.

About Datadog Test Visibility

Test Visibility provides a test-first view into your CI health by displaying important metrics and results from your tests. It can help you investigate and mitigate performance problems and test failures that are most relevant to your work, focusing on the code you are responsible for, rather than the pipelines which run your tests.

Usage

Run the script with the necessary parameters:

DD_CIVISIBILITY_INSTRUMENTATION_LANGUAGES=... DD_API_KEY=... ./install_test_visibility.sh

The script parameters are

  • DD_CIVISIBILITY_INSTRUMENTATION_LANGUAGES: (required) List of languages to be instrumented. Can be either all or any of java, js, python, dotnet (multiple languages can be specified as a space-separated list).
  • DD_API_KEY: (required for .NET tracer installation) Datadog API key. Can be found at https://app.datadoghq.com/organization-settings/api-keys
  • DD_TRACER_FOLDER: (optional) The folder where the tracing libraries will be installed, defaults to ./.datadog
  • DD_SITE: (optional) Datadog site, defaults to US1. See https://docs.datadoghq.com/getting_started/site for more information about sites.
  • DD_SET_TRACER_VERSION_DOTNET: (optional) Version of the .NET tracer to install. If not provided, the latest version is installed.
  • DD_SET_TRACER_VERSION_JAVA: (optional) Version of the Java tracer to install (without the v prefix, e.g. 1.37.1). If not provided, the latest version is installed.
  • DD_SET_TRACER_VERSION_JS: (optional) Version of the JS tracer to install. If not provided, the latest version is installed.
  • DD_SET_TRACER_VERSION_PYTHON: (optional) Version of the Python tracer to install. If not provided, the latest version is installed.
  • DD_INSTRUMENTATION_BUILD_SYSTEM_JAVA: (optional) A hint for Java instrumentation to instrument a specific build system. Allowed values are maven and gradle. If not specified, all Java processes will be instrumented.

The script will install the libraries and print the list of environment variables that should be set in order to enable Test Visibility. Example output:

DD_CIVISIBILITY_ENABLED=true
DD_CIVISIBILITY_AGENTLESS_ENABLED=true
DD_ENV=ci
JAVA_TOOL_OPTIONS=-javaagent:./.datadog/dd-java-agent.jar

If you want to set the variables printed by the script, use the following expression:

export $(DD_CIVISIBILITY_INSTRUMENTATION_LANGUAGES=... DD_API_KEY=... ./install_test_visibility.sh | xargs)