You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

community.general.opentelemetry callback – Create distributed traces with OpenTelemetry

Note

This callback plugin is part of the community.general collection (version 4.8.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.opentelemetry.

New in version 3.7.0: of community.general

Synopsis

• This callback creates distributed traces for each Ansible task with OpenTelemetry.

• You can configure the OpenTelemetry exporter and SDK with environment variables.

• See https://opentelemetry-python.readthedocs.io/en/latest/exporter/otlp/otlp.html.

• See https://opentelemetry-python.readthedocs.io/en/latest/sdk/environment_variables.html#opentelemetry-sdk-environment-variables.

Requirements

The below requirements are needed on the local controller node that executes this callback.

• opentelemetry-api (Python library)

• opentelemetry-exporter-otlp (Python library)

• opentelemetry-sdk (Python library)

Parameters

Parameter	Comments
enable_from_environment string added in 3.8.0 of community.general	Whether to enable this callback only if the given environment variable exists and it is set to true. This is handy when you use Configuration as Code and want to send distributed traces if running in the CI rather when running Ansible locally. For such, it evaluates the given enable_from_environment value as environment variable and if set to true this plugin will be enabled. Configuration: Environment variable: ANSIBLE_OPENTELEMETRY_ENABLE_FROM_ENVIRONMENT
hide_task_arguments boolean	Hide the arguments for a task. Choices: no ← (default) yes Configuration: Environment variable: ANSIBLE_OPENTELEMETRY_HIDE_TASK_ARGUMENTS
otel_service_name string	The service name resource attribute. Default: “ansible” Configuration: Environment variable: OTEL_SERVICE_NAME
traceparent string	The W3C Trace Context header traceparent. Default: “None” Configuration: Environment variable: TRACEPARENT

Examples

examples: |
  Enable the plugin in ansible.cfg:
    [defaults]
    callbacks_enabled = community.general.opentelemetry

  Set the environment variable:
    export OTEL_EXPORTER_OTLP_ENDPOINT=<your endpoint (OTLP/HTTP)>
    export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer your_otel_token"
    export OTEL_SERVICE_NAME=your_service_name

Authors

• Victor Martinez (@v1v)

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.

Collection links

Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication