Configure the Python Library

See the following sections for information about the configuration options available for the Python Library and how to set them. The Service key is the only required configuration; all other configurations are optional.

How to set configuration options

Some configuration options to control the Python Library's behavior can be set in the JSON config file, some can be set in system environment variables, and some can be set in either the config file or in system environment variables. See the complete list of configuration options to determine where you can set the configuration option.

The location of the JSON config file is defined in the SW_APM_CONFIG_FILE environment variable. For an example of some configuration options defined in a config file, see Config File Example.

If the same configuration option is set in both a config file and an environment variable, the setting is applied with the following precedence:

Environment variable
Property in config file
Default value

If an invalid configuration option is defined in one of these places, the next defined setting in the above order of precedence is used.

If a configuration option expects a Boolean value, the following inputs are accepted: true, false. Boolean values are case-insensitive.

Complete list of configuration options

The following is the complete list of instrumentation configuration options:

Service key

The Service key is used to identify your account and the service being instrumented. It is shown in the Add Data dialog when you add the new service.

It is a required configuration and should be in the form of YourApiToken:YourServiceName. Replace YourApiToken with the SolarWinds Observability API token (ingestion type) generated for this service, and replace YourServiceName with your chosen name for this service. See API Tokens.

The service name is also called the entity's service ID in SolarWinds Observability SaaS. The service name can also be seen in the Overview tab in the service entity's Entity Explorer details view. Editing the display name of the service entity in SolarWinds Observability SaaS does not affect the Service key.

YourServiceName in the Service key takes lower precedence than OTEL_SERVICE_NAME or OTEL_RESOURCE_ATTRIBUTES, if either is set.

System environment variable

SW_APM_SERVICE_KEY

Required

Yes

Default

None

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export SW_APM_SERVICE_KEY="ABC123abcABC123abcABC123abcABC123abcABC123abcABC123abcABC123abcABC123ab:my-service"

Collector

The collector is the ingestion endpoint the library connects to and exports data to. It should be defined using the format host:port. To determine the endpoint for your organization, see Data centers and endpoint URIs. Port is optional and defaults to 443.

System environment variable

SW_APM_COLLECTOR

Config file property

collector

Required

Default

apm.collector.na-01.cloud.solarwinds.com:443

History

Introduced with version 0.2.1 of the Python Instrumentation Library.

Example

System environment variable

export SW_APM_COLLECTOR=YourHost:PortNumber

Use HTTP proxy

The agent can connect to the SolarWinds APM collector through a proxy. The config value should be either http://<proxyHost>:<proxyPort> for a proxy server that does not require authentication, or http://<username>:<password>@<proxyHost>:<proxyPort> for a proxy server that requires Basic authentication. HTTP is the only type of connection supported between the Python Library and the proxy. However, the library traffic to SolarWinds Observability is still encrypted using SSL/TLS.

Python library 4.0.0

For Python library version 4.0.0 and newer, SolarWinds requires proxy configuration by environment variable HTTP_PROXY. Refer to HTTP Proxies for more information.

System environment variable

HTTP_PROXY

Valid Values

Any string starting with http://

This field is case-sensitive.

Required

Default

None

History

Introduced with version 4.0.0 of the Python Instrumentation Library.

Examples

export HTTP_PROXY="http://my-proxy:3306"

History

Introduced with version 4.0.0 of the Python Instrumentation Library.

Prior to Python library 4.0.0

For Python library version 3.6.0 and older, SolarWinds recommends using the Python Library-specific configuration. However, if a Python Library-specific configuration is not set, its underlying network library uses a system-wide proxy defined in the environment variables HTTP_PROXY, HTTPS_PROXY, or grpc_proxy. Refer to HTTP Proxies and gRPC environment variables for more information.

System environment variable

SW_APM_PROXY

Config file property

proxy

Valid Values

Any string starting with http://

This field is case-sensitive.

Required

Default

None

History

Support for this configuration was dropped with version 4.0.0 of the Python Instrumentation Library.

Introduced with version 0.1.0 of the Python Instrumentation Library.

Examples

export SW_APM_PROXY="http://my-proxy:3306"

Trigger tracing mode

This enables or disables trigger tracing for the service. Setting it to disabled turns off support for trigger trace, which might affect DEM visibility into the service.

System environment variable

SW_APM_TRIGGER_TRACE

Config file property

triggerTrace

Required

Default

enabled

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Logging level

By default, the Python Library sends debug output to stderr. For most environments, stderr is included in the web application's logs. To troubleshoot the Python Library, enable debug-level logging (4 or higher) and check the messages. Python Library logging can be disabled by setting the log level to -1.

System environment variable

SW_APM_DEBUG_LEVEL

Config file property

debugLevel

Valid Values

`-1`	disable
`0`	fatal
`1`	error
`2`	warning
`3`	info
`4`	debug low
`5`	debug medium
`6`	debug high

Required

Default

2 (warning)

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export SW_APM_DEBUG_LEVEL=-1

Logging output filepath

By default, the Python Library sends log output to stderr. To change output destination of the Python Library to a file instead, set the filepath of where the logs will be written. If the parent directory does not exist the library will attempt to create it.

System environment variable

SW_APM_LOG_FILEPATH

Config file property

logFilepath

Required

Default

None

History

Introduced with version 1.1.0 of the Python Instrumentation Library.

Example

export SW_APM_LOG_FILEPATH=/path/to/messages.log

Tracing mode

Tracing can be disabled for the service. When disabled, requests are no longer monitored, and traces and metrics are not sent. The trace context is still injected in the HTTP request and response headers.

To completely disable the library, remove the library. See Uninstall the Python Library.

System environment variable

SW_APM_TRACING_MODE

Config file property

tracingMode

Required

Possible values

`disabled`	Does not continue existing traces or start new ones, and does not report metrics for requests.
`enabled`	(Default) Create or continue traces (subject to sampling and rate limits), and always report metrics for requests.

Default

enabled

History

Introduced with version 0.10.0 of the Python Instrumentation Library.

Example

export SW_APM_TRACING_MODE=disabled

Tracing mode per transaction (Enable or disable tracing for specific requests)

Defines the tracing mode for requests at a granular level, based on whether the requests match the specified criteria. Tracing is enabled or disabled for requests based on the tracing property of the matching criteria, superseding tracing mode settings applied at the service level. Requests with "tracing" : "disabled" are not monitored, and do not create traces or send metrics. Requests with "tracing" : "enabled" define the requests that are monitored even when tracing is disabled at the service level.

Config file property

transactionSettings

Possible values

Config value should be an array of JSON entries where each entry must contain a matcher and the desired tracing mode:

regex (required): The value should be a string representation of a Python regular expression (see Python regular expression module). Because the regular expression is defined in a JSON string, use double backslashes to escape your Python regular expressions. The first backslash ensures the second backslash is retained as a Python escape character in the regular expression and still escapes whatever follows in the regex pattern.
tracing (required): The value should either be enabled or disabled.

Entries are applied in the order defined in the JSON array. To find a match, each entry is compared against the Span kind and name (concatenated with a colon, for example CLIENT:SELECT). The first matching entry for a request is taken. Support for HTTP URL-based filtering is coming soon.

Required

Default

None. No transaction-specific tracing mode.

History

Introduced with version 0.10.0 of the Python Instrumentation Library.

Example

Config file property

"transactionSettings": [
    {
        "regex": "CLIENT:GET",
        "tracing": "disabled"
    },
    {
        "regex": "INTERNAL:Task\\.run",
        "tracing": "disabled"
    },
    {
        "regex": "SERVER:my/[a-zA-Z0-9-<>:]*/path/",
        "tracing": "disabled"
    }
]

Transaction naming

The Python Library provides the option to assign a custom transaction name to all traces. This can be used to, for example, target specific instrumented lambda functions. To configure a name, set the SW_APM_TRANSACTION_NAME environment variable as described below.

Configuration of a custom transaction name is superseded by any use of the SDK to set_transaction_name, described in Python set_transaction_name.

System environment variable

SW_APM_TRANSACTION_NAME

Config file property

transactionName

Valid values

Any string representing a valid transaction name.

This field is case-sensitive.

Required

Default

None

History

Introduced with version 0.18.0 of the Python Instrumentation Library.

Example

export SW_APM_TRANSACTION_NAME=my-cool-request

Disable the library

The Python Library provides the option to completely disable the instrumentation without explicitly removing the library from your application. To disable the library, set the SW_APM_AGENT_ENABLED environment variable as described below.

System environment variable

SW_APM_AGENT_ENABLED

Config file property

agentEnabled

Valid values

This field is case-insensitive.

`false`	Do not instrument the application (that is, do not generate any trace data)
`true`	Normal tracing operation

Required

Default

true

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export SW_APM_AGENT_ENABLED=false

Enable OTLP logs export

The Python Library provides the option to export OTLP logs telemetry from your instrumented service to SolarWinds Observability platform. To enable, set the OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED environment variable as described below. The library will also respect other OpenTelemetry environment variables such as OTEL_EXPORTER_OTLP_LOGS_PROTOCOL, if set.

Note that there is no API for Logs as there is for OpenTelemetry traces and metrics. Instead, existing logging libraries are bridged by the OpenTelemetry SDK, for example Python's logging module. OpenTelemetry sets up a handler for that bridge when OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true. Additional logging handlers can be added for your use case. For more information, see OpenTelemetry Logging.

If OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true, it is recommended to use name-spaced loggers (for example logging.getLogger(__name__)) so telemetry is only collected for your service, instead of using the logging module root logger (logging.getLogger()).

System environment variable

OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED

Valid values

This field is case-insensitive.

`false`	Do not generate nor export any logs telemetry
`true`	Logs export enabled

Required

Default

false

History

Introduced with version 2.2.0 of the Python Instrumentation Library.

Example

export OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true

Enable OTLP metrics export

The Python Library exports OTLP metrics telemetry from your instrumented service to SolarWinds Observability platform. To disable, set the SW_APM_EXPORT_METRICS_ENABLED environment variable as described below.

System environment variable

SW_APM_EXPORT_METRICS_ENABLED

Config file property

exportMetricsEnabled

Valid values

This field is case-insensitive.

`true`	Instrumentation metrics export enabled
`false`	Do not export OTLP metrics from OpenTelemetry instrumentation

Required

Default

true

History

Configuration updated with version 3.6.0 of the Python Instrumentation Library.

Introduced with version 3.2.0 of the Python Instrumentation Library.

Example

export SW_APM_EXPORT_METRICS_ENABLED=true

Enable auto-instrumentation of system metrics

The Python Library facilitates export of system metrics when Python system and process utilities (psutil) are installed in the service environment. To set up the utilities and enable or disable system metrics, see Requirements to enable System Metrics.

Disable auto-instrumentation of system metrics

Disable the OpenTelemetery instrumentor for system metrics with OTEL_PYTHON_DISABLED_INSTRUMENTATIONS=system_metrics. See also Disable specific instrumentation libraries.

Alternatively, the uninstallation of psutil will also disable system metrics generated by solarwinds-apm: pip uninstall psutil

Disable specific instrumentation libraries

The Python Library provides the option to disable the instrumentation of specific Python libraries, while still instrumenting other libraries in your application. To disable specific libraries, set the OTEL_PYTHON_DISABLED_INSTRUMENTATIONS environment variable as described below.

System environment variable

OTEL_PYTHON_DISABLED_INSTRUMENTATIONS

Required

Default

None

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export OTEL_PYTHON_DISABLED_INSTRUMENTATIONS=urllib3,asyncpg

Customize OpenTelemetry propagators

The Python Library sets the OpenTelemetry propagators necessary for distributed tracing by default, so no changes to the propagators are required for the library to work. If you want additional propagators, you can install and use them. For example:

pip install my-custom-propagator

After installing the propagators, set the OTEL_PROPAGATORS environment variable as described below.

System environment variable

OTEL_PROPAGATORS

Valid values

A string representing a list of valid propagator entry point names, delimited by commas. solarwinds_propagator must be included. It is unnecessary to configure the standard tracecontext propagator, as the Python Library automatically propagates W3C context.

solarwinds_propagator and the standard baggage propagator are the defaults.

Introduced with version 4.4.0 of the Python Instrumentation Library.

This field is case-sensitive.

Required

Default

solarwinds_propagator,baggage

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export OTEL_PROPAGATORS="solarwinds_propagator,my_custom_propagator,baggage"

Customize OpenTelemetry traces exporters

The Python Library sets an OpenTelemetry traces exporter for SolarWinds Observability platform by default, so no changes to the exporters are necessary for the library to work. Python Library includes installation of OTLP HTTP and gRPC exporters. If you want additional exporters, you can install and use them. For example:

pip install opentelemetry-exporter-zipkin

After installing the exporters, set the OTEL_TRACES_EXPORTER environment variable as described below. The library will also respect other OpenTelemetry environment variables such as OTEL_EXPORTER_OTLP_LOGS_PROTOCOL, if set.

System environment variable

OTEL_TRACES_EXPORTER

Valid values

A string representing a list of valid exporter entry point names, delimited by commas.

The order of the exporters does not matter.

This field is case-sensitive.

Required

Default

otlp_proto_http

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export OTEL_TRACES_EXPORTER="otlp_proto_http,zipkin"

Customize OpenTelemetry metrics exporters

The Python Library sets an OpenTelemetry metrics exporter for SolarWinds Observability platform by default when SW_APM_EXPORT_METRICS_ENABLED is true, so no changes to the exporters are necessary for the library to work. Python Library includes installation of OTLP HTTP and gRPC exporters. If you want additional exporters, you can install and use them. For example:

pip install opentelemetry-exporter-prometheus

After installing the exporters, set the OTEL_METRICS_EXPORTER environment variable as described below.

System environment variable

OTEL_METRICS_EXPORTER

Valid values

A string representing a list of valid exporter entry point names, delimited by commas.

The order of the exporters does not matter.

This field is case-sensitive.

Required

Default

otlp_proto_http

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export OTEL_METRICS_EXPORTER="otlp_proto_http,prometheus"

Customize OpenTelemetry logs exporters

The Python Library sets an OpenTelemetry logs exporter for SolarWinds Observability platform by default when SW_APM_EXPORT_LOGS_ENABLED is true, so no changes to the exporters are necessary for the library to work. Python Library includes installation of OTLP HTTP and gRPC exporters. If you want additional exporters that support logs export, you can install and use them. For example:

pip install my-cool-logs-exporter

After installing the exporters, set the OTEL_LOGS_EXPORTER environment variable as described below.

System environment variable

OTEL_LOGS_EXPORTER

Valid values

A string representing a list of valid exporter entry point names, delimited by commas.

The order of the exporters does not matter.

This field is case-sensitive.

Required

Default

otlp_proto_http

History

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export OTEL_LOGS_EXPORTER="otlp_proto_http,my_logs_exporter"

Customize OpenTelemetry service name

The Python Library provides the option to pass a service name to OpenTelemetry environment variable. This is a convenience variable that takes precedence over service.name in OTEL_RESOURCE_ATTRIBUTES and YourServiceName of the Service key.

System environment variable

OTEL_SERVICE_NAME

Valid values

A string representing a service name.

This field is case-sensitive.

Required

Default

None

History

Introduced with version 0.5.0 of the Python Instrumentation Library.

Example

export OTEL_SERVICE_NAME="my-service"

Customize OpenTelemetry resource attributes

The Python Library provides the option to pass resource information to OpenTelemetry by environment variable.

If service.name key-value is set, it will be passed to OpenTelemetry with precedence over YourServiceName of the Service key, but with a lower precedence than OTEL_SERVICE_NAME, if set.

System environment variable

OTEL_RESOURCE_ATTRIBUTES

Valid values

A string representing a list of attribute keys and their values, delimited by commas.

This field is case-sensitive.

Required

Default

None

History

Introduced with version 0.5.0 of the Python Instrumentation Library.

Example

export OTEL_RESOURCE_ATTRIBUTES="service.name=my-service,another-resource=some-value"

Config file location

Specify the location of the Python Library config file

System environment variable

SW_APM_CONFIG_FILE

Required

Default

./solarwinds-apm-config.json

History

Introduced with version 0.9.0 of the Python Instrumentation Library.

Example

export SW_APM_CONFIG_FILE=/path/to/my_config.json

Trace context in logs

Trace context as a string identifier can be added to logs to correlate log entries for a single transaction. See Python trace context in logs for information about how this feature is supported in the Python Library.

Application logs for your service entity are not included in the data sent by APM libraries. Configure your server or application to send application logs to SolarWinds Observability SaaS. See Add logs from services.

System environment variable

OTEL_PYTHON_LOG_CORRELATION

Required

Possible scope values

`false`	No action for the scope.
`true`	Trace context is inserted in logs to correlate log entries to transactions.

Default

false

History

Introduced with version 0.11.0 of the Python Instrumentation Library.

Example

export OTEL_PYTHON_LOG_CORRELATION=true

Custom logging format

Define a custom logging format when trace context in logs is set with OTEL_PYTHON_LOG_CORRELATION. The Python Library custom logging format is based on the OTel custom logging format, but the default value for the SolarWinds Observability Python Library is different from the standard OTel custom logging format.

While the LoggingInstrumentor function is available for the standard OTel agent, it cannot be used to define the custom logging format for the SolarWinds Python Library.

System environment variable

OTEL_PYTHON_LOG_FORMAT

Valid values

Any string representing a valid logging format.

Required

Default

%(asctime)s %(levelname)s [%(name)s] [%(filename)s:%(lineno)d] [trace_id=%(otelTraceID)s span_id=%(otelSpanID)s trace_flags=%(otelTraceSampled)02d resource.service.name=%(otelServiceName)s] - %(message)s

Example

export OTEL_PYTHON_LOG_FORMAT="[%(otelServiceName)s][00-%(otelTraceID)s-%(otelSpanID)s-%(otelTraceSampled)02d] - %(message)s"

Trace context in queries

Trace context as a string identifier can be added to queries to correlate queries for a single transaction. See Python trace context in queries for information about how this feature is supported in the Python Library.

System environment variable

SW_APM_ENABLED_SQLCOMMENT

Required

Valid values

A string representing a list of instrumentor keys and their values, delimited by commas. Accepted instrumentor names are: sqlalchemy, django, flask, psycopg2, and psycopg2. Other keys will be ignored.

This field is case-insensitive.

Default

false for each instrumentor

History

Introduced with version 3.1.0 of the Python Instrumentation Library.

Example

export SW_APM_ENABLED_SQLCOMMENT="psycopg2=true,sqlalchemy=false"

Customize trace context in queries

Trace context and other values added as comments in queries can be customized. See Python trace context in queries for information about how this feature is supported in the Python Library.

Customization of values is applied only if SW_APM_ENABLED_SQLCOMMENT is true.

Django instrumentation is an exception to configuration with SW_APM_OPTIONS_SQLCOMMENT. It must be customized using the application's settings.py file.

System environment variable

SW_APM_OPTIONS_SQLCOMMENT

Required

Valid values

A string representing a list of commenter options keys and their values, delimited by commas.

This field is case-sensitive.

The sqlcommenter options available are defined by some OpenTelemetry instrumentation libraries. All values are Boolean. They are true by default if SW_APM_ENABLED_SQLCOMMENT is true. For more information, see Flask instrumentation, SqlAlchemy instrumentation, psycopg2 instrumentation, and psycopg instrumentation.

Default

None

History

Introduced with version 3.1.0 of the Python Instrumentation Library.

Example

export SW_APM_OPTIONS_SQLCOMMENT=opentelemetry_values=true,db_driver=true,controller=false,route=false

Customize trace context in attributes

The trace contexts commented on queries are appended to some database client span attributes by default. This applies only if SW_APM_ENABLED_SQLCOMMENT is true. Optionally, this can be turned off for individual instrumentors by setting false

System environment variable

SW_APM_ENABLED_SQLCOMMENT_ATTRIBUTE

Required

Valid values

A string representing a list of instrumentor keys and their values, delimited by commas. Accepted instrumentor names are: sqlalchemy, django, flask, psycopg, and psycopg2. Other keys will be ignored.

This field is case-insensitive.

Default

true for each instrumentor

History

Introduced with version 3.1.0 of the Python Instrumentation Library.

Example

export SW_APM_ENABLED_SQLCOMMENT_ATTRIBUTE="psycopg2=false,sqlalchemy=true"

Config File Example

{
    "agentEnabled": true,
    "tracingMode": "enabled",
    "collector": "apm.collector.na-01.cloud.solarwinds.com:443",
    "debugLevel": 3,
    "hostnameAlias": "apm-host-east",
    "trustedpath": "/path/to/cacert.crt",
    "ec2MetadataTimeout": 1000,
    "proxy": "http://my-proxy:3306",
    "transactionSettings": [
        {
            "regex": "CLIENT:GET",
            "tracing": "disabled"
        },
        {
            "regex": "INTERNAL:Task\\.run",
            "tracing": "disabled"
        },
        {
            "regex": "SERVER:my/[a-zA-Z0-9-<>:]*/path/",
            "tracing": "disabled"
        }
    ]
}

Dropped: OTLP logs export by `SW_APM_EXPORT_LOGS_ENABLED`

SW_APM_EXPORT_LOGS_ENABLED was a convenience variable for OTLP logs telemetry opt-in that is no longer supported. Please use OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED environment variable instead.

System environment variable

SW_APM_EXPORT_LOGS_ENABLED

Config file property

exportLogsEnabled

Valid values

This field is case-insensitive.

`false`	Do not generate nor export any logs telemetry
`true`	Logs export enabled

Required

Default

false

History

Support for this configuration was dropped with version 5.0.0 of the Python Instrumentation Library.

Introduced with version 2.2.0 of the Python Instrumentation Library.

Example

export SW_APM_EXPORT_LOGS_ENABLED=true

Dropped: Host name alias

An optional descriptive host name can be used to easily identify the host. If configured, the host name alias is displayed and can be used as a filter in the Traces Explorer.

System environment variable

SW_APM_HOSTNAME_ALIAS

Config file property

hostnameAlias

Required

Default

None

History

Support for this configuration was dropped with version 4.0.0 of the Python Instrumentation Library.

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export SW_APM_HOSTNAME_ALIAS=apm-host-east

Dropped: Trusted certificate path

The library uses the trusted CA certificates configured for the underlying native extension library to verify the TLS connection to the collector. To override the default, define the trusted certificate path configuration option with an absolute path to a specific trusted certificate file in PEM format.

System environment variable

SW_APM_TRUSTEDPATH

Config file property

trustedpath

Required

Default

None

History

Support for this configuration was dropped with version 4.0.0 of the Python Instrumentation Library.

Introduced with version 0.2.1 of the Python Instrumentation Library.

Example

export SW_APM_TRUSTEDPATH=/path/to/cacert.crt

Dropped: EC2 Metadata Timeout

The Python Library is able to detect if it is running on an AWS EC2 or OpenStack instance by querying Instance Metadata. The timeout (in milliseconds) for retrieving the metadata can be set through this configuration. It is safe to set this value to 0 for apps that do not run on EC2 or OpenStack.

System environment variable

SW_APM_EC2_METADATA_TIMEOUT

Config file property

ec2MetadataTimeout

Valid values

This field expects an integer between 0 and 3000

Required

Default

1000

History

Support for this configuration was dropped with version 4.0.0 of the Python Instrumentation Library.

Introduced with version 0.1.0 of the Python Instrumentation Library.

Example

export SW_APM_EC2_METADATA_TIMEOUT=500

The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.

Search SolarWinds Support

Configure the Python Library

How to set configuration options

Complete list of configuration options

Service key

Collector

Use HTTP proxy

Python library 4.0.0

Prior to Python library 4.0.0

Trigger tracing mode

Logging level

Logging output filepath

Tracing mode

Tracing mode per transaction (Enable or disable tracing for specific requests)

Transaction naming

Disable the library

Enable OTLP logs export

Enable OTLP metrics export

Enable auto-instrumentation of system metrics

Disable auto-instrumentation of system metrics

Disable specific instrumentation libraries

Customize OpenTelemetry propagators

Customize OpenTelemetry traces exporters

Customize OpenTelemetry metrics exporters

Customize OpenTelemetry logs exporters

Customize OpenTelemetry service name

Customize OpenTelemetry resource attributes

Config file location

Trace context in logs

Custom logging format

Trace context in queries

Customize trace context in queries

Customize trace context in attributes

Config File Example

Dropped: OTLP logs export by SW_APM_EXPORT_LOGS_ENABLED

Dropped: Host name alias

Dropped: Trusted certificate path

Dropped: EC2 Metadata Timeout

Dropped: OTLP logs export by `SW_APM_EXPORT_LOGS_ENABLED`