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:

from typing import (

AbstractSet,

Any,

Callable,

Dict,

List,

Optional,

Sequence,

Tuple,

Type,

Union,

)

from typing_extensions import Literal, TypedDict

import sentry_sdk

from sentry_sdk._types import (

BreadcrumbProcessor,

ContinuousProfilerMode,

Event,

EventProcessor,

Hint,

IgnoreSpansConfig,

Log,

Metric,

ProfilerMode,

TracesSampler,

TransactionProcessor,

)

# 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",

{

"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],

"transport_async": 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]]],

"trace_lifecycle": Optional[Literal["static", "stream"]],

"ignore_spans": Optional[IgnoreSpansConfig],

"suppress_asgi_chained_exceptions": Optional[bool],

},

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) -> str:

return self.value

class INSTRUMENTER:

SENTRY = "sentry"

OTEL = "otel"

class SPANNAME:

DB_COMMIT = "COMMIT"

DB_ROLLBACK = "ROLLBACK"

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"

"""

.. deprecated::

This attribute is deprecated. Use CODE_FILE_PATH instead.

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_FILE_PATH = "code.file.path"

"""

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"

"""

.. deprecated::

This attribute is deprecated. Use CODE_FUNCTION_NAME instead.

The method or function name, or equivalent (usually rightmost part of the code unit's name).

Example: "server_request"

"""

CODE_FUNCTION_NAME = "code.function.name"

"""

The method or function name, or equivalent (usually rightmost part of the code unit's name).

Example: "server_request"

"""

CODE_LINENO = "code.lineno"

"""

.. deprecated::

This attribute is deprecated. Use CODE_LINE_NUMBER instead.

The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`.

Example: 42

"""

CODE_LINE_NUMBER = "code.line.number"

"""

The line number in `code.file.path` best representing the operation. It SHOULD point within the code unit named in `code.function.name`.

Example: 42

"""

CODE_NAMESPACE = "code.namespace"

"""

.. deprecated::

This attribute is deprecated. Use CODE_FUNCTION_NAME instead; the namespace should be included within the function name.

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"

"""

.. deprecated::

This attribute is deprecated. Use DB_NAMESPACE instead.

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_NAMESPACE = "db.namespace"

"""

The name of the database being accessed.

Example: "customers"

"""

DB_DRIVER_NAME = "db.driver.name"

"""

The name of the database driver being used for the connection.

Example: "psycopg2"

"""

DB_OPERATION = "db.operation"

"""

.. deprecated::

This attribute is deprecated. Use DB_OPERATION_NAME instead.

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_OPERATION_NAME = "db.operation.name"

"""

The name of the operation being executed.

Example: "SELECT"

"""

DB_SYSTEM = "db.system"

"""

.. deprecated::

This attribute is deprecated. Use DB_SYSTEM_NAME instead.

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_SYSTEM_NAME = "db.system.name"

"""

An identifier for the database management system (DBMS) product being used. See OpenTelemetry's list of well-known DBMS identifiers.

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_CONVERSATION_ID = "gen_ai.conversation.id"

"""

The unique identifier for the conversation/thread with the AI model.

Example: "conv_abc123"

"""

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_FUNCTION_ID = "gen_ai.function_id"

"""

Framework-specific tracing label for the execution of a function or other unit of execution in a generative AI system.

Example: "my-awesome-function"

"""

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"

"""

.. deprecated::

This attribute is deprecated. Use GEN_AI_OUTPUT_MESSAGES instead.

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_OUTPUT_MESSAGES = "gen_ai.output.messages"

"""

The model's response messages. It has to be a stringified version of an array of message objects, which can include text responses and tool calls.

Example: [{"role": "assistant", "parts": [{"type": "text", "content": "The weather in Paris is currently rainy with a temperature of 57°F."}], "finish_reason": "stop"}]

"""

GEN_AI_RESPONSE_TIME_TO_FIRST_TOKEN = "gen_ai.response.time_to_first_token"

"""

The time it took to receive the first token from the model.

Example: 0.1

"""

GEN_AI_RESPONSE_TOOL_CALLS = "gen_ai.response.tool_calls"

"""

.. deprecated::

This attribute is deprecated. Use GEN_AI_OUTPUT_MESSAGES instead.

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"

"""

.. deprecated::

This attribute is deprecated. Use GEN_AI_TOOL_DEFINITIONS instead.

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_TOOL_DEFINITIONS = "gen_ai.tool.definitions"

"""

The list of source system tool definitions available to the GenAI agent or model.

Example: [{"type": "function", "name": "get_current_weather", "description": "Get the current weather in a given location", "parameters": {"type": "object", "properties": {"location": {"type": "string", "description": "The city and state, e.g. San Francisco, CA"}, "unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}}, "required": ["location", "unit"]}}]

"""

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_SYSTEM_INSTRUCTIONS = "gen_ai.system_instructions"

"""

The system instructions passed to the model.

Example: [{"type": "text", "text": "You are a helpful assistant."},{"type": "text", "text": "Be concise and clear."}]

"""

GEN_AI_REQUEST_MESSAGES = "gen_ai.request.messages"

"""

.. deprecated::

This attribute is deprecated. Use GEN_AI_INPUT_MESSAGES instead.

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_INPUT_MESSAGES = "gen_ai.input.messages"

"""

The messages passed to the model. It has to be a stringified version of an array of objects. Role values must be "user", "assistant", "tool", or "system".

Example: [{"role": "user", "parts": [{"type": "text", "content": "Weather in Paris?"}]}, {"role": "assistant", "parts": [{"type": "tool_call", "id": "call_VSPygqKTWdrhaFErNvMV18Yl", "name": "get_weather", "arguments": {"location": "Paris"}}]}, {"role": "tool", "parts": [{"type": "tool_call_response", "id": "call_VSPygqKTWdrhaFErNvMV18Yl", "result": "rainy, 57°F"}]}]

"""

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"

"""

.. deprecated::

This attribute is deprecated. Use GEN_AI_PROVIDER_NAME instead.

The name of the AI system being used.

Example: "openai"

"""

GEN_AI_PROVIDER_NAME = "gen_ai.provider.name"

"""

The Generative AI provider as identified by the client or server instrumentation.

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"

"""

.. deprecated::

This attribute is deprecated. Use GEN_AI_TOOL_CALL_ARGUMENTS instead.

The input of the tool being used.

Example: {"location": "Paris"}

"""

GEN_AI_TOOL_CALL_ARGUMENTS = "gen_ai.tool.call.arguments"

"""

The arguments of the tool call. It has to be a stringified version of the arguments to the tool.

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"

"""

.. deprecated::

This attribute is deprecated. Use GEN_AI_TOOL_CALL_RESULT instead.

The output of the tool being used.

Example: "rainy, 57°F"

"""

GEN_AI_TOOL_CALL_RESULT = "gen_ai.tool.call.result"

"""

The result of the tool call. It has to be a stringified version of the result of the tool.

Example: "rainy, 57°F"

"""

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_INPUT_TOKENS_CACHE_WRITE = "gen_ai.usage.input_tokens.cache_write"

"""

The number of tokens written to the cache when processing the AI input (prompt).

Example: 100

"""

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"

"""

.. deprecated::

This attribute is deprecated. Use HTTP_REQUEST_METHOD instead.

The HTTP method used.

Example: GET

"""

HTTP_REQUEST_METHOD = "http.request.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"

"""

PROCESS_PID = "process.pid"

"""

The process ID of the running process.

Example: 12345

"""

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"

"""

URL_FULL = "url.full"

"""

The URL of the resource that was fetched.

Example: "https://example.com/test?foo=bar#buzz"

"""

URL_FRAGMENT = "url.fragment"

"""

The fragments present in the URI. Note that this does not contain the leading # character, while the `http.fragment` attribute does.

Example: "details"

"""

URL_QUERY = "url.query"

"""

The query string present in the URL. Note that this does not contain the leading ? character, while the `http.query` attribute does.

Example: "foo=bar&bar=baz"

"""

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"

"""