OS Manuals

/opt/chainguard/keep-api/bin/opentelemetry-instrument

Keep API server - open source alerting platform

From keep-api 0.55.0-r0 (enterprise-packages), captured 2026-11-08 by running opentelemetry-instrument --help (exit 0). permalink

Also provided by 1 other package version
usage: opentelemetry-instrument [-h] [--attribute_count_limit ATTRIBUTE_COUNT_LIMIT]
                                [--attribute_value_length_limit ATTRIBUTE_VALUE_LENGTH_LIMIT]
                                [--blrp_export_timeout BLRP_EXPORT_TIMEOUT]
                                [--blrp_max_export_batch_size BLRP_MAX_EXPORT_BATCH_SIZE]
                                [--blrp_max_queue_size BLRP_MAX_QUEUE_SIZE]
                                [--blrp_schedule_delay BLRP_SCHEDULE_DELAY]
                                [--bsp_export_timeout BSP_EXPORT_TIMEOUT]
                                [--bsp_max_export_batch_size BSP_MAX_EXPORT_BATCH_SIZE]
                                [--bsp_max_queue_size BSP_MAX_QUEUE_SIZE]
                                [--bsp_schedule_delay BSP_SCHEDULE_DELAY]
                                [--config_file CONFIG_FILE]
                                [--event_attribute_count_limit EVENT_ATTRIBUTE_COUNT_LIMIT]
                                [--experimental_resource_detectors EXPERIMENTAL_RESOURCE_DETECTORS]
                                [--exporter_otlp_certificate EXPORTER_OTLP_CERTIFICATE]
                                [--exporter_otlp_client_certificate EXPORTER_OTLP_CLIENT_CERTIFICATE]
                                [--exporter_otlp_client_key EXPORTER_OTLP_CLIENT_KEY]
                                [--exporter_otlp_compression EXPORTER_OTLP_COMPRESSION]
                                [--exporter_otlp_endpoint EXPORTER_OTLP_ENDPOINT]
                                [--exporter_otlp_headers EXPORTER_OTLP_HEADERS]
                                [--exporter_otlp_insecure EXPORTER_OTLP_INSECURE]
                                [--exporter_otlp_logs_certificate EXPORTER_OTLP_LOGS_CERTIFICATE]
                                [--exporter_otlp_logs_client_certificate EXPORTER_OTLP_LOGS_CLIENT_CERTIFICATE]
                                [--exporter_otlp_logs_client_key EXPORTER_OTLP_LOGS_CLIENT_KEY]
                                [--exporter_otlp_logs_compression EXPORTER_OTLP_LOGS_COMPRESSION]
                                [--exporter_otlp_logs_endpoint EXPORTER_OTLP_LOGS_ENDPOINT]
                                [--exporter_otlp_logs_headers EXPORTER_OTLP_LOGS_HEADERS]
                                [--exporter_otlp_logs_insecure EXPORTER_OTLP_LOGS_INSECURE]
                                [--exporter_otlp_logs_protocol EXPORTER_OTLP_LOGS_PROTOCOL]
                                [--exporter_otlp_logs_timeout EXPORTER_OTLP_LOGS_TIMEOUT]
                                [--exporter_otlp_metrics_certificate EXPORTER_OTLP_METRICS_CERTIFICATE]
                                [--exporter_otlp_metrics_client_certificate EXPORTER_OTLP_METRICS_CLIENT_CERTIFICATE]
                                [--exporter_otlp_metrics_client_key EXPORTER_OTLP_METRICS_CLIENT_KEY]
                                [--exporter_otlp_metrics_compression EXPORTER_OTLP_METRICS_COMPRESSION]
                                [--exporter_otlp_metrics_default_histogram_aggregation EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION]
                                [--exporter_otlp_metrics_endpoint EXPORTER_OTLP_METRICS_ENDPOINT]
                                [--exporter_otlp_metrics_headers EXPORTER_OTLP_METRICS_HEADERS]
                                [--exporter_otlp_metrics_insecure EXPORTER_OTLP_METRICS_INSECURE]
                                [--exporter_otlp_metrics_protocol EXPORTER_OTLP_METRICS_PROTOCOL]
                                [--exporter_otlp_metrics_temporality_preference EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE]
                                [--exporter_otlp_metrics_timeout EXPORTER_OTLP_METRICS_TIMEOUT]
                                [--exporter_otlp_protocol EXPORTER_OTLP_PROTOCOL]
                                [--exporter_otlp_timeout EXPORTER_OTLP_TIMEOUT]
                                [--exporter_otlp_traces_certificate EXPORTER_OTLP_TRACES_CERTIFICATE]
                                [--exporter_otlp_traces_client_certificate EXPORTER_OTLP_TRACES_CLIENT_CERTIFICATE]
                                [--exporter_otlp_traces_client_key EXPORTER_OTLP_TRACES_CLIENT_KEY]
                                [--exporter_otlp_traces_compression EXPORTER_OTLP_TRACES_COMPRESSION]
                                [--exporter_otlp_traces_endpoint EXPORTER_OTLP_TRACES_ENDPOINT]
                                [--exporter_otlp_traces_headers EXPORTER_OTLP_TRACES_HEADERS]
                                [--exporter_otlp_traces_insecure EXPORTER_OTLP_TRACES_INSECURE]
                                [--exporter_otlp_traces_protocol EXPORTER_OTLP_TRACES_PROTOCOL]
                                [--exporter_otlp_traces_timeout EXPORTER_OTLP_TRACES_TIMEOUT]
                                [--exporter_prometheus_host EXPORTER_PROMETHEUS_HOST]
                                [--exporter_prometheus_port EXPORTER_PROMETHEUS_PORT]
                                [--exporter_zipkin_endpoint EXPORTER_ZIPKIN_ENDPOINT]
                                [--exporter_zipkin_timeout EXPORTER_ZIPKIN_TIMEOUT]
                                [--link_attribute_count_limit LINK_ATTRIBUTE_COUNT_LIMIT]
                                [--logrecord_attribute_count_limit LOGRECORD_ATTRIBUTE_COUNT_LIMIT]
                                [--logrecord_attribute_value_length_limit LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT]
                                [--log_level LOG_LEVEL]
                                [--metrics_exemplar_filter METRICS_EXEMPLAR_FILTER]
                                [--metric_export_interval METRIC_EXPORT_INTERVAL]
                                [--metric_export_timeout METRIC_EXPORT_TIMEOUT]
                                [--logger_configurator LOGGER_CONFIGURATOR]
                                [--meter_configurator METER_CONFIGURATOR]
                                [--sdk_internal_metrics_enabled SDK_INTERNAL_METRICS_ENABLED]
                                [--tracer_configurator TRACER_CONFIGURATOR]
                                [--resource_attributes RESOURCE_ATTRIBUTES]
                                [--sdk_disabled SDK_DISABLED] [--service_name SERVICE_NAME]
                                [--span_attribute_count_limit SPAN_ATTRIBUTE_COUNT_LIMIT]
                                [--span_attribute_value_length_limit SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT]
                                [--span_event_count_limit SPAN_EVENT_COUNT_LIMIT]
                                [--span_link_count_limit SPAN_LINK_COUNT_LIMIT]
                                [--traces_sampler TRACES_SAMPLER]
                                [--traces_sampler_arg TRACES_SAMPLER_ARG]
                                [--auto_instrumentation_experimental_gevent_patch AUTO_INSTRUMENTATION_EXPERIMENTAL_GEVENT_PATCH]
                                [--configurator CONFIGURATOR]
                                [--disabled_instrumentations DISABLED_INSTRUMENTATIONS]
                                [--distro DISTRO]
                                [--semconv_stability_opt_in SEMCONV_STABILITY_OPT_IN]
                                [--exporter_gcp_trace_project_id EXPORTER_GCP_TRACE_PROJECT_ID]
                                [--exporter_gcp_trace_resource_regex EXPORTER_GCP_TRACE_RESOURCE_REGEX]
                                [--logs_exporter LOGS_EXPORTER]
                                [--metrics_exporter METRICS_EXPORTER] [--propagators PROPAGATORS]
                                [--context CONTEXT] [--id_generator ID_GENERATOR]
                                [--meter_provider METER_PROVIDER]
                                [--tracer_provider TRACER_PROVIDER]
                                [--traces_exporter TRACES_EXPORTER] [--version]
                                command ...

opentelemetry-instrument automatically instruments a Python program and its dependencies and then
runs the program.

positional arguments:
  command               Your Python application.
  command_args          Arguments for your application.

options:
  -h, --help            show this help message and exit
  --attribute_count_limit ATTRIBUTE_COUNT_LIMIT
  --attribute_value_length_limit ATTRIBUTE_VALUE_LENGTH_LIMIT
  --blrp_export_timeout BLRP_EXPORT_TIMEOUT
  --blrp_max_export_batch_size BLRP_MAX_EXPORT_BATCH_SIZE
  --blrp_max_queue_size BLRP_MAX_QUEUE_SIZE
  --blrp_schedule_delay BLRP_SCHEDULE_DELAY
  --bsp_export_timeout BSP_EXPORT_TIMEOUT
  --bsp_max_export_batch_size BSP_MAX_EXPORT_BATCH_SIZE
  --bsp_max_queue_size BSP_MAX_QUEUE_SIZE
  --bsp_schedule_delay BSP_SCHEDULE_DELAY
  --config_file CONFIG_FILE
  --event_attribute_count_limit EVENT_ATTRIBUTE_COUNT_LIMIT
  --experimental_resource_detectors EXPERIMENTAL_RESOURCE_DETECTORS
  --exporter_otlp_certificate EXPORTER_OTLP_CERTIFICATE
  --exporter_otlp_client_certificate EXPORTER_OTLP_CLIENT_CERTIFICATE
  --exporter_otlp_client_key EXPORTER_OTLP_CLIENT_KEY
  --exporter_otlp_compression EXPORTER_OTLP_COMPRESSION
  --exporter_otlp_endpoint EXPORTER_OTLP_ENDPOINT
  --exporter_otlp_headers EXPORTER_OTLP_HEADERS
  --exporter_otlp_insecure EXPORTER_OTLP_INSECURE
  --exporter_otlp_logs_certificate EXPORTER_OTLP_LOGS_CERTIFICATE
  --exporter_otlp_logs_client_certificate EXPORTER_OTLP_LOGS_CLIENT_CERTIFICATE
  --exporter_otlp_logs_client_key EXPORTER_OTLP_LOGS_CLIENT_KEY
  --exporter_otlp_logs_compression EXPORTER_OTLP_LOGS_COMPRESSION
  --exporter_otlp_logs_endpoint EXPORTER_OTLP_LOGS_ENDPOINT
  --exporter_otlp_logs_headers EXPORTER_OTLP_LOGS_HEADERS
  --exporter_otlp_logs_insecure EXPORTER_OTLP_LOGS_INSECURE
  --exporter_otlp_logs_protocol EXPORTER_OTLP_LOGS_PROTOCOL
  --exporter_otlp_logs_timeout EXPORTER_OTLP_LOGS_TIMEOUT
  --exporter_otlp_metrics_certificate EXPORTER_OTLP_METRICS_CERTIFICATE
  --exporter_otlp_metrics_client_certificate EXPORTER_OTLP_METRICS_CLIENT_CERTIFICATE
  --exporter_otlp_metrics_client_key EXPORTER_OTLP_METRICS_CLIENT_KEY
  --exporter_otlp_metrics_compression EXPORTER_OTLP_METRICS_COMPRESSION
  --exporter_otlp_metrics_default_histogram_aggregation EXPORTER_OTLP_METRICS_DEFAULT_HISTOGRAM_AGGREGATION
  --exporter_otlp_metrics_endpoint EXPORTER_OTLP_METRICS_ENDPOINT
  --exporter_otlp_metrics_headers EXPORTER_OTLP_METRICS_HEADERS
  --exporter_otlp_metrics_insecure EXPORTER_OTLP_METRICS_INSECURE
  --exporter_otlp_metrics_protocol EXPORTER_OTLP_METRICS_PROTOCOL
  --exporter_otlp_metrics_temporality_preference EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE
  --exporter_otlp_metrics_timeout EXPORTER_OTLP_METRICS_TIMEOUT
  --exporter_otlp_protocol EXPORTER_OTLP_PROTOCOL
  --exporter_otlp_timeout EXPORTER_OTLP_TIMEOUT
  --exporter_otlp_traces_certificate EXPORTER_OTLP_TRACES_CERTIFICATE
  --exporter_otlp_traces_client_certificate EXPORTER_OTLP_TRACES_CLIENT_CERTIFICATE
  --exporter_otlp_traces_client_key EXPORTER_OTLP_TRACES_CLIENT_KEY
  --exporter_otlp_traces_compression EXPORTER_OTLP_TRACES_COMPRESSION
  --exporter_otlp_traces_endpoint EXPORTER_OTLP_TRACES_ENDPOINT
  --exporter_otlp_traces_headers EXPORTER_OTLP_TRACES_HEADERS
  --exporter_otlp_traces_insecure EXPORTER_OTLP_TRACES_INSECURE
  --exporter_otlp_traces_protocol EXPORTER_OTLP_TRACES_PROTOCOL
  --exporter_otlp_traces_timeout EXPORTER_OTLP_TRACES_TIMEOUT
  --exporter_prometheus_host EXPORTER_PROMETHEUS_HOST
  --exporter_prometheus_port EXPORTER_PROMETHEUS_PORT
  --exporter_zipkin_endpoint EXPORTER_ZIPKIN_ENDPOINT
  --exporter_zipkin_timeout EXPORTER_ZIPKIN_TIMEOUT
  --link_attribute_count_limit LINK_ATTRIBUTE_COUNT_LIMIT
  --logrecord_attribute_count_limit LOGRECORD_ATTRIBUTE_COUNT_LIMIT
  --logrecord_attribute_value_length_limit LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT
  --log_level LOG_LEVEL
  --metrics_exemplar_filter METRICS_EXEMPLAR_FILTER
  --metric_export_interval METRIC_EXPORT_INTERVAL
  --metric_export_timeout METRIC_EXPORT_TIMEOUT
  --logger_configurator LOGGER_CONFIGURATOR
  --meter_configurator METER_CONFIGURATOR
  --sdk_internal_metrics_enabled SDK_INTERNAL_METRICS_ENABLED
  --tracer_configurator TRACER_CONFIGURATOR
  --resource_attributes RESOURCE_ATTRIBUTES
  --sdk_disabled SDK_DISABLED
  --service_name SERVICE_NAME
  --span_attribute_count_limit SPAN_ATTRIBUTE_COUNT_LIMIT
  --span_attribute_value_length_limit SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT
  --span_event_count_limit SPAN_EVENT_COUNT_LIMIT
  --span_link_count_limit SPAN_LINK_COUNT_LIMIT
  --traces_sampler TRACES_SAMPLER
  --traces_sampler_arg TRACES_SAMPLER_ARG
  --auto_instrumentation_experimental_gevent_patch AUTO_INSTRUMENTATION_EXPERIMENTAL_GEVENT_PATCH
  --configurator CONFIGURATOR
  --disabled_instrumentations DISABLED_INSTRUMENTATIONS
  --distro DISTRO
  --semconv_stability_opt_in SEMCONV_STABILITY_OPT_IN
  --exporter_gcp_trace_project_id EXPORTER_GCP_TRACE_PROJECT_ID
  --exporter_gcp_trace_resource_regex EXPORTER_GCP_TRACE_RESOURCE_REGEX
  --logs_exporter LOGS_EXPORTER
  --metrics_exporter METRICS_EXPORTER
  --propagators PROPAGATORS
  --context CONTEXT
  --id_generator ID_GENERATOR
  --meter_provider METER_PROVIDER
  --tracer_provider TRACER_PROVIDER
  --traces_exporter TRACES_EXPORTER
  --version             print version information

Optional arguments (except for --help and --version) for opentelemetry-instrument directly
correspond with OpenTelemetry environment variables. The corresponding optional argument is formed
by removing the OTEL_ or OTEL_PYTHON_ prefix from the environment variable and lower casing the
rest. For example, the optional argument --attribute_value_length_limit corresponds with the
environment variable OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT. These optional arguments will override the
current value of the corresponding environment variable during the execution of the command.
Options (92)
OptionDescriptionSource
-h, --helpshow this help message and exithelp
--attribute_count_limit ATTRIBUTE_COUNT_LIMIThelp
--attribute_value_length_limit ATTRIBUTE_VALUE_LENGTH_LIMIThelp
--blrp_export_timeout BLRP_EXPORT_TIMEOUThelp
--blrp_max_export_batch_size BLRP_MAX_EXPORT_BATCH_SIZEhelp
--blrp_max_queue_size BLRP_MAX_QUEUE_SIZEhelp
--blrp_schedule_delay BLRP_SCHEDULE_DELAYhelp
--bsp_export_timeout BSP_EXPORT_TIMEOUThelp
--bsp_max_export_batch_size BSP_MAX_EXPORT_BATCH_SIZEhelp
--bsp_max_queue_size BSP_MAX_QUEUE_SIZEhelp
--bsp_schedule_delay BSP_SCHEDULE_DELAYhelp
--config_file CONFIG_FILEhelp
--event_attribute_count_limit EVENT_ATTRIBUTE_COUNT_LIMIThelp
--experimental_resource_detectors EXPERIMENTAL_RESOURCE_DETECTORShelp
--exporter_otlp_certificate EXPORTER_OTLP_CERTIFICATEhelp
--exporter_otlp_client_certificate EXPORTER_OTLP_CLIENT_CERTIFICATEhelp
--exporter_otlp_client_key EXPORTER_OTLP_CLIENT_KEYhelp
--exporter_otlp_compression EXPORTER_OTLP_COMPRESSIONhelp
--exporter_otlp_endpoint EXPORTER_OTLP_ENDPOINThelp
--exporter_otlp_headers EXPORTER_OTLP_HEADERShelp
--exporter_otlp_insecure EXPORTER_OTLP_INSECUREhelp
--exporter_otlp_logs_certificate EXPORTER_OTLP_LOGS_CERTIFICATEhelp
--exporter_otlp_logs_client_certificate EXPORTER_OTLP_LOGS_CLIENT_CERTIFICATEhelp
--exporter_otlp_logs_client_key EXPORTER_OTLP_LOGS_CLIENT_KEYhelp
--exporter_otlp_logs_compression EXPORTER_OTLP_LOGS_COMPRESSIONhelp
--exporter_otlp_logs_endpoint EXPORTER_OTLP_LOGS_ENDPOINThelp
--exporter_otlp_logs_headers EXPORTER_OTLP_LOGS_HEADERShelp
--exporter_otlp_logs_insecure EXPORTER_OTLP_LOGS_INSECUREhelp
--exporter_otlp_logs_protocol EXPORTER_OTLP_LOGS_PROTOCOLhelp
--exporter_otlp_logs_timeout EXPORTER_OTLP_LOGS_TIMEOUThelp
--exporter_otlp_metrics_certificate EXPORTER_OTLP_METRICS_CERTIFICATEhelp
--exporter_otlp_metrics_client_certificate EXPORTER_OTLP_METRICS_CLIENT_CERTIFICATEhelp
--exporter_otlp_metrics_client_key EXPORTER_OTLP_METRICS_CLIENT_KEYhelp
--exporter_otlp_metrics_compression EXPORTER_OTLP_METRICS_COMPRESSIONhelp
--exporter_otlp_metrics_default_histogram_aggregationhelp
--exporter_otlp_metrics_endpoint EXPORTER_OTLP_METRICS_ENDPOINThelp
--exporter_otlp_metrics_headers EXPORTER_OTLP_METRICS_HEADERShelp
--exporter_otlp_metrics_insecure EXPORTER_OTLP_METRICS_INSECUREhelp
--exporter_otlp_metrics_protocol EXPORTER_OTLP_METRICS_PROTOCOLhelp
--exporter_otlp_metrics_temporality_preferencehelp
--exporter_otlp_metrics_timeout EXPORTER_OTLP_METRICS_TIMEOUThelp
--exporter_otlp_protocol EXPORTER_OTLP_PROTOCOLhelp
--exporter_otlp_timeout EXPORTER_OTLP_TIMEOUThelp
--exporter_otlp_traces_certificate EXPORTER_OTLP_TRACES_CERTIFICATEhelp
--exporter_otlp_traces_client_certificate EXPORTER_OTLP_TRACES_CLIENT_CERTIFICATEhelp
--exporter_otlp_traces_client_key EXPORTER_OTLP_TRACES_CLIENT_KEYhelp
--exporter_otlp_traces_compression EXPORTER_OTLP_TRACES_COMPRESSIONhelp
--exporter_otlp_traces_endpoint EXPORTER_OTLP_TRACES_ENDPOINThelp
--exporter_otlp_traces_headers EXPORTER_OTLP_TRACES_HEADERShelp
--exporter_otlp_traces_insecure EXPORTER_OTLP_TRACES_INSECUREhelp
--exporter_otlp_traces_protocol EXPORTER_OTLP_TRACES_PROTOCOLhelp
--exporter_otlp_traces_timeout EXPORTER_OTLP_TRACES_TIMEOUThelp
--exporter_prometheus_host EXPORTER_PROMETHEUS_HOSThelp
--exporter_prometheus_port EXPORTER_PROMETHEUS_PORThelp
--exporter_zipkin_endpoint EXPORTER_ZIPKIN_ENDPOINThelp
--exporter_zipkin_timeout EXPORTER_ZIPKIN_TIMEOUThelp
--link_attribute_count_limit LINK_ATTRIBUTE_COUNT_LIMIThelp
--logrecord_attribute_count_limit LOGRECORD_ATTRIBUTE_COUNT_LIMIThelp
--logrecord_attribute_value_length_limit LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIThelp
--log_level LOG_LEVELhelp
--metrics_exemplar_filter METRICS_EXEMPLAR_FILTERhelp
--metric_export_interval METRIC_EXPORT_INTERVALhelp
--metric_export_timeout METRIC_EXPORT_TIMEOUThelp
--logger_configurator LOGGER_CONFIGURATORhelp
--meter_configurator METER_CONFIGURATORhelp
--sdk_internal_metrics_enabled SDK_INTERNAL_METRICS_ENABLEDhelp
--tracer_configurator TRACER_CONFIGURATORhelp
--resource_attributes RESOURCE_ATTRIBUTEShelp
--sdk_disabled SDK_DISABLEDhelp
--service_name SERVICE_NAMEhelp
--span_attribute_count_limit SPAN_ATTRIBUTE_COUNT_LIMIThelp
--span_attribute_value_length_limit SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIThelp
--span_event_count_limit SPAN_EVENT_COUNT_LIMIThelp
--span_link_count_limit SPAN_LINK_COUNT_LIMIThelp
--traces_sampler TRACES_SAMPLERhelp
--traces_sampler_arg TRACES_SAMPLER_ARGhelp
--auto_instrumentation_experimental_gevent_patchhelp
--configurator CONFIGURATORhelp
--disabled_instrumentations DISABLED_INSTRUMENTATIONShelp
--distro DISTROhelp
--semconv_stability_opt_in SEMCONV_STABILITY_OPT_INhelp
--exporter_gcp_trace_project_id EXPORTER_GCP_TRACE_PROJECT_IDhelp
--exporter_gcp_trace_resource_regex EXPORTER_GCP_TRACE_RESOURCE_REGEXhelp
--logs_exporter LOGS_EXPORTERhelp
--metrics_exporter METRICS_EXPORTERhelp
--propagators PROPAGATORShelp
--context CONTEXThelp
--id_generator ID_GENERATORhelp
--meter_provider METER_PROVIDERhelp
--tracer_provider TRACER_PROVIDERhelp
--traces_exporter TRACES_EXPORTERhelp
--versionprint version informationhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.