Traces Configuration¶

Airflow can be set up to send traces in OpenTelemetry.

Setup - OpenTelemetry¶

To use OpenTelemetry you must first install the required packages:

pip install 'apache-airflow[otel]'

Add the following lines to your configuration file e.g. airflow.cfg

[traces]
otel_on = True
otel_host = localhost
otel_port = 8889
otel_application = airflow
otel_ssl_active = False
otel_task_log_event = True

Note

To support the OpenTelemetry exporter standard, the traces configurations are transparently superseded by use of standard OpenTelemetry SDK environment variables.

OTEL_EXPORTER_OTLP_ENDPOINT and OTEL_EXPORTER_OTLP_TRACES_ENDPOINT overridden otel_host, otel_port and otel_ssl_active

See the OpenTelemetry exporter protocol specification and SDK environment variable documentation for more information.

Enable Https¶

To establish an HTTPS connection to the OpenTelemetry collector You need to configure the SSL certificate and key within the OpenTelemetry collector’s config.yml file.

receivers:
  otlp:
    protocols:
      http:
        endpoint: 0.0.0.0:4318
        tls:
          cert_file: "/path/to/cert/cert.crt"
          key_file: "/path/to/key/key.pem"