sentry-sdk 2.30.0__tar.gz → 2.32.0__tar.gz

{sentry_sdk-2.30.0/sentry_sdk.egg-info → sentry_sdk-2.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sentry-sdk
-Version: 2.30.0
+Version: 2.32.0
 Summary: Python client for Sentry (https://sentry.io)
 Home-page: https://github.com/getsentry/sentry-python
 Author: Sentry Team and Contributors

{sentry_sdk-2.30.0 → sentry_sdk-2.32.0}/pyproject.toml

@@ -183,6 +183,10 @@ ignore_missing_imports = true
 module = "grpc.*"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "agents.*"
+ignore_missing_imports = true
+
 #
 # Tool: Flake8
 #

{sentry_sdk-2.30.0 → sentry_sdk-2.32.0}/sentry_sdk/__init__.py

@@ -47,6 +47,8 @@ __all__ = [  # noqa
     "trace",
     "monitor",
     "logger",
+    "start_session",
+    "end_session",
 ]
 
 # Initialize the debug support after everything is loaded

{sentry_sdk-2.30.0 → sentry_sdk-2.32.0}/sentry_sdk/api.py

@@ -82,6 +82,8 @@ __all__ = [
     "start_transaction",
     "trace",
     "monitor",
+    "start_session",
+    "end_session",
 ]
 
 
@@ -450,3 +452,17 @@ def continue_trace(
     return get_isolation_scope().continue_trace(
         environ_or_headers, op, name, source, origin
     )
+
+
+@scopemethod
+def start_session(
+    session_mode="application",  # type: str
+):
+    # type: (...) -> None
+    return get_isolation_scope().start_session(session_mode=session_mode)
+
+
+@scopemethod
+def end_session():
+    # type: () -> None
+    return get_isolation_scope().end_session()

{sentry_sdk-2.30.0 → sentry_sdk-2.32.0}/sentry_sdk/consts.py

@@ -108,16 +108,39 @@ class SPANDATA:
     See: https://develop.sentry.dev/sdk/performance/span-data-conventions/
     """
 
+    AI_CITATIONS = "ai.citations"
+    """
+    References or sources cited by the AI model in its response.
+    Example: ["Smith et al. 2020", "Jones 2019"]
+    """
+
+    AI_DOCUMENTS = "ai.documents"
+    """
+    Documents or content chunks used as context for the AI model.
+    Example: ["doc1.txt", "doc2.pdf"]
+    """
+
+    AI_FINISH_REASON = "ai.finish_reason"
+    """
+    The reason why the model stopped generating.
+    Example: "length"
+    """
+
     AI_FREQUENCY_PENALTY = "ai.frequency_penalty"
     """
     Used to reduce repetitiveness of generated tokens.
     Example: 0.5
     """
 
-    AI_PRESENCE_PENALTY = "ai.presence_penalty"
+    AI_FUNCTION_CALL = "ai.function_call"
     """
-    Used to reduce repetitiveness of generated tokens.
-    Example: 0.5
+    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"
+    """
+    Unique identifier for the completion.
+    Example: "gen_123abc"
     """
 
     AI_INPUT_MESSAGES = "ai.input_messages"
@@ -126,10 +149,9 @@ class SPANDATA:
     Example: [{"role": "user", "message": "hello"}]
     """
 
-    AI_MODEL_ID = "ai.model_id"
+    AI_LOGIT_BIAS = "ai.logit_bias"
     """
-    The unique descriptor of the model being execugted
-    Example: gpt-4
+    For an AI model call, the logit bias
     """
 
     AI_METADATA = "ai.metadata"
@@ -138,28 +160,94 @@ class SPANDATA:
     Example: {"executed_function": "add_integers"}
     """
 
-    AI_TAGS = "ai.tags"
+    AI_MODEL_ID = "ai.model_id"
     """
-    Tags that describe an AI pipeline step.
-    Example: {"executed_function": "add_integers"}
+    The unique descriptor of the model being execugted
+    Example: gpt-4
+    """
+
+    AI_PIPELINE_NAME = "ai.pipeline.name"
+    """
+    Name of the AI pipeline or chain being executed.
+    Example: "qa-pipeline"
+    """
+
+    AI_PREAMBLE = "ai.preamble"
+    """
+    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"
+    """
+    Used to reduce repetitiveness of generated tokens.
+    Example: 0.5
+    """
+
+    AI_RAW_PROMPTING = "ai.raw_prompting"
+    """
+    Minimize pre-processing done to the prompt sent to the LLM.
+    Example: true
+    """
+
+    AI_RESPONSE_FORMAT = "ai.response_format"
+    """
+    For an AI model call, the format of the response
+    """
+
+    AI_RESPONSES = "ai.responses"
+    """
+    The responses to an AI model call. Always as a list.
+    Example: ["hello", "world"]
+    """
+
+    AI_SEARCH_QUERIES = "ai.search_queries"
+    """
+    Queries used to search for relevant context or documents.
+    Example: ["climate change effects", "renewable energy"]
+    """
+
+    AI_SEARCH_REQUIRED = "ai.is_search_required"
+    """
+    Boolean indicating if the model needs to perform a search.
+    Example: true
+    """
+
+    AI_SEARCH_RESULTS = "ai.search_results"
+    """
+    Results returned from search queries for context.
+    Example: ["Result 1", "Result 2"]
+    """
+
+    AI_SEED = "ai.seed"
+    """
+    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"
     """
-    Whether or not the AI model call's repsonse was streamed back asynchronously
+    Whether or not the AI model call's response was streamed back asynchronously
     Example: true
     """
 
+    AI_TAGS = "ai.tags"
+    """
+    Tags that describe an AI pipeline step.
+    Example: {"executed_function": "add_integers"}
+    """
+
     AI_TEMPERATURE = "ai.temperature"
     """
     For an AI model call, the temperature parameter. Temperature essentially means how random the output will be.
     Example: 0.5
     """
 
-    AI_TOP_P = "ai.top_p"
+    AI_TEXTS = "ai.texts"
     """
-    For an AI model call, the top_p parameter. Top_p essentially controls how random the output will be.
-    Example: 0.5
+    Raw text inputs provided to the model.
+    Example: ["What is machine learning?"]
     """
 
     AI_TOP_K = "ai.top_k"
@@ -168,9 +256,10 @@ class SPANDATA:
     Example: 35
     """
 
-    AI_FUNCTION_CALL = "ai.function_call"
+    AI_TOP_P = "ai.top_p"
     """
-    For an AI model call, the function that was called. This is deprecated for OpenAI, and replaced by tool_calls
+    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"
@@ -183,168 +272,236 @@ class SPANDATA:
     For an AI model call, the functions that are available
     """
 
-    AI_RESPONSE_FORMAT = "ai.response_format"
+    AI_WARNINGS = "ai.warnings"
     """
-    For an AI model call, the format of the response
+    Warning messages generated during model execution.
+    Example: ["Token limit exceeded"]
     """
 
-    AI_LOGIT_BIAS = "ai.logit_bias"
+    CACHE_HIT = "cache.hit"
     """
-    For an AI model call, the logit bias
+    A boolean indicating whether the requested data was found in the cache.
+    Example: true
     """
 
-    AI_PREAMBLE = "ai.preamble"
+    CACHE_ITEM_SIZE = "cache.item_size"
     """
-    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."
+    The size of the requested data in bytes.
+    Example: 58
     """
 
-    AI_RAW_PROMPTING = "ai.raw_prompting"
+    CACHE_KEY = "cache.key"
     """
-    Minimize pre-processing done to the prompt sent to the LLM.
-    Example: true
+    The key of the requested data.
+    Example: template.cache.some_item.867da7e2af8e6b2f3aa7213a4080edb3
     """
-    AI_RESPONSES = "ai.responses"
+
+    CODE_FILEPATH = "code.filepath"
     """
-    The responses to an AI model call. Always as a list.
-    Example: ["hello", "world"]
+    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"
     """
 
-    AI_SEED = "ai.seed"
+    CODE_FUNCTION = "code.function"
     """
-    The seed, ideally models given the same seed and same other parameters will produce the exact same output.
-    Example: 123.45
+    The method or function name, or equivalent (usually rightmost part of the code unit's name).
+    Example: "server_request"
     """
 
-    AI_CITATIONS = "ai.citations"
+    CODE_LINENO = "code.lineno"
     """
-    References or sources cited by the AI model in its response.
-    Example: ["Smith et al. 2020", "Jones 2019"]
+    The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`.
+    Example: 42
     """
 
-    AI_DOCUMENTS = "ai.documents"
+    CODE_NAMESPACE = "code.namespace"
     """
-    Documents or content chunks used as context for the AI model.
-    Example: ["doc1.txt", "doc2.pdf"]
+    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"
     """
 
-    AI_SEARCH_QUERIES = "ai.search_queries"
+    DB_MONGODB_COLLECTION = "db.mongodb.collection"
     """
-    Queries used to search for relevant context or documents.
-    Example: ["climate change effects", "renewable energy"]
+    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
     """
 
-    AI_SEARCH_RESULTS = "ai.search_results"
+    DB_NAME = "db.name"
     """
-    Results returned from search queries for context.
-    Example: ["Result 1", "Result 2"]
+    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
     """
 
-    AI_GENERATION_ID = "ai.generation_id"
+    DB_OPERATION = "db.operation"
     """
-    Unique identifier for the completion.
-    Example: "gen_123abc"
+    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
     """
 
-    AI_SEARCH_REQUIRED = "ai.is_search_required"
+    DB_SYSTEM = "db.system"
     """
-    Boolean indicating if the model needs to perform a search.
-    Example: true
+    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
     """
 
-    AI_FINISH_REASON = "ai.finish_reason"
+    DB_USER = "db.user"
     """
-    The reason why the model stopped generating.
-    Example: "length"
+    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
     """
 
-    AI_PIPELINE_NAME = "ai.pipeline.name"
+    GEN_AI_AGENT_NAME = "gen_ai.agent.name"
     """
-    Name of the AI pipeline or chain being executed.
-    Example: "qa-pipeline"
+    The name of the agent being used.
+    Example: "ResearchAssistant"
     """
 
-    AI_TEXTS = "ai.texts"
+    GEN_AI_CHOICE = "gen_ai.choice"
     """
-    Raw text inputs provided to the model.
-    Example: ["What is machine learning?"]
+    The model's response message.
+    Example: "The weather in Paris is rainy and overcast, with temperatures around 57°F"
     """
 
-    AI_WARNINGS = "ai.warnings"
+    GEN_AI_OPERATION_NAME = "gen_ai.operation.name"
     """
-    Warning messages generated during model execution.
-    Example: ["Token limit exceeded"]
+    The name of the operation being performed.
+    Example: "chat"
     """
 
-    DB_NAME = "db.name"
+    GEN_AI_RESPONSE_TEXT = "gen_ai.response.text"
     """
-    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
+    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"]
     """
 
-    DB_USER = "db.user"
+    GEN_AI_RESPONSE_TOOL_CALLS = "gen_ai.response.tool_calls"
     """
-    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
+    The tool calls in the model's response.
+    Example: [{"name": "get_weather", "arguments": {"location": "Paris"}}]
     """
 
-    DB_OPERATION = "db.operation"
+    GEN_AI_REQUEST_AVAILABLE_TOOLS = "gen_ai.request.available_tools"
     """
-    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
+    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"}]
     """
 
-    DB_SYSTEM = "db.system"
+    GEN_AI_REQUEST_FREQUENCY_PENALTY = "gen_ai.request.frequency_penalty"
     """
-    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
+    The frequency penalty parameter used to reduce repetitiveness of generated tokens.
+    Example: 0.1
     """
 
-    DB_MONGODB_COLLECTION = "db.mongodb.collection"
+    GEN_AI_REQUEST_MAX_TOKENS = "gen_ai.request.max_tokens"
     """
-    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
+    The maximum number of tokens to generate in the response.
+    Example: 2048
     """
 
-    CACHE_HIT = "cache.hit"
+    GEN_AI_REQUEST_MESSAGES = "gen_ai.request.messages"
     """
-    A boolean indicating whether the requested data was found in the cache.
-    Example: true
+    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"}]}]
     """
 
-    CACHE_ITEM_SIZE = "cache.item_size"
+    GEN_AI_REQUEST_MODEL = "gen_ai.request.model"
     """
-    The size of the requested data in bytes.
-    Example: 58
+    The model identifier being used for the request.
+    Example: "gpt-4-turbo-preview"
     """
 
-    CACHE_KEY = "cache.key"
+    GEN_AI_REQUEST_PRESENCE_PENALTY = "gen_ai.request.presence_penalty"
     """
-    The key of the requested data.
-    Example: template.cache.some_item.867da7e2af8e6b2f3aa7213a4080edb3
+    The presence penalty parameter used to reduce repetitiveness of generated tokens.
+    Example: 0.1
     """
 
-    NETWORK_PEER_ADDRESS = "network.peer.address"
+    GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature"
     """
-    Peer address of the network connection - IP address or Unix domain socket name.
-    Example: 10.1.2.80, /tmp/my.sock, localhost
+    The temperature parameter used to control randomness in the output.
+    Example: 0.7
     """
 
-    NETWORK_PEER_PORT = "network.peer.port"
+    GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p"
     """
-    Peer port number of the network connection.
-    Example: 6379
+    The top_p parameter used to control diversity via nucleus sampling.
+    Example: 1.0
     """
 
-    HTTP_QUERY = "http.query"
+    GEN_AI_SYSTEM = "gen_ai.system"
     """
-    The Query string present in the URL.
-    Example: ?foo=bar&bar=baz
+    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"
@@ -359,6 +516,12 @@ class SPANDATA:
     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.
@@ -376,14 +539,14 @@ class SPANDATA:
     The message's identifier.
     """
 
-    MESSAGING_MESSAGE_RETRY_COUNT = "messaging.message.retry.count"
+    MESSAGING_MESSAGE_RECEIVE_LATENCY = "messaging.message.receive.latency"
     """
-    Number of retries/attempts to process a message.
+    The latency between when the task was enqueued and when it was started to be processed.
     """
 
-    MESSAGING_MESSAGE_RECEIVE_LATENCY = "messaging.message.receive.latency"
+    MESSAGING_MESSAGE_RETRY_COUNT = "messaging.message.retry.count"
     """
-    The latency between when the task was enqueued and when it was started to be processed.
+    Number of retries/attempts to process a message.
     """
 
     MESSAGING_SYSTEM = "messaging.system"
@@ -391,6 +554,24 @@ class SPANDATA:
     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
+    """
+
+    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.
@@ -416,30 +597,6 @@ class SPANDATA:
     Example: 16456
     """
 
-    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_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_FUNCTION = "code.function"
-    """
-    The method or function name, or equivalent (usually rightmost part of the code unit's name).
-    Example: "server_request"
-    """
-
-    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"
-    """
-
     THREAD_ID = "thread.id"
     """
     Identifier of a thread from where the span originated. This should be a string.
@@ -452,12 +609,6 @@ class SPANDATA:
     Example: "MainThread"
     """
 
-    PROFILER_ID = "profiler_id"
-    """
-    Label identifying the profiler id that the span occurred in. This should be a string.
-    Example: "5249fbada8d5416482c2f6e47e337372"
-    """
-
 
 class SPANSTATUS:
     """
@@ -497,6 +648,10 @@ class OP:
     FUNCTION = "function"
     FUNCTION_AWS = "function.aws"
     FUNCTION_GCP = "function.gcp"
+    GEN_AI_CHAT = "gen_ai.chat"
+    GEN_AI_EXECUTE_TOOL = "gen_ai.execute_tool"
+    GEN_AI_HANDOFF = "gen_ai.handoff"
+    GEN_AI_INVOKE_AGENT = "gen_ai.invoke_agent"
     GRAPHQL_EXECUTE = "graphql.execute"
     GRAPHQL_MUTATION = "graphql.mutation"
     GRAPHQL_PARSE = "graphql.parse"
@@ -1026,4 +1181,4 @@ DEFAULT_OPTIONS = _get_default_options()
 del _get_default_options
 
 
-VERSION = "2.30.0"
+VERSION = "2.32.0"