sentry-sdk 0.7.5__py2.py3-none-any.whl → 2.46.0__py2.py3-none-any.whl

sentry_sdk/consts.py

@@ -1,79 +1,1451 @@
-import socket
+import itertools
+from enum import Enum
+from typing import TYPE_CHECKING
+
+# up top to prevent circular import due to integration import
+# This is more or less an arbitrary large-ish value for now, so that we allow
+# pretty long strings (like LLM prompts), but still have *some* upper limit
+# until we verify that removing the trimming completely is safe.
+DEFAULT_MAX_VALUE_LENGTH = 100_000
+
+DEFAULT_MAX_STACK_FRAMES = 100
+DEFAULT_ADD_FULL_STACK = False
+
+
+# Also needs to be at the top to prevent circular import
+class EndpointType(Enum):
+    """
+    The type of an endpoint. This is an enum, rather than a constant, for historical reasons
+    (the old /store endpoint). The enum also preserve future compatibility, in case we ever
+    have a new endpoint.
+    """
+
+    ENVELOPE = "envelope"
+    OTLP_TRACES = "integration/otlp/v1/traces"
+
+
+class CompressionAlgo(Enum):
+    GZIP = "gzip"
+    BROTLI = "br"
+
+
+if TYPE_CHECKING:
+    import sentry_sdk
 
-if False:
-    from mypy_extensions import TypedDict
     from typing import Optional
     from typing import Callable
     from typing import Union
     from typing import List
+    from typing import Type
+    from typing import Dict
+    from typing import Any
+    from typing import Sequence
+    from typing import Tuple
+    from typing import AbstractSet
+    from typing_extensions import Literal
+    from typing_extensions import TypedDict
 
-    from sentry_sdk.transport import Transport
-    from sentry_sdk.integrations import Integration
+    from sentry_sdk._types import (
+        BreadcrumbProcessor,
+        ContinuousProfilerMode,
+        Event,
+        EventProcessor,
+        Hint,
+        Log,
+        MeasurementUnit,
+        Metric,
+        ProfilerMode,
+        TracesSampler,
+        TransactionProcessor,
+    )
 
-    ClientOptions = TypedDict(
-        "ClientOptions",
+    # Experiments are feature flags to enable and disable certain unstable SDK
+    # functionality. Changing them from the defaults (`None`) in production
+    # code is highly discouraged. They are not subject to any stability
+    # guarantees such as the ones from semantic versioning.
+    Experiments = TypedDict(
+        "Experiments",
         {
-            "dsn": Optional[str],
-            "with_locals": bool,
-            "max_breadcrumbs": int,
-            "release": Optional[str],
-            "environment": Optional[str],
-            "server_name": Optional[str],
-            "shutdown_timeout": int,
-            "integrations": List[Integration],
-            "in_app_include": List[str],
-            "in_app_exclude": List[str],
-            "default_integrations": bool,
-            "dist": Optional[str],
-            "transport": Optional[Union[Transport, type, Callable]],
-            "sample_rate": int,
-            "send_default_pii": bool,
-            "http_proxy": Optional[str],
-            "https_proxy": Optional[str],
-            "ignore_errors": List[type],
-            "request_bodies": str,
-            "before_send": Optional[Callable],
-            "before_breadcrumb": Optional[Callable],
-            "debug": bool,
-            "attach_stacktrace": bool,
-            "ca_certs": Optional[str],
+            "max_spans": Optional[int],
+            "max_flags": Optional[int],
+            "record_sql_params": Optional[bool],
+            "continuous_profiling_auto_start": Optional[bool],
+            "continuous_profiling_mode": Optional[ContinuousProfilerMode],
+            "otel_powered_performance": Optional[bool],
+            "transport_zlib_compression_level": Optional[int],
+            "transport_compression_level": Optional[int],
+            "transport_compression_algo": Optional[CompressionAlgo],
+            "transport_num_pools": Optional[int],
+            "transport_http2": Optional[bool],
+            "enable_logs": Optional[bool],
+            "before_send_log": Optional[Callable[[Log, Hint], Optional[Log]]],
+            "enable_metrics": Optional[bool],
+            "before_send_metric": Optional[Callable[[Metric, Hint], Optional[Metric]]],
         },
         total=False,
     )
 
+DEFAULT_QUEUE_SIZE = 100
+DEFAULT_MAX_BREADCRUMBS = 100
+MATCH_ALL = r".*"
+
+FALSE_VALUES = [
+    "false",
+    "no",
+    "off",
+    "n",
+    "0",
+]
+
+
+class SPANTEMPLATE(str, Enum):
+    DEFAULT = "default"
+    AI_AGENT = "ai_agent"
+    AI_TOOL = "ai_tool"
+    AI_CHAT = "ai_chat"
+
+    def __str__(self):
+        # type: () -> str
+        return self.value
+
+
+class INSTRUMENTER:
+    SENTRY = "sentry"
+    OTEL = "otel"
+
+
+class SPANDATA:
+    """
+    Additional information describing the type of the span.
+    See: https://develop.sentry.dev/sdk/performance/span-data-conventions/
+    """
+
+    AI_CITATIONS = "ai.citations"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    References or sources cited by the AI model in its response.
+    Example: ["Smith et al. 2020", "Jones 2019"]
+    """
+
+    AI_DOCUMENTS = "ai.documents"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Documents or content chunks used as context for the AI model.
+    Example: ["doc1.txt", "doc2.pdf"]
+    """
+
+    AI_FINISH_REASON = "ai.finish_reason"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_RESPONSE_FINISH_REASONS instead.
+
+    The reason why the model stopped generating.
+    Example: "length"
+    """
+
+    AI_FREQUENCY_PENALTY = "ai.frequency_penalty"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_FREQUENCY_PENALTY instead.
+
+    Used to reduce repetitiveness of generated tokens.
+    Example: 0.5
+    """
+
+    AI_FUNCTION_CALL = "ai.function_call"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_RESPONSE_TOOL_CALLS instead.
+
+    For an AI model call, the function that was called. This is deprecated for OpenAI, and replaced by tool_calls
+    """
+
+    AI_GENERATION_ID = "ai.generation_id"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_RESPONSE_ID instead.
+
+    Unique identifier for the completion.
+    Example: "gen_123abc"
+    """
+
+    AI_INPUT_MESSAGES = "ai.input_messages"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_MESSAGES instead.
+
+    The input messages to an LLM call.
+    Example: [{"role": "user", "message": "hello"}]
+    """
+
+    AI_LOGIT_BIAS = "ai.logit_bias"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    For an AI model call, the logit bias
+    """
+
+    AI_METADATA = "ai.metadata"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Extra metadata passed to an AI pipeline step.
+    Example: {"executed_function": "add_integers"}
+    """
+
+    AI_MODEL_ID = "ai.model_id"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_MODEL or GEN_AI_RESPONSE_MODEL instead.
+
+    The unique descriptor of the model being executed.
+    Example: gpt-4
+    """
+
+    AI_PIPELINE_NAME = "ai.pipeline.name"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_PIPELINE_NAME instead.
+
+    Name of the AI pipeline or chain being executed.
+    Example: "qa-pipeline"
+    """
+
+    AI_PREAMBLE = "ai.preamble"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    For an AI model call, the preamble parameter.
+    Preambles are a part of the prompt used to adjust the model's overall behavior and conversation style.
+    Example: "You are now a clown."
+    """
+
+    AI_PRESENCE_PENALTY = "ai.presence_penalty"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_PRESENCE_PENALTY instead.
+
+    Used to reduce repetitiveness of generated tokens.
+    Example: 0.5
+    """
+
+    AI_RAW_PROMPTING = "ai.raw_prompting"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Minimize pre-processing done to the prompt sent to the LLM.
+    Example: true
+    """
+
+    AI_RESPONSE_FORMAT = "ai.response_format"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    For an AI model call, the format of the response
+    """
+
+    AI_RESPONSES = "ai.responses"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_RESPONSE_TEXT instead.
+
+    The responses to an AI model call. Always as a list.
+    Example: ["hello", "world"]
+    """
+
+    AI_SEARCH_QUERIES = "ai.search_queries"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Queries used to search for relevant context or documents.
+    Example: ["climate change effects", "renewable energy"]
+    """
+
+    AI_SEARCH_REQUIRED = "ai.is_search_required"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Boolean indicating if the model needs to perform a search.
+    Example: true
+    """
+
+    AI_SEARCH_RESULTS = "ai.search_results"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Results returned from search queries for context.
+    Example: ["Result 1", "Result 2"]
+    """
+
+    AI_SEED = "ai.seed"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_SEED instead.
+
+    The seed, ideally models given the same seed and same other parameters will produce the exact same output.
+    Example: 123.45
+    """
+
+    AI_STREAMING = "ai.streaming"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_RESPONSE_STREAMING instead.
+
+    Whether or not the AI model call's response was streamed back asynchronously
+    Example: true
+    """
+
+    AI_TAGS = "ai.tags"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Tags that describe an AI pipeline step.
+    Example: {"executed_function": "add_integers"}
+    """
+
+    AI_TEMPERATURE = "ai.temperature"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_TEMPERATURE instead.
+
+    For an AI model call, the temperature parameter. Temperature essentially means how random the output will be.
+    Example: 0.5
+    """
+
+    AI_TEXTS = "ai.texts"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Raw text inputs provided to the model.
+    Example: ["What is machine learning?"]
+    """
+
+    AI_TOP_K = "ai.top_k"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_TOP_K instead.
+
+    For an AI model call, the top_k parameter. Top_k essentially controls how random the output will be.
+    Example: 35
+    """
+
+    AI_TOP_P = "ai.top_p"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_TOP_P instead.
+
+    For an AI model call, the top_p parameter. Top_p essentially controls how random the output will be.
+    Example: 0.5
+    """
+
+    AI_TOOL_CALLS = "ai.tool_calls"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_RESPONSE_TOOL_CALLS instead.
+
+    For an AI model call, the function that was called. This is deprecated for OpenAI, and replaced by tool_calls
+    """
+
+    AI_TOOLS = "ai.tools"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_REQUEST_AVAILABLE_TOOLS instead.
+
+    For an AI model call, the functions that are available
+    """
+
+    AI_WARNINGS = "ai.warnings"
+    """
+    .. deprecated::
+        This attribute is deprecated. Use GEN_AI_* attributes instead.
+
+    Warning messages generated during model execution.
+    Example: ["Token limit exceeded"]
+    """
+
+    CACHE_HIT = "cache.hit"
+    """
+    A boolean indicating whether the requested data was found in the cache.
+    Example: true
+    """
+
+    CACHE_ITEM_SIZE = "cache.item_size"
+    """
+    The size of the requested data in bytes.
+    Example: 58
+    """
+
+    CACHE_KEY = "cache.key"
+    """
+    The key of the requested data.
+    Example: template.cache.some_item.867da7e2af8e6b2f3aa7213a4080edb3
+    """
+
+    CODE_FILEPATH = "code.filepath"
+    """
+    The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path).
+    Example: "/app/myapplication/http/handler/server.py"
+    """
+
+    CODE_FUNCTION = "code.function"
+    """
+    The method or function name, or equivalent (usually rightmost part of the code unit's name).
+    Example: "server_request"
+    """
+
+    CODE_LINENO = "code.lineno"
+    """
+    The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`.
+    Example: 42
+    """
+
+    CODE_NAMESPACE = "code.namespace"
+    """
+    The "namespace" within which `code.function` is defined. Usually the qualified class or module name, such that `code.namespace` + some separator + `code.function` form a unique identifier for the code unit.
+    Example: "http.handler"
+    """
+
+    DB_MONGODB_COLLECTION = "db.mongodb.collection"
+    """
+    The MongoDB collection being accessed within the database.
+    See: https://github.com/open-telemetry/semantic-conventions/blob/main/docs/database/mongodb.md#attributes
+    Example: public.users; customers
+    """
+
+    DB_NAME = "db.name"
+    """
+    The name of the database being accessed. For commands that switch the database, this should be set to the target database (even if the command fails).
+    Example: myDatabase
+    """
+
+    DB_OPERATION = "db.operation"
+    """
+    The name of the operation being executed, e.g. the MongoDB command name such as findAndModify, or the SQL keyword.
+    See: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/semantic_conventions/database.md
+    Example: findAndModify, HMSET, SELECT
+    """
+
+    DB_SYSTEM = "db.system"
+    """
+    An identifier for the database management system (DBMS) product being used.
+    See: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/semantic_conventions/database.md
+    Example: postgresql
+    """
+
+    DB_USER = "db.user"
+    """
+    The name of the database user used for connecting to the database.
+    See: https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/semantic_conventions/database.md
+    Example: my_user
+    """
+
+    GEN_AI_AGENT_NAME = "gen_ai.agent.name"
+    """
+    The name of the agent being used.
+    Example: "ResearchAssistant"
+    """
+
+    GEN_AI_CHOICE = "gen_ai.choice"
+    """
+    The model's response message.
+    Example: "The weather in Paris is rainy and overcast, with temperatures around 57°F"
+    """
+
+    GEN_AI_EMBEDDINGS_INPUT = "gen_ai.embeddings.input"
+    """
+    The input to the embeddings operation.
+    Example: "Hello!"
+    """
+
+    GEN_AI_OPERATION_NAME = "gen_ai.operation.name"
+    """
+    The name of the operation being performed.
+    Example: "chat"
+    """
+
+    GEN_AI_PIPELINE_NAME = "gen_ai.pipeline.name"
+    """
+    Name of the AI pipeline or chain being executed.
+    Example: "qa-pipeline"
+    """
+
+    GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons"
+    """
+    The reason why the model stopped generating.
+    Example: "COMPLETE"
+    """
+
+    GEN_AI_RESPONSE_ID = "gen_ai.response.id"
+    """
+    Unique identifier for the completion.
+    Example: "gen_123abc"
+    """
+
+    GEN_AI_RESPONSE_MODEL = "gen_ai.response.model"
+    """
+    Exact model identifier used to generate the response
+    Example: gpt-4o-mini-2024-07-18
+    """
+
+    GEN_AI_RESPONSE_STREAMING = "gen_ai.response.streaming"
+    """
+    Whether or not the AI model call's response was streamed back asynchronously
+    Example: true
+    """
+
+    GEN_AI_RESPONSE_TEXT = "gen_ai.response.text"
+    """
+    The model's response text messages.
+    Example: ["The weather in Paris is rainy and overcast, with temperatures around 57°F", "The weather in London is sunny and warm, with temperatures around 65°F"]
+    """
+
+    GEN_AI_RESPONSE_TOOL_CALLS = "gen_ai.response.tool_calls"
+    """
+    The tool calls in the model's response.
+    Example: [{"name": "get_weather", "arguments": {"location": "Paris"}}]
+    """
+
+    GEN_AI_REQUEST_AVAILABLE_TOOLS = "gen_ai.request.available_tools"
+    """
+    The available tools for the model.
+    Example: [{"name": "get_weather", "description": "Get the weather for a given location"}, {"name": "get_news", "description": "Get the news for a given topic"}]
+    """
+
+    GEN_AI_REQUEST_FREQUENCY_PENALTY = "gen_ai.request.frequency_penalty"
+    """
+    The frequency penalty parameter used to reduce repetitiveness of generated tokens.
+    Example: 0.1
+    """
+
+    GEN_AI_REQUEST_MAX_TOKENS = "gen_ai.request.max_tokens"
+    """
+    The maximum number of tokens to generate in the response.
+    Example: 2048
+    """
+
+    GEN_AI_REQUEST_MESSAGES = "gen_ai.request.messages"
+    """
+    The messages passed to the model. The "content" can be a string or an array of objects.
+    Example: [{role: "system", "content: "Generate a random number."}, {"role": "user", "content": [{"text": "Generate a random number between 0 and 10.", "type": "text"}]}]
+    """
+
+    GEN_AI_REQUEST_MODEL = "gen_ai.request.model"
+    """
+    The model identifier being used for the request.
+    Example: "gpt-4-turbo"
+    """
+
+    GEN_AI_REQUEST_PRESENCE_PENALTY = "gen_ai.request.presence_penalty"
+    """
+    The presence penalty parameter used to reduce repetitiveness of generated tokens.
+    Example: 0.1
+    """
+
+    GEN_AI_REQUEST_SEED = "gen_ai.request.seed"
+    """
+    The seed, ideally models given the same seed and same other parameters will produce the exact same output.
+    Example: "1234567890"
+    """
+
+    GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature"
+    """
+    The temperature parameter used to control randomness in the output.
+    Example: 0.7
+    """
+
+    GEN_AI_REQUEST_TOP_K = "gen_ai.request.top_k"
+    """
+    Limits the model to only consider the K most likely next tokens, where K is an integer (e.g., top_k=20 means only the 20 highest probability tokens are considered).
+    Example: 35
+    """
+
+    GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p"
+    """
+    The top_p parameter used to control diversity via nucleus sampling.
+    Example: 1.0
+    """
+
+    GEN_AI_SYSTEM = "gen_ai.system"
+    """
+    The name of the AI system being used.
+    Example: "openai"
+    """
+
+    GEN_AI_TOOL_DESCRIPTION = "gen_ai.tool.description"
+    """
+    The description of the tool being used.
+    Example: "Searches the web for current information about a topic"
+    """
+
+    GEN_AI_TOOL_INPUT = "gen_ai.tool.input"
+    """
+    The input of the tool being used.
+    Example: {"location": "Paris"}
+    """
+
+    GEN_AI_TOOL_NAME = "gen_ai.tool.name"
+    """
+    The name of the tool being used.
+    Example: "web_search"
+    """
+
+    GEN_AI_TOOL_OUTPUT = "gen_ai.tool.output"
+    """
+    The output of the tool being used.
+    Example: "rainy, 57°F"
+    """
+
+    GEN_AI_TOOL_TYPE = "gen_ai.tool.type"
+    """
+    The type of tool being used.
+    Example: "function"
+    """
+
+    GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens"
+    """
+    The number of tokens in the input.
+    Example: 150
+    """
+
+    GEN_AI_USAGE_INPUT_TOKENS_CACHED = "gen_ai.usage.input_tokens.cached"
+    """
+    The number of cached tokens in the input.
+    Example: 50
+    """
+
+    GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens"
+    """
+    The number of tokens in the output.
+    Example: 250
+    """
+
+    GEN_AI_USAGE_OUTPUT_TOKENS_REASONING = "gen_ai.usage.output_tokens.reasoning"
+    """
+    The number of tokens used for reasoning in the output.
+    Example: 75
+    """
+
+    GEN_AI_USAGE_TOTAL_TOKENS = "gen_ai.usage.total_tokens"
+    """
+    The total number of tokens used (input + output).
+    Example: 400
+    """
+
+    GEN_AI_USER_MESSAGE = "gen_ai.user.message"
+    """
+    The user message passed to the model.
+    Example: "What's the weather in Paris?"
+    """
+
+    HTTP_FRAGMENT = "http.fragment"
+    """
+    The Fragments present in the URL.
+    Example: #foo=bar
+    """
+
+    HTTP_METHOD = "http.method"
+    """
+    The HTTP method used.
+    Example: GET
+    """
+
+    HTTP_QUERY = "http.query"
+    """
+    The Query string present in the URL.
+    Example: ?foo=bar&bar=baz
+    """
+
+    HTTP_STATUS_CODE = "http.response.status_code"
+    """
+    The HTTP status code as an integer.
+    Example: 418
+    """
+
+    MESSAGING_DESTINATION_NAME = "messaging.destination.name"
+    """
+    The destination name where the message is being consumed from,
+    e.g. the queue name or topic.
+    """
+
+    MESSAGING_MESSAGE_ID = "messaging.message.id"
+    """
+    The message's identifier.
+    """
+
+    MESSAGING_MESSAGE_RECEIVE_LATENCY = "messaging.message.receive.latency"
+    """
+    The latency between when the task was enqueued and when it was started to be processed.
+    """
+
+    MESSAGING_MESSAGE_RETRY_COUNT = "messaging.message.retry.count"
+    """
+    Number of retries/attempts to process a message.
+    """
+
+    MESSAGING_SYSTEM = "messaging.system"
+    """
+    The messaging system's name, e.g. `kafka`, `aws_sqs`
+    """
+
+    NETWORK_PEER_ADDRESS = "network.peer.address"
+    """
+    Peer address of the network connection - IP address or Unix domain socket name.
+    Example: 10.1.2.80, /tmp/my.sock, localhost
+    """
+
+    NETWORK_PEER_PORT = "network.peer.port"
+    """
+    Peer port number of the network connection.
+    Example: 6379
+    """
+
+    NETWORK_TRANSPORT = "network.transport"
+    """
+    The transport protocol used for the network connection.
+    Example: "tcp", "udp", "unix"
+    """
+
+    PROFILER_ID = "profiler_id"
+    """
+    Label identifying the profiler id that the span occurred in. This should be a string.
+    Example: "5249fbada8d5416482c2f6e47e337372"
+    """
+
+    SERVER_ADDRESS = "server.address"
+    """
+    Name of the database host.
+    Example: example.com
+    """
+
+    SERVER_PORT = "server.port"
+    """
+    Logical server port number
+    Example: 80; 8080; 443
+    """
+
+    SERVER_SOCKET_ADDRESS = "server.socket.address"
+    """
+    Physical server IP address or Unix socket address.
+    Example: 10.5.3.2
+    """
+
+    SERVER_SOCKET_PORT = "server.socket.port"
+    """
+    Physical server port.
+    Recommended: If different than server.port.
+    Example: 16456
+    """
+
+    THREAD_ID = "thread.id"
+    """
+    Identifier of a thread from where the span originated. This should be a string.
+    Example: "7972576320"
+    """
+
+    THREAD_NAME = "thread.name"
+    """
+    Label identifying a thread from where the span originated. This should be a string.
+    Example: "MainThread"
+    """
+
+    MCP_TOOL_NAME = "mcp.tool.name"
+    """
+    The name of the MCP tool being called.
+    Example: "get_weather"
+    """
+
+    MCP_PROMPT_NAME = "mcp.prompt.name"
+    """
+    The name of the MCP prompt being retrieved.
+    Example: "code_review"
+    """
+
+    MCP_RESOURCE_URI = "mcp.resource.uri"
+    """
+    The URI of the MCP resource being accessed.
+    Example: "file:///path/to/resource"
+    """
+
+    MCP_METHOD_NAME = "mcp.method.name"
+    """
+    The MCP protocol method name being called.
+    Example: "tools/call", "prompts/get", "resources/read"
+    """
+
+    MCP_REQUEST_ID = "mcp.request.id"
+    """
+    The unique identifier for the MCP request.
+    Example: "req_123abc"
+    """
+
+    MCP_TOOL_RESULT_CONTENT = "mcp.tool.result.content"
+    """
+    The result/output content from an MCP tool execution.
+    Example: "The weather is sunny"
+    """
+
+    MCP_TOOL_RESULT_CONTENT_COUNT = "mcp.tool.result.content_count"
+    """
+    The number of items/keys in the MCP tool result.
+    Example: 5
+    """
+
+    MCP_TOOL_RESULT_IS_ERROR = "mcp.tool.result.is_error"
+    """
+    Whether the MCP tool execution resulted in an error.
+    Example: True
+    """
+
+    MCP_PROMPT_RESULT_MESSAGE_CONTENT = "mcp.prompt.result.message_content"
+    """
+    The message content from an MCP prompt retrieval.
+    Example: "Review the following code..."
+    """
+
+    MCP_PROMPT_RESULT_MESSAGE_ROLE = "mcp.prompt.result.message_role"
+    """
+    The role of the message in an MCP prompt retrieval (only set for single-message prompts).
+    Example: "user", "assistant", "system"
+    """
+
+    MCP_PROMPT_RESULT_MESSAGE_COUNT = "mcp.prompt.result.message_count"
+    """
+    The number of messages in an MCP prompt result.
+    Example: 1, 3
+    """
+
+    MCP_RESOURCE_PROTOCOL = "mcp.resource.protocol"
+    """
+    The protocol/scheme of the MCP resource URI.
+    Example: "file", "http", "https"
+    """
+
+    MCP_TRANSPORT = "mcp.transport"
+    """
+    The transport method used for MCP communication.
+    Example: "http", "sse", "stdio"
+    """
+
+    MCP_SESSION_ID = "mcp.session.id"
+    """
+    The session identifier for the MCP connection.
+    Example: "a1b2c3d4e5f6"
+    """
+
+
+class SPANSTATUS:
+    """
+    The status of a Sentry span.
+
+    See: https://develop.sentry.dev/sdk/event-payloads/contexts/#trace-context
+    """
+
+    ABORTED = "aborted"
+    ALREADY_EXISTS = "already_exists"
+    CANCELLED = "cancelled"
+    DATA_LOSS = "data_loss"
+    DEADLINE_EXCEEDED = "deadline_exceeded"
+    ERROR = "error"  # OTel status code: https://opentelemetry.io/docs/concepts/signals/traces/#span-status
+    FAILED_PRECONDITION = "failed_precondition"
+    INTERNAL_ERROR = "internal_error"
+    INVALID_ARGUMENT = "invalid_argument"
+    NOT_FOUND = "not_found"
+    OK = "ok"  # HTTP 200 and OTel status code: https://opentelemetry.io/docs/concepts/signals/traces/#span-status
+    OUT_OF_RANGE = "out_of_range"
+    PERMISSION_DENIED = "permission_denied"
+    RESOURCE_EXHAUSTED = "resource_exhausted"
+    UNAUTHENTICATED = "unauthenticated"
+    UNAVAILABLE = "unavailable"
+    UNIMPLEMENTED = "unimplemented"
+    UNKNOWN_ERROR = "unknown_error"
+    UNSET = "unset"  # OTel status code: https://opentelemetry.io/docs/concepts/signals/traces/#span-status
+
+
+class OP:
+    ANTHROPIC_MESSAGES_CREATE = "ai.messages.create.anthropic"
+    CACHE_GET = "cache.get"
+    CACHE_PUT = "cache.put"
+    COHERE_CHAT_COMPLETIONS_CREATE = "ai.chat_completions.create.cohere"
+    COHERE_EMBEDDINGS_CREATE = "ai.embeddings.create.cohere"
+    DB = "db"
+    DB_REDIS = "db.redis"
+    EVENT_DJANGO = "event.django"
+    FUNCTION = "function"
+    FUNCTION_AWS = "function.aws"
+    FUNCTION_GCP = "function.gcp"
+    GEN_AI_CHAT = "gen_ai.chat"
+    GEN_AI_CREATE_AGENT = "gen_ai.create_agent"
+    GEN_AI_EMBEDDINGS = "gen_ai.embeddings"
+    GEN_AI_EXECUTE_TOOL = "gen_ai.execute_tool"
+    GEN_AI_GENERATE_TEXT = "gen_ai.generate_text"
+    GEN_AI_HANDOFF = "gen_ai.handoff"
+    GEN_AI_PIPELINE = "gen_ai.pipeline"
+    GEN_AI_INVOKE_AGENT = "gen_ai.invoke_agent"
+    GEN_AI_RESPONSES = "gen_ai.responses"
+    GRAPHQL_EXECUTE = "graphql.execute"
+    GRAPHQL_MUTATION = "graphql.mutation"
+    GRAPHQL_PARSE = "graphql.parse"
+    GRAPHQL_RESOLVE = "graphql.resolve"
+    GRAPHQL_SUBSCRIPTION = "graphql.subscription"
+    GRAPHQL_QUERY = "graphql.query"
+    GRAPHQL_VALIDATE = "graphql.validate"
+    GRPC_CLIENT = "grpc.client"
+    GRPC_SERVER = "grpc.server"
+    HTTP_CLIENT = "http.client"
+    HTTP_CLIENT_STREAM = "http.client.stream"
+    HTTP_SERVER = "http.server"
+    MIDDLEWARE_DJANGO = "middleware.django"
+    MIDDLEWARE_LITESTAR = "middleware.litestar"
+    MIDDLEWARE_LITESTAR_RECEIVE = "middleware.litestar.receive"
+    MIDDLEWARE_LITESTAR_SEND = "middleware.litestar.send"
+    MIDDLEWARE_STARLETTE = "middleware.starlette"
+    MIDDLEWARE_STARLETTE_RECEIVE = "middleware.starlette.receive"
+    MIDDLEWARE_STARLETTE_SEND = "middleware.starlette.send"
+    MIDDLEWARE_STARLITE = "middleware.starlite"
+    MIDDLEWARE_STARLITE_RECEIVE = "middleware.starlite.receive"
+    MIDDLEWARE_STARLITE_SEND = "middleware.starlite.send"
+    HUGGINGFACE_HUB_CHAT_COMPLETIONS_CREATE = (
+        "ai.chat_completions.create.huggingface_hub"
+    )
+    QUEUE_PROCESS = "queue.process"
+    QUEUE_PUBLISH = "queue.publish"
+    QUEUE_SUBMIT_ARQ = "queue.submit.arq"
+    QUEUE_TASK_ARQ = "queue.task.arq"
+    QUEUE_SUBMIT_CELERY = "queue.submit.celery"
+    QUEUE_TASK_CELERY = "queue.task.celery"
+    QUEUE_TASK_RQ = "queue.task.rq"
+    QUEUE_SUBMIT_HUEY = "queue.submit.huey"
+    QUEUE_TASK_HUEY = "queue.task.huey"
+    QUEUE_SUBMIT_RAY = "queue.submit.ray"
+    QUEUE_TASK_RAY = "queue.task.ray"
+    QUEUE_TASK_DRAMATIQ = "queue.task.dramatiq"
+    SUBPROCESS = "subprocess"
+    SUBPROCESS_WAIT = "subprocess.wait"
+    SUBPROCESS_COMMUNICATE = "subprocess.communicate"
+    TEMPLATE_RENDER = "template.render"
+    VIEW_RENDER = "view.render"
+    VIEW_RESPONSE_RENDER = "view.response.render"
+    WEBSOCKET_SERVER = "websocket.server"
+    SOCKET_CONNECTION = "socket.connection"
+    SOCKET_DNS = "socket.dns"
+    MCP_SERVER = "mcp.server"
+
+
+# This type exists to trick mypy and PyCharm into thinking `init` and `Client`
+# take these arguments (even though they take opaque **kwargs)
+class ClientConstructor:
+    def __init__(
+        self,
+        dsn=None,  # type: Optional[str]
+        *,
+        max_breadcrumbs=DEFAULT_MAX_BREADCRUMBS,  # type: int
+        release=None,  # type: Optional[str]
+        environment=None,  # type: Optional[str]
+        server_name=None,  # type: Optional[str]
+        shutdown_timeout=2,  # type: float
+        integrations=[],  # type: Sequence[sentry_sdk.integrations.Integration]  # noqa: B006
+        in_app_include=[],  # type: List[str]  # noqa: B006
+        in_app_exclude=[],  # type: List[str]  # noqa: B006
+        default_integrations=True,  # type: bool
+        dist=None,  # type: Optional[str]
+        transport=None,  # type: Optional[Union[sentry_sdk.transport.Transport, Type[sentry_sdk.transport.Transport], Callable[[Event], None]]]
+        transport_queue_size=DEFAULT_QUEUE_SIZE,  # type: int
+        sample_rate=1.0,  # type: float
+        send_default_pii=None,  # type: Optional[bool]
+        http_proxy=None,  # type: Optional[str]
+        https_proxy=None,  # type: Optional[str]
+        ignore_errors=[],  # type: Sequence[Union[type, str]]  # noqa: B006
+        max_request_body_size="medium",  # type: str
+        socket_options=None,  # type: Optional[List[Tuple[int, int, int | bytes]]]
+        keep_alive=None,  # type: Optional[bool]
+        before_send=None,  # type: Optional[EventProcessor]
+        before_breadcrumb=None,  # type: Optional[BreadcrumbProcessor]
+        debug=None,  # type: Optional[bool]
+        attach_stacktrace=False,  # type: bool
+        ca_certs=None,  # type: Optional[str]
+        propagate_traces=True,  # type: bool
+        traces_sample_rate=None,  # type: Optional[float]
+        traces_sampler=None,  # type: Optional[TracesSampler]
+        profiles_sample_rate=None,  # type: Optional[float]
+        profiles_sampler=None,  # type: Optional[TracesSampler]
+        profiler_mode=None,  # type: Optional[ProfilerMode]
+        profile_lifecycle="manual",  # type: Literal["manual", "trace"]
+        profile_session_sample_rate=None,  # type: Optional[float]
+        auto_enabling_integrations=True,  # type: bool
+        disabled_integrations=None,  # type: Optional[Sequence[sentry_sdk.integrations.Integration]]
+        auto_session_tracking=True,  # type: bool
+        send_client_reports=True,  # type: bool
+        _experiments={},  # type: Experiments  # noqa: B006
+        proxy_headers=None,  # type: Optional[Dict[str, str]]
+        instrumenter=INSTRUMENTER.SENTRY,  # type: Optional[str]
+        before_send_transaction=None,  # type: Optional[TransactionProcessor]
+        project_root=None,  # type: Optional[str]
+        enable_tracing=None,  # type: Optional[bool]
+        include_local_variables=True,  # type: Optional[bool]
+        include_source_context=True,  # type: Optional[bool]
+        trace_propagation_targets=[  # noqa: B006
+            MATCH_ALL
+        ],  # type: Optional[Sequence[str]]
+        functions_to_trace=[],  # type: Sequence[Dict[str, str]]  # noqa: B006
+        event_scrubber=None,  # type: Optional[sentry_sdk.scrubber.EventScrubber]
+        max_value_length=DEFAULT_MAX_VALUE_LENGTH,  # type: int
+        enable_backpressure_handling=True,  # type: bool
+        error_sampler=None,  # type: Optional[Callable[[Event, Hint], Union[float, bool]]]
+        enable_db_query_source=True,  # type: bool
+        db_query_source_threshold_ms=100,  # type: int
+        enable_http_request_source=True,  # type: bool
+        http_request_source_threshold_ms=100,  # type: int
+        spotlight=None,  # type: Optional[Union[bool, str]]
+        cert_file=None,  # type: Optional[str]
+        key_file=None,  # type: Optional[str]
+        custom_repr=None,  # type: Optional[Callable[..., Optional[str]]]
+        add_full_stack=DEFAULT_ADD_FULL_STACK,  # type: bool
+        max_stack_frames=DEFAULT_MAX_STACK_FRAMES,  # type: Optional[int]
+        enable_logs=False,  # type: bool
+        before_send_log=None,  # type: Optional[Callable[[Log, Hint], Optional[Log]]]
+        trace_ignore_status_codes=frozenset(),  # type: AbstractSet[int]
+        enable_metrics=True,  # type: bool
+        before_send_metric=None,  # type: Optional[Callable[[Metric, Hint], Optional[Metric]]]
+    ):
+        # type: (...) -> None
+        """Initialize the Sentry SDK with the given parameters. All parameters described here can be used in a call to `sentry_sdk.init()`.
+
+        :param dsn: The DSN tells the SDK where to send the events.
+
+            If this option is not set, the SDK will just not send any data.
+
+            The `dsn` config option takes precedence over the environment variable.
+
+            Learn more about `DSN utilization <https://docs.sentry.io/product/sentry-basics/dsn-explainer/#dsn-utilization>`_.
+
+        :param debug: Turns debug mode on or off.
+
+            When `True`, the SDK will attempt to print out debugging information. This can be useful if something goes
+            wrong with event sending.
+
+            The default is always `False`. It's generally not recommended to turn it on in production because of the
+            increase in log output.
+
+            The `debug` config option takes precedence over the environment variable.
+
+        :param release: Sets the release.
+
+            If not set, the SDK will try to automatically configure a release out of the box but it's a better idea to
+            manually set it to guarantee that the release is in sync with your deploy integrations.
+
+            Release names are strings, but some formats are detected by Sentry and might be rendered differently.
+
+            See `the releases documentation <https://docs.sentry.io/platforms/python/configuration/releases/>`_ to learn how the SDK tries to
+            automatically configure a release.
+
+            The `release` config option takes precedence over the environment variable.
+
+            Learn more about how to send release data so Sentry can tell you about regressions between releases and
+            identify the potential source in `the product documentation <https://docs.sentry.io/product/releases/>`_.
+
+        :param environment: Sets the environment. This string is freeform and set to `production` by default.
+
+            A release can be associated with more than one environment to separate them in the UI (think `staging` vs
+            `production` or similar).
+
+            The `environment` config option takes precedence over the environment variable.
+
+        :param dist: The distribution of the application.
+
+            Distributions are used to disambiguate build or deployment variants of the same release of an application.
+
+            The dist can be for example a build number.
+
+        :param sample_rate: Configures the sample rate for error events, in the range of `0.0` to `1.0`.
+
+            The default is `1.0`, which means that 100% of error events will be sent. If set to `0.1`, only 10% of
+            error events will be sent.
+
+            Events are picked randomly.
+
+        :param error_sampler: Dynamically configures the sample rate for error events on a per-event basis.
+
+            This configuration option accepts a function, which takes two parameters (the `event` and the `hint`), and
+            which returns a boolean (indicating whether the event should be sent to Sentry) or a floating-point number
+            between `0.0` and `1.0`, inclusive.
+
+            The number indicates the probability the event is sent to Sentry; the SDK will randomly decide whether to
+            send the event with the given probability.
+
+            If this configuration option is specified, the `sample_rate` option is ignored.
+
+        :param ignore_errors: A list of exception class names that shouldn't be sent to Sentry.
+
+            Errors that are an instance of these exceptions or a subclass of them, will be filtered out before they're
+            sent to Sentry.
+
+            By default, all errors are sent.
+
+        :param max_breadcrumbs: This variable controls the total amount of breadcrumbs that should be captured.
+
+            This defaults to `100`, but you can set this to any number.
+
+            However, you should be aware that Sentry has a `maximum payload size <https://develop.sentry.dev/sdk/data-model/envelopes/#size-limits>`_
+            and any events exceeding that payload size will be dropped.
+
+        :param attach_stacktrace: When enabled, stack traces are automatically attached to all messages logged.
+
+            Stack traces are always attached to exceptions; however, when this option is set, stack traces are also
+            sent with messages.
+
+            This option means that stack traces appear next to all log messages.
+
+            Grouping in Sentry is different for events with stack traces and without. As a result, you will get new
+            groups as you enable or disable this flag for certain events.
+
+        :param send_default_pii: If this flag is enabled, `certain personally identifiable information (PII)
+            <https://docs.sentry.io/platforms/python/data-management/data-collected/>`_ is added by active integrations.
+
+            If you enable this option, be sure to manually remove what you don't want to send using our features for
+            managing `Sensitive Data <https://docs.sentry.io/data-management/sensitive-data/>`_.
+
+        :param event_scrubber: Scrubs the event payload for sensitive information such as cookies, sessions, and
+            passwords from a `denylist`.
+
+            It can additionally be used to scrub from another `pii_denylist` if `send_default_pii` is disabled.
+
+            See how to `configure the scrubber here <https://docs.sentry.io/data-management/sensitive-data/#event-scrubber>`_.
+
+        :param include_source_context: When enabled, source context will be included in events sent to Sentry.
+
+            This source context includes the five lines of code above and below the line of code where an error
+            happened.
+
+        :param include_local_variables: When enabled, the SDK will capture a snapshot of local variables to send with
+            the event to help with debugging.
+
+        :param add_full_stack: When capturing errors, Sentry stack traces typically only include frames that start the
+            moment an error occurs.
+
+            But if the `add_full_stack` option is enabled (set to `True`), all frames from the start of execution will
+            be included in the stack trace sent to Sentry.
+
+        :param max_stack_frames: This option limits the number of stack frames that will be captured when
+            `add_full_stack` is enabled.
+
+        :param server_name: This option can be used to supply a server name.
+
+            When provided, the name of the server is sent along and persisted in the event.
+
+            For many integrations, the server name actually corresponds to the device hostname, even in situations
+            where the machine is not actually a server.
+
+        :param project_root: The full path to the root directory of your application.
+
+            The `project_root` is used to mark frames in a stack trace either as being in your application or outside
+            of the application.
+
+        :param in_app_include: A list of string prefixes of module names that belong to the app.
+
+            This option takes precedence over `in_app_exclude`.
+
+            Sentry differentiates stack frames that are directly related to your application ("in application") from
+            stack frames that come from other packages such as the standard library, frameworks, or other dependencies.
+
+            The application package is automatically marked as `inApp`.
+
+            The difference is visible in [sentry.io](https://sentry.io), where only the "in application" frames are
+            displayed by default.
+
+        :param in_app_exclude: A list of string prefixes of module names that do not belong to the app, but rather to
+            third-party packages.
+
+            Modules considered not part of the app will be hidden from stack traces by default.
+
+            This option can be overridden using `in_app_include`.
+
+        :param max_request_body_size: This parameter controls whether integrations should capture HTTP request bodies.
+            It can be set to one of the following values:
+
+            - `never`: Request bodies are never sent.
+            - `small`: Only small request bodies will be captured. The cutoff for small depends on the SDK (typically
+              4KB).
+            - `medium`: Medium and small requests will be captured (typically 10KB).
+            - `always`: The SDK will always capture the request body as long as Sentry can make sense of it.
+
+            Please note that the Sentry server [limits HTTP request body size](https://develop.sentry.dev/sdk/
+            expected-features/data-handling/#variable-size). The server always enforces its size limit, regardless of
+            how you configure this option.
+
+        :param max_value_length: The number of characters after which the values containing text in the event payload
+            will be truncated.
+
+            WARNING: If the value you set for this is exceptionally large, the event may exceed 1 MiB and will be
+            dropped by Sentry.
+
+        :param ca_certs: A path to an alternative CA bundle file in PEM-format.
+
+        :param send_client_reports: Set this boolean to `False` to disable sending of client reports.
+
+            Client reports allow the client to send status reports about itself to Sentry, such as information about
+            events that were dropped before being sent.
+
+        :param integrations: List of integrations to enable in addition to `auto-enabling integrations (overview)
+            <https://docs.sentry.io/platforms/python/integrations>`_.
+
+            This setting can be used to override the default config options for a specific auto-enabling integration
+            or to add an integration that is not auto-enabled.
+
+        :param disabled_integrations: List of integrations that will be disabled.
+
+            This setting can be used to explicitly turn off specific `auto-enabling integrations (list)
+            <https://docs.sentry.io/platforms/python/integrations/#available-integrations>`_ or
+            `default <https://docs.sentry.io/platforms/python/integrations/default-integrations/>`_ integrations.
+
+        :param auto_enabling_integrations: Configures whether `auto-enabling integrations (configuration)
+            <https://docs.sentry.io/platforms/python/integrations/#available-integrations>`_ should be enabled.
+
+            When set to `False`, no auto-enabling integrations will be enabled by default, even if the corresponding
+            framework/library is detected.
+
+        :param default_integrations: Configures whether `default integrations
+            <https://docs.sentry.io/platforms/python/integrations/default-integrations/>`_ should be enabled.
+
+            Setting `default_integrations` to `False` disables all default integrations **as well as all auto-enabling
+            integrations**, unless they are specifically added in the `integrations` option, described above.
+
+        :param before_send: This function is called with an SDK-specific message or error event object, and can return
+            a modified event object, or `null` to skip reporting the event.
+
+            This can be used, for instance, for manual PII stripping before sending.
+
+            By the time `before_send` is executed, all scope data has already been applied to the event. Further
+            modification of the scope won't have any effect.
+
+        :param before_send_transaction: This function is called with an SDK-specific transaction event object, and can
+            return a modified transaction event object, or `null` to skip reporting the event.
+
+            One way this might be used is for manual PII stripping before sending.
+
+        :param before_breadcrumb: This function is called with an SDK-specific breadcrumb object before the breadcrumb
+            is added to the scope.
+
+            When nothing is returned from the function, the breadcrumb is dropped.
+
+            To pass the breadcrumb through, return the first argument, which contains the breadcrumb object.
+
+            The callback typically gets a second argument (called a "hint") which contains the original object from
+            which the breadcrumb was created to further customize what the breadcrumb should look like.
+
+        :param transport: Switches out the transport used to send events.
+
+            How this works depends on the SDK. It can, for instance, be used to capture events for unit-testing or to
+            send it through some more complex setup that requires proxy authentication.
+
+        :param transport_queue_size: The maximum number of events that will be queued before the transport is forced to
+            flush.
+
+        :param http_proxy: When set, a proxy can be configured that should be used for outbound requests.
+
+            This is also used for HTTPS requests unless a separate `https_proxy` is configured. However, not all SDKs
+            support a separate HTTPS proxy.
+
+            SDKs will attempt to default to the system-wide configured proxy, if possible. For instance, on Unix
+            systems, the `http_proxy` environment variable will be picked up.
+
+        :param https_proxy: Configures a separate proxy for outgoing HTTPS requests.
+
+            This value might not be supported by all SDKs. When not supported the `http-proxy` value is also used for
+            HTTPS requests at all times.
+
+        :param proxy_headers: A dict containing additional proxy headers (usually for authentication) to be forwarded
+            to `urllib3`'s `ProxyManager <https://urllib3.readthedocs.io/en/1.24.3/reference/index.html#urllib3.poolmanager.ProxyManager>`_.
+
+        :param shutdown_timeout: Controls how many seconds to wait before shutting down.
+
+            Sentry SDKs send events from a background queue. This queue is given a certain amount to drain pending
+            events. The default is SDK specific but typically around two seconds.
+
+            Setting this value too low may cause problems for sending events from command line applications.
+
+            Setting the value too high will cause the application to block for a long time for users experiencing
+            network connectivity problems.
+
+        :param keep_alive: Determines whether to keep the connection alive between requests.
+
+            This can be useful in environments where you encounter frequent network issues such as connection resets.
+
+        :param cert_file: Path to the client certificate to use.
+
+            If set, supersedes the `CLIENT_CERT_FILE` environment variable.
+
+        :param key_file: Path to the key file to use.
+
+            If set, supersedes the `CLIENT_KEY_FILE` environment variable.
+
+        :param socket_options: An optional list of socket options to use.
+
+            These provide fine-grained, low-level control over the way the SDK connects to Sentry.
+
+            If provided, the options will override the default `urllib3` `socket options
+            <https://urllib3.readthedocs.io/en/stable/reference/urllib3.connection.html#urllib3.connection.HTTPConnection>`_.
+
+        :param traces_sample_rate: A number between `0` and `1`, controlling the percentage chance a given transaction
+            will be sent to Sentry.
+
+            (`0` represents 0% while `1` represents 100%.) Applies equally to all transactions created in the app.
+
+            Either this or `traces_sampler` must be defined to enable tracing.
+
+            If `traces_sample_rate` is `0`, this means that no new traces will be created. However, if you have
+            another service (for example a JS frontend) that makes requests to your service that include trace
+            information, those traces will be continued and thus transactions will be sent to Sentry.
+
+            If you want to disable all tracing you need to set `traces_sample_rate=None`. In this case, no new traces
+            will be started and no incoming traces will be continued.
+
+        :param traces_sampler: A function responsible for determining the percentage chance a given transaction will be
+            sent to Sentry.
+
+            It will automatically be passed information about the transaction and the context in which it's being
+            created, and must return a number between `0` (0% chance of being sent) and `1` (100% chance of being
+            sent).
+
+            Can also be used for filtering transactions, by returning `0` for those that are unwanted.
+
+            Either this or `traces_sample_rate` must be defined to enable tracing.
+
+        :param trace_propagation_targets: An optional property that controls which downstream services receive tracing
+            data, in the form of a `sentry-trace` and a `baggage` header attached to any outgoing HTTP requests.
+
+            The option may contain a list of strings or regex against which the URLs of outgoing requests are matched.
+
+            If one of the entries in the list matches the URL of an outgoing request, trace data will be attached to
+            that request.
+
+            String entries do not have to be full matches, meaning the URL of a request is matched when it _contains_
+            a string provided through the option.
+
+            If `trace_propagation_targets` is not provided, trace data is attached to every outgoing request from the
+            instrumented client.
+
+        :param functions_to_trace: An optional list of functions that should be set up for tracing.
+
+            For each function in the list, a span will be created when the function is executed.
+
+            Functions in the list are represented as strings containing the fully qualified name of the function.
+
+            This is a convenient option, making it possible to have one central place for configuring what functions
+            to trace, instead of having custom instrumentation scattered all over your code base.
+
+            To learn more, see the `Custom Instrumentation <https://docs.sentry.io/platforms/python/tracing/instrumentation/custom-instrumentation/#define-span-creation-in-a-central-place>`_ documentation.
+
+        :param enable_backpressure_handling: When enabled, a new monitor thread will be spawned to perform health
+            checks on the SDK.
+
+            If the system is unhealthy, the SDK will keep halving the `traces_sample_rate` set by you in 10 second
+            intervals until recovery.
+
+            This down sampling helps ensure that the system stays stable and reduces SDK overhead under high load.
+
+            This option is enabled by default.
+
+        :param enable_db_query_source: When enabled, the source location will be added to database queries.
+
+        :param db_query_source_threshold_ms: The threshold in milliseconds for adding the source location to database
+            queries.
+
+            The query location will be added to the query for queries slower than the specified threshold.
+
+        :param enable_http_request_source: When enabled, the source location will be added to outgoing HTTP requests.
+
+        :param http_request_source_threshold_ms: The threshold in milliseconds for adding the source location to an
+            outgoing HTTP request.
+
+            The request location will be added to the request for requests slower than the specified threshold.
+
+        :param custom_repr: A custom `repr <https://docs.python.org/3/library/functions.html#repr>`_ function to run
+            while serializing an object.
+
+            Use this to control how your custom objects and classes are visible in Sentry.
+
+            Return a string for that repr value to be used or `None` to continue serializing how Sentry would have
+            done it anyway.
+
+        :param profiles_sample_rate: A number between `0` and `1`, controlling the percentage chance a given sampled
+            transaction will be profiled.
+
+            (`0` represents 0% while `1` represents 100%.) Applies equally to all transactions created in the app.
+
+            This is relative to the tracing sample rate - e.g. `0.5` means 50% of sampled transactions will be
+            profiled.
+
+        :param profiles_sampler:
+
+        :param profiler_mode:
+
+        :param profile_lifecycle:
+
+        :param profile_session_sample_rate:
+
+        :param enable_tracing:
+
+        :param propagate_traces:
+
+        :param auto_session_tracking:
+
+        :param spotlight:
+
+        :param instrumenter:
+
+        :param enable_logs: Set `enable_logs` to True to enable the SDK to emit
+            Sentry logs. Defaults to False.
+
+        :param before_send_log: An optional function to modify or filter out logs
+            before they're sent to Sentry. Any modifications to the log in this
+            function will be retained. If the function returns None, the log will
+            not be sent to Sentry.
+
+        :param trace_ignore_status_codes: An optional property that disables tracing for
+            HTTP requests with certain status codes.
+
+            Requests are not traced if the status code is contained in the provided set.
+
+            If `trace_ignore_status_codes` is not provided, requests with any status code
+            may be traced.
+
+        :param _experiments:
+        """
+        pass
+
+
+def _get_default_options():
+    # type: () -> dict[str, Any]
+    import inspect
+
+    a = inspect.getfullargspec(ClientConstructor.__init__)
+    defaults = a.defaults or ()
+    kwonlydefaults = a.kwonlydefaults or {}
+
+    return dict(
+        itertools.chain(
+            zip(a.args[-len(defaults) :], defaults),
+            kwonlydefaults.items(),
+        )
+    )
+
+
+DEFAULT_OPTIONS = _get_default_options()
+del _get_default_options
+
 
-VERSION = "0.7.5"
-DEFAULT_SERVER_NAME = socket.gethostname() if hasattr(socket, "gethostname") else None
-DEFAULT_OPTIONS = {
-    "dsn": None,
-    "with_locals": True,
-    "max_breadcrumbs": 100,
-    "release": None,
-    "environment": None,
-    "server_name": DEFAULT_SERVER_NAME,
-    "shutdown_timeout": 2.0,
-    "integrations": [],
-    "in_app_include": [],
-    "in_app_exclude": [],
-    "default_integrations": True,
-    "dist": None,
-    "transport": None,
-    "sample_rate": 1.0,
-    "send_default_pii": False,
-    "http_proxy": None,
-    "https_proxy": None,
-    "ignore_errors": [],
-    "request_bodies": "medium",
-    "before_send": None,
-    "before_breadcrumb": None,
-    "debug": False,
-    "attach_stacktrace": False,
-    "ca_certs": None,
-}
-
-
-SDK_INFO = {
-    "name": "sentry.python",
-    "version": VERSION,
-    "packages": [{"name": "pypi:sentry-sdk", "version": VERSION}],
-}
+VERSION = "2.46.0"