@danieljvdm/dev-kit 1.0.2 → 2.0.0

package/skills/sentry/references/semantics/messaging.md

@@ -0,0 +1,23 @@
+# Messaging attributes
+
+Message queue / pubsub attributes — destination, operation, and message id.
+
+| Key                                          | Type      | Brief                                                                                                                                                                                                                              |
+| -------------------------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `messaging.batch.message_count`              | `integer` | The number of messages sent, received, or processed in the scope of the batching operation.                                                                                                                                        |
+| `messaging.destination.connection`           | `string`  | The message destination connection.                                                                                                                                                                                                |
+| `messaging.destination.name`                 | `string`  | The message destination name.                                                                                                                                                                                                      |
+| `messaging.destination.partition.id`         | `string`  | The identifier of the partition messages are sent to or received from, unique within the messaging.destination.name.                                                                                                               |
+| `messaging.kafka.message.key`                | `string`  | Message keys in Kafka are used for grouping alike messages to ensure they’re processed on the same partition. They differ from messaging.message.id in that they’re not unique. If the key is null, the attribute MUST NOT be set. |
+| `messaging.kafka.message.tombstone`          | `boolean` | A boolean that is true if the message is a tombstone.                                                                                                                                                                              |
+| `messaging.kafka.offset`                     | `integer` | The offset of a record in the corresponding Kafka partition.                                                                                                                                                                       |
+| `messaging.message.body.size`                | `integer` | The size of the message body in bytes.                                                                                                                                                                                             |
+| `messaging.message.conversation_id`          | `string`  | The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called “Correlation ID”.                                                                                         |
+| `messaging.message.envelope.size`            | `integer` | The size of the message body and metadata in bytes.                                                                                                                                                                                |
+| `messaging.message.id`                       | `string`  | A value used by the messaging system as an identifier for the message, represented as a string.                                                                                                                                    |
+| `messaging.message.receive.latency`          | `integer` | The latency between when the message was published and received.                                                                                                                                                                   |
+| `messaging.message.retry.count`              | `integer` | The amount of attempts to send the message.                                                                                                                                                                                        |
+| `messaging.operation.name`                   | `string`  | The name of the messaging operation being performed                                                                                                                                                                                |
+| `messaging.operation.type`                   | `string`  | A string identifying the type of the messaging operation                                                                                                                                                                           |
+| `messaging.rabbitmq.destination.routing_key` | `string`  | RabbitMQ message routing key.                                                                                                                                                                                                      |
+| `messaging.system`                           | `string`  | The messaging system as identified by the client instrumentation.                                                                                                                                                                  |

package/skills/sentry/references/semantics/middleware.md

@@ -0,0 +1,7 @@
+# Middleware attributes
+
+Middleware layer name and ordering attributes.
+
+| Key               | Type     | Brief                       |
+| ----------------- | -------- | --------------------------- |
+| `middleware.name` | `string` | The name of the middleware. |

package/skills/sentry/references/semantics/navigation.md

@@ -0,0 +1,9 @@
+# Navigation attributes
+
+Client-side navigation and route-change attributes.
+
+| Key                   | Type     | Brief                                                                                                                                                         |
+| --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `navigation.origin`   | `string` | The origin of the navigation (usually client side router navigations). Should preferrably parameterized template (like url.template) or a URL path otherwise. |
+| `navigation.route.id` | `string` | The identifier of the matched client-side route, as assigned by the routing framework (e.g., vue-router name, react-router id).                               |
+| `navigation.type`     | `string` | The type of navigation done by a client-side router.                                                                                                          |

package/skills/sentry/references/semantics/nel.md

@@ -0,0 +1,11 @@
+# NEL attributes
+
+Network Error Logging (NEL) report attributes.
+
+| Key                     | Type      | Brief                                                                                                                              |
+| ----------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------- |
+| `nel.elapsed_time`      | `integer` | The elapsed number of milliseconds between the start of the resource fetch and when it was completed or aborted by the user agent. |
+| `nel.phase`             | `string`  | If request failed, the phase of its network error. If request succeeded, “application”.                                            |
+| `nel.referrer`          | `string`  | request’s referrer, as determined by the referrer policy associated with its client.                                               |
+| `nel.sampling_function` | `double`  | The sampling function used to determine if the request should be sampled.                                                          |
+| `nel.type`              | `string`  | If request failed, the type of its network error. If request succeeded, “ok”.                                                      |

package/skills/sentry/references/semantics/network.md

@@ -0,0 +1,17 @@
+# Network attributes
+
+Network transport attributes — protocol, connection type, carrier.
+
+| Key                                 | Type      | Brief                                                                                         |
+| ----------------------------------- | --------- | --------------------------------------------------------------------------------------------- |
+| `network.connection.effective_type` | `string`  | Specifies the effective type of the current connection (e.g. slow-2g, 2g, 3g, 4g).            |
+| `network.connection.rtt`            | `integer` | Specifies the estimated effective round-trip time of the current connection, in milliseconds. |
+| `network.connection.type`           | `string`  | Specifies the type of the current connection (e.g. wifi, ethernet, cellular , etc).           |
+| `network.local.address`             | `string`  | Local address of the network connection - IP address or Unix domain socket name.              |
+| `network.local.port`                | `integer` | Local port number of the network connection.                                                  |
+| `network.peer.address`              | `string`  | Peer address of the network connection - IP address or Unix domain socket name.               |
+| `network.peer.port`                 | `integer` | Peer port number of the network connection.                                                   |
+| `network.protocol.name`             | `string`  | OSI application layer or non-OSI equivalent.                                                  |
+| `network.protocol.version`          | `string`  | The actual version of the protocol used for network communication.                            |
+| `network.transport`                 | `string`  | OSI transport layer or inter-process communication method.                                    |
+| `network.type`                      | `string`  | OSI network layer or non-OSI equivalent.                                                      |

package/skills/sentry/references/semantics/os.md

@@ -0,0 +1,15 @@
+# OS attributes
+
+Operating system name, version, and type attributes.
+
+| Key                  | Type      | Brief                                                                                                                                                                                                   |
+| -------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `os.build_id`        | `string`  | The build ID of the operating system.                                                                                                                                                                   |
+| `os.description`     | `string`  | Human readable (not intended to be parsed) OS version information, like e.g. reported by ver or lsb_release -a commands.                                                                                |
+| `os.kernel_version`  | `string`  | An independent kernel version string. Typically the entire output of the `uname` syscall.                                                                                                               |
+| `os.name`            | `string`  | Human readable operating system name.                                                                                                                                                                   |
+| `os.raw_description` | `string`  | An unprocessed description string obtained by the operating system. For some well-known runtimes, Sentry will attempt to parse `name` and `version` from this string, if they are not explicitly given. |
+| `os.rooted`          | `boolean` | Whether the operating system has been jailbroken or rooted.                                                                                                                                             |
+| `os.theme`           | `string`  | Whether the OS runs in dark mode or light mode.                                                                                                                                                         |
+| `os.type`            | `string`  | The operating system type.                                                                                                                                                                              |
+| `os.version`         | `string`  | The version of the operating system.                                                                                                                                                                    |

package/skills/sentry/references/semantics/otel.md

@@ -0,0 +1,10 @@
+# OpenTelemetry attributes
+
+OpenTelemetry bridge attributes carried into Sentry.
+
+| Key                       | Type     | Brief                                                                                  |
+| ------------------------- | -------- | -------------------------------------------------------------------------------------- |
+| `otel.scope.name`         | `string` | The name of the instrumentation scope - (InstrumentationScope.Name in OTLP).           |
+| `otel.scope.version`      | `string` | The version of the instrumentation scope - (InstrumentationScope.Version in OTLP).     |
+| `otel.status_code`        | `string` | Name of the code, either “OK” or “ERROR”. MUST NOT be set if the status code is UNSET. |
+| `otel.status_description` | `string` | Description of the Status if it has a value, otherwise not set.                        |

package/skills/sentry/references/semantics/params.md

@@ -0,0 +1,7 @@
+# Params attributes
+
+Request or route parameter attributes.
+
+| Key            | Type     | Brief                                                                                                          |
+| -------------- | -------- | -------------------------------------------------------------------------------------------------------------- |
+| `params.<key>` | `string` | Decoded parameters extracted from a URL path. Usually added by client-side routing frameworks like vue-router. |

package/skills/sentry/references/semantics/process.md

@@ -0,0 +1,14 @@
+# Process attributes
+
+Process identity and runtime attributes (pid, executable, command).
+
+| Key                              | Type       | Brief                                                                                                                                                                                              |
+| -------------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `process.command_args`           | `string[]` | All the command arguments (including the command/executable itself) as received by the process.                                                                                                    |
+| `process.executable.name`        | `string`   | The name of the executable that started the process.                                                                                                                                               |
+| `process.pid`                    | `integer`  | The process ID of the running process.                                                                                                                                                             |
+| `process.runtime.description`    | `string`   | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. Equivalent to `raw_description` in the Sentry runtime context. |
+| `process.runtime.engine.name`    | `string`   | The name of the runtime engine.                                                                                                                                                                    |
+| `process.runtime.engine.version` | `string`   | The version of the runtime engine.                                                                                                                                                                 |
+| `process.runtime.name`           | `string`   | The name of the runtime. Equivalent to `name` in the Sentry runtime context.                                                                                                                       |
+| `process.runtime.version`        | `string`   | The version of the runtime of this process, as returned by the runtime without modification. Equivalent to `version` in the Sentry runtime context.                                                |

package/skills/sentry/references/semantics/react.md

@@ -0,0 +1,7 @@
+# React attributes
+
+React component and rendering attributes.
+
+| Key             | Type     | Brief                              |
+| --------------- | -------- | ---------------------------------- |
+| `react.version` | `string` | The version of the React framework |

package/skills/sentry/references/semantics/remix.md

@@ -0,0 +1,7 @@
+# Remix attributes
+
+Remix framework route and loader attributes.
+
+| Key                            | Type     | Brief                                                                                |
+| ------------------------------ | -------- | ------------------------------------------------------------------------------------ |
+| `remix.action_form_data.<key>` | `string` | Remix form data, <key> being the form data key, the value being the form data value. |

package/skills/sentry/references/semantics/resource.md

@@ -0,0 +1,7 @@
+# Resource attributes
+
+Browser resource-load attributes (script, css, image, etc.).
+
+| Key                               | Type     | Brief                                       |
+| --------------------------------- | -------- | ------------------------------------------- |
+| `resource.render_blocking_status` | `string` | The render blocking status of the resource. |

package/skills/sentry/references/semantics/rpc.md

@@ -0,0 +1,10 @@
+# Rpc attributes
+
+Generic RPC system attributes outside gRPC-specific keys.
+
+| Key                        | Type     | Brief                                                                                           |
+| -------------------------- | -------- | ----------------------------------------------------------------------------------------------- |
+| `rpc.method`               | `string` | The fully-qualified logical name of the method from the RPC interface perspective.              |
+| `rpc.response.status_code` | `string` | Status code of the RPC returned by the RPC server or generated by the client.                   |
+| `rpc.service`              | `string` | The full (logical) name of the service being called, including its package name, if applicable. |
+| `rpc.system.name`          | `string` | A string identifying the remoting system.                                                       |

package/skills/sentry/references/semantics/score.md

@@ -0,0 +1,10 @@
+# Score attributes
+
+Score and rating attributes (for example web-vital grades).
+
+| Key                  | Type     | Brief                                                                                                               |
+| -------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
+| `score.<key>`        | `double` | The weighted performance score for a web vital. This is defined as `score.weight.<key>` * `score.ratio.<key>`.      |
+| `score.ratio.<key>`  | `double` | The score for a web vital, normalized to a number between 0 and 1.                                                  |
+| `score.total`        | `double` | The total performance score of a span. This is the sum of individual weighted web vital scores (see `score.<key>`). |
+| `score.weight.<key>` | `double` | The relative weight of a web vital in a span’s performance score.                                                   |

package/skills/sentry/references/semantics/sentry.md

@@ -0,0 +1,69 @@
+# Sentry attributes
+
+Sentry SDK and product attributes (sample rates, origins, mechanism).
+
+| Key                                   | Type       | Brief                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| ------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `sentry.action`                       | `string`   | Used as a generic attribute representing the action depending on the type of span. For instance, this is the database query operation for DB spans, and the request method for HTTP spans.                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `sentry.cancellation_reason`          | `string`   | The reason why a span ended early.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `sentry.category`                     | `string`   | The high-level category of a span, derived from the span operation or span attributes. This categorizes spans by their general purpose (e.g., database, HTTP, UI). Known values include: ‘ai’, ‘ai.pipeline’, ‘app’, ‘browser’, ‘cache’, ‘console’, ‘db’, ‘event’, ‘file’, ‘function.aws’, ‘function.azure’, ‘function.gcp’, ‘function.nextjs’, ‘function.remix’, ‘graphql’, ‘grpc’, ‘http’, ‘measure’, ‘middleware’, ‘navigation’, ‘pageload’, ‘queue’, ‘resource’, ‘rpc’, ‘serialize’, ‘subprocess’, ‘template’, ‘topic’, ‘ui’, ‘ui.angular’, ‘ui.ember’, ‘ui.react’, ‘ui.svelte’, ‘ui.vue’, ‘view’, ‘websocket’. |
+| `sentry.client_sample_rate`           | `double`   | Rate at which a span was sampled in the SDK.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `sentry.description`                  | `string`   | The human-readable description of a span.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `sentry.dist`                         | `string`   | The sentry dist.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `sentry.domain`                       | `string`   | Used as a generic attribute representing the domain depending on the type of span. For instance, this is the collection/table name for database spans, and the server address for HTTP spans.                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `sentry.dsc.environment`              | `string`   | The environment from the dynamic sampling context.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `sentry.dsc.project_id`               | `string`   | The ID of the project where the trace originated (i.e. the project of the SDK that started the trace). Propagated through the dynamic sampling context and set by Relay during ingestion.                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `sentry.dsc.public_key`               | `string`   | The public key from the dynamic sampling context.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `sentry.dsc.release`                  | `string`   | The release identifier from the dynamic sampling context.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `sentry.dsc.sample_rate`              | `string`   | The sample rate from the dynamic sampling context.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `sentry.dsc.sampled`                  | `boolean`  | Whether the event was sampled according to the dynamic sampling context.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sentry.dsc.trace_id`                 | `string`   | The trace ID from the dynamic sampling context.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `sentry.dsc.transaction`              | `string`   | The transaction name from the dynamic sampling context.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.environment`                  | `string`   | The sentry environment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.event.serialized_breadcrumbs` | `string`   | JSON-serialized `breadcrumbs` property from a Sentry event.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `sentry.event.serialized_contexts`    | `string`   | JSON-serialized `contexts` property from a Sentry event.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sentry.event.serialized_extra`       | `string`   | JSON-serialized `extra` property from a Sentry event.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `sentry.event.serialized_meta`        | `string`   | JSON-serialized `_meta` for the `sentry.event.serialized_*` properties from a Sentry event.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `sentry.exclusive_time`               | `double`   | The exclusive time duration of the span in milliseconds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sentry.graphql.operation`            | `string`   | Indicates the type of graphql operation, emitted by the Javascript SDK.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.group`                        | `string`   | Stores the hash of `sentry.normalized_description`. This is primarily used for grouping spans in the product end.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| `sentry.http.prefetch`                | `boolean`  | If an http request was a prefetch request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `sentry.idle_span_finish_reason`      | `string`   | The reason why an idle span ended early.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sentry.is_remote`                    | `boolean`  | Indicates whether a span’s parent is remote.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `sentry.kind`                         | `string`   | Used to clarify the relationship between parents and children, or to distinguish between spans, e.g. a `server` and `client` span with the same name.                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `sentry.main_thread`                  | `boolean`  | Whether the span or event occurred on the main thread. Computed by Relay and should not be set by SDKs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.message.parameter.<key>`      | `string`   | A parameter used in the message template. <key> can either be the number that represent the parameter’s position in the template string (sentry.message.parameter.0, sentry.message.parameter.1, etc) or the parameter’s name (sentry.message.parameter.item_id, sentry.message.parameter.user_id, etc)                                                                                                                                                                                                                                                                                                             |
+| `sentry.message.template`             | `string`   | The parameterized template string.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `sentry.metric.source`                | `string`   | The provenance of a metric. For example, this can be set to indicate if a metric was generated by Relay from a span.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `sentry.mobile`                       | `boolean`  | Whether the application is using a mobile SDK. Computed by Relay and should not be set by SDKs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `sentry.module.<key>`                 | `string`   | A module that was loaded in the process. The key is the name of the module.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `sentry.nextjs.ssr.function.route`    | `string`   | A parameterized route for a function in Next.js that contributes to Server-Side Rendering. Should be present on spans that track such functions when the file location of the function is known.                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| `sentry.nextjs.ssr.function.type`     | `string`   | A descriptor for a for a function in Next.js that contributes to Server-Side Rendering. Should be present on spans that track such functions.                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
+| `sentry.normalized_db_query`          | `string`   | The normalized version of `db.query.text`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `sentry.normalized_db_query.hash`     | `string`   | The hash of `sentry.normalized_db_query`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `sentry.normalized_description`       | `string`   | Used as a generic attribute representing the normalized `sentry.description`. This refers to the legacy use case of `sentry.description` where it holds relevant data depending on the type of span (e.g. database query, resource url, http request description, etc).                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.observed_timestamp_nanos`     | `string`   | The timestamp at which an envelope was received by Relay, in nanoseconds.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `sentry.op`                           | `string`   | The operation of a span.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sentry.origin`                       | `string`   | The origin of the instrumentation (e.g. span, log, etc.)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sentry.pageload.span_id`             | `string`   | The id of the pageload span, set by web vital spans and metrics                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `sentry.platform`                     | `string`   | The sdk platform that generated the event.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `sentry.profile_id`                   | `string`   | The ID of the Sentry profile the span is associated with. This is only meaningful for transaction-based profiling.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `sentry.profiler_id`                  | `string`   | The id of the currently running profiler (continuous profiling)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `sentry.relay.ingress`                | `string`   | How an item (span, log, &c.) entered Relay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `sentry.relay.pipeline`               | `string`   | An internal descriptor of which processing pipeline an item went through in Relay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `sentry.release`                      | `string`   | The sentry release.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `sentry.replay_id`                    | `string`   | The id of the sentry replay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| `sentry.replay_is_buffering`          | `boolean`  | A sentinel attribute on log events indicating whether the current Session Replay is being buffered (onErrorSampleRate).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.sdk.integrations`             | `string[]` | A list of names identifying enabled integrations. The list shouldhave all enabled integrations, including default integrations. Defaultintegrations are included because different SDK releases may contain differentdefault integrations.                                                                                                                                                                                                                                                                                                                                                                          |
+| `sentry.sdk.name`                     | `string`   | The sentry sdk name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `sentry.sdk.version`                  | `string`   | The sentry sdk version.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.segment.id`                   | `string`   | The segment ID of a span                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sentry.segment.name`                 | `string`   | The segment name of a span                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `sentry.segment.name.source`          | `string`   | The source of the segment span name. Should only be set on segment spans. Known values are: `'custom'`, `'url'`, `'route'`, `'component'`, `'view'`, `'task'`.                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| `sentry.server_sample_rate`           | `double`   | Rate at which a span was sampled in Relay.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `sentry.status`                       | `string`   | The span’s status (either “ok” or “error”). Older SDKs may set this to a more specific error, but this behaviour is deprecated.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `sentry.status.message`               | `string`   | The from OTLP extracted status message.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| `sentry.status_code`                  | `integer`  | The HTTP status code used in Sentry Insights. Typically set by Sentry during ingestion, rather than by clients.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `sentry.timestamp.sequence`           | `integer`  | A sequencing counter for deterministic ordering of logs or metrics when timestamps share the same integer millisecond. Starts at 0 on SDK initialization, increments by 1 for each captured item, and resets to 0 when the integer millisecond of the current item differs from the previous one.                                                                                                                                                                                                                                                                                                                   |
+| `sentry.trace.status`                 | `string`   | The segment’s status (either “ok” or “error”). Older SDKs may set this to a more specific error, but this behaviour is deprecated.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `sentry.trace_lifecycle`              | `string`   | Indicates the chosen trace lifecycle mode of the SDK (stream or static)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

package/skills/sentry/references/semantics/server.md

@@ -0,0 +1,8 @@
+# Server attributes
+
+Server address and port for the receiving side of a connection.
+
+| Key              | Type      | Brief                                                                                                         |
+| ---------------- | --------- | ------------------------------------------------------------------------------------------------------------- |
+| `server.address` | `string`  | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. |
+| `server.port`    | `integer` | Server port number.                                                                                           |

package/skills/sentry/references/semantics/service.md

@@ -0,0 +1,8 @@
+# Service attributes
+
+Service name and version attributes for the instrumented unit.
+
+| Key               | Type     | Brief                                                                                                    |
+| ----------------- | -------- | -------------------------------------------------------------------------------------------------------- |
+| `service.name`    | `string` | Logical name of the service.                                                                             |
+| `service.version` | `string` | The version string of the service API or implementation. The format is not defined by these conventions. |

package/skills/sentry/references/semantics/session.md

@@ -0,0 +1,7 @@
+# Session attributes
+
+Session identity attributes for user sessions.
+
+| Key          | Type     | Brief                                                                            |
+| ------------ | -------- | -------------------------------------------------------------------------------- |
+| `session.id` | `string` | A unique id identifying the active session at the time of setting this attribute |

package/skills/sentry/references/semantics/state.md

@@ -0,0 +1,7 @@
+# State attributes
+
+Application or request state attributes.
+
+| Key          | Type     | Brief                                |
+| ------------ | -------- | ------------------------------------ |
+| `state.type` | `string` | The type of state management library |

package/skills/sentry/references/semantics/thread.md

@@ -0,0 +1,8 @@
+# Thread attributes
+
+Thread id and name attributes.
+
+| Key           | Type      | Brief                        |
+| ------------- | --------- | ---------------------------- |
+| `thread.id`   | `integer` | Current “managed” thread ID. |
+| `thread.name` | `string`  | Current thread name.         |

package/skills/sentry/references/semantics/timber.md

@@ -0,0 +1,7 @@
+# Timber attributes
+
+Timber logging framework attributes.
+
+| Key          | Type     | Brief                                                 |
+| ------------ | -------- | ----------------------------------------------------- |
+| `timber.tag` | `string` | The log tag provided by the timber logging framework. |

package/skills/sentry/references/semantics/trpc.md

@@ -0,0 +1,8 @@
+# tRPC attributes
+
+tRPC procedure and path attributes.
+
+| Key                   | Type     | Brief                                       |
+| --------------------- | -------- | ------------------------------------------- |
+| `trpc.procedure_path` | `string` | The path of the tRPC procedure being called |
+| `trpc.procedure_type` | `string` | The type of the tRPC procedure              |

package/skills/sentry/references/semantics/ui.md

@@ -0,0 +1,18 @@
+# UI attributes
+
+UI component and rendering attributes for client interfaces.
+
+| Key                      | Type      | Brief                                                                                |
+| ------------------------ | --------- | ------------------------------------------------------------------------------------ |
+| `ui.component_name`      | `string`  | The name of the associated component.                                                |
+| `ui.contributes_to_ttfd` | `boolean` | Whether the span execution contributed to the TTFD (time to fully drawn) metric.     |
+| `ui.contributes_to_ttid` | `boolean` | Whether the span execution contributed to the TTID (time to initial display) metric. |
+| `ui.element.height`      | `integer` | The height of the UI element (for Html in pixels)                                    |
+| `ui.element.id`          | `string`  | The id of the UI element                                                             |
+| `ui.element.identifier`  | `string`  | The identifier used to measure the UI element timing                                 |
+| `ui.element.load_time`   | `double`  | The loading time of a UI element (from time origin to finished loading)              |
+| `ui.element.paint_type`  | `string`  | The type of element paint. Can either be ‘image-paint’ or ‘text-paint’               |
+| `ui.element.render_time` | `double`  | The rendering time of the UI element (from time origin to finished rendering)        |
+| `ui.element.type`        | `string`  | type of the UI element                                                               |
+| `ui.element.url`         | `string`  | The URL of the UI element (e.g. an img src)                                          |
+| `ui.element.width`       | `integer` | The width of the UI element (for HTML in pixels)                                     |

package/skills/sentry/references/semantics/url.md

@@ -0,0 +1,15 @@
+# Url attributes
+
+URL components — full, path, query, fragment, template.
+
+| Key                        | Type      | Brief                                                                                                                                |
+| -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `url.domain`               | `string`  | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.                        |
+| `url.fragment`             | `string`  | The fragments present in the URI. Note that this does not contain the leading # character, while the `http.fragment` attribute does. |
+| `url.full`                 | `string`  | The URL of the resource that was fetched.                                                                                            |
+| `url.path`                 | `string`  | The URI path component.                                                                                                              |
+| `url.path.parameter.<key>` | `string`  | Decoded parameters extracted from a URL path. Usually added by client-side routing frameworks like vue-router.                       |
+| `url.port`                 | `integer` | Server port number.                                                                                                                  |
+| `url.query`                | `string`  | The query string present in the URL. Note that this does not contain the leading ? character, while the `http.query` attribute does. |
+| `url.scheme`               | `string`  | The URI scheme component identifying the used protocol.                                                                              |
+| `url.template`             | `string`  | The low-cardinality template of an absolute URL path reference.                                                                      |

package/skills/sentry/references/semantics/user.md

@@ -0,0 +1,17 @@
+# User attributes
+
+End-user identity attributes (id, email, username, geo).
+
+| Key                     | Type       | Brief                                                                    |
+| ----------------------- | ---------- | ------------------------------------------------------------------------ |
+| `user.email`            | `string`   | User email address.                                                      |
+| `user.full_name`        | `string`   | User’s full name.                                                        |
+| `user.geo.city`         | `string`   | Human readable city name.                                                |
+| `user.geo.country_code` | `string`   | Two-letter country code (ISO 3166-1 alpha-2).                            |
+| `user.geo.region`       | `string`   | Human readable region name or code.                                      |
+| `user.geo.subdivision`  | `string`   | Human readable subdivision name.                                         |
+| `user.hash`             | `string`   | Unique user hash to correlate information for a user in anonymized form. |
+| `user.id`               | `string`   | Unique identifier of the user.                                           |
+| `user.ip_address`       | `string`   | The IP address of the user.                                              |
+| `user.name`             | `string`   | Short name or login/username of the user.                                |
+| `user.roles`            | `string[]` | Array of user roles at the time of the event.                            |

package/skills/sentry/references/semantics/user_agent.md

@@ -0,0 +1,7 @@
+# User agent attributes
+
+User-agent string and parsed client attributes.
+
+| Key                   | Type     | Brief                                                   |
+| --------------------- | -------- | ------------------------------------------------------- |
+| `user_agent.original` | `string` | Value of the HTTP User-Agent header sent by the client. |

package/skills/sentry/references/semantics/vercel.md

@@ -0,0 +1,42 @@
+# Vercel attributes
+
+Vercel platform and deployment attributes.
+
+| Key                               | Type       | Brief                                                                                  |
+| --------------------------------- | ---------- | -------------------------------------------------------------------------------------- |
+| `vercel.branch`                   | `string`   | Git branch name for Vercel project                                                     |
+| `vercel.build_id`                 | `string`   | Identifier for the Vercel build (only present on build logs)                           |
+| `vercel.deployment_id`            | `string`   | Identifier for the Vercel deployment                                                   |
+| `vercel.destination`              | `string`   | Origin of the external content in Vercel (only on external logs)                       |
+| `vercel.edge_type`                | `string`   | Type of edge runtime in Vercel                                                         |
+| `vercel.entrypoint`               | `string`   | Entrypoint for the request in Vercel                                                   |
+| `vercel.execution_region`         | `string`   | Region where the request is executed                                                   |
+| `vercel.id`                       | `string`   | Unique identifier for the log entry in Vercel                                          |
+| `vercel.ja3_digest`               | `string`   | JA3 fingerprint digest of Vercel request                                               |
+| `vercel.ja4_digest`               | `string`   | JA4 fingerprint digest                                                                 |
+| `vercel.log_type`                 | `string`   | Vercel log output type                                                                 |
+| `vercel.path`                     | `string`   | Function or dynamic path of the request in Vercel.                                     |
+| `vercel.project_id`               | `string`   | Identifier for the Vercel project                                                      |
+| `vercel.project_name`             | `string`   | Name of the Vercel project                                                             |
+| `vercel.proxy.cache_id`           | `string`   | Original request ID when request is served from cache                                  |
+| `vercel.proxy.client_ip`          | `string`   | Client IP address                                                                      |
+| `vercel.proxy.host`               | `string`   | Hostname of the request                                                                |
+| `vercel.proxy.lambda_region`      | `string`   | Region where lambda function executed                                                  |
+| `vercel.proxy.method`             | `string`   | HTTP method of the request                                                             |
+| `vercel.proxy.path`               | `string`   | Request path with query parameters                                                     |
+| `vercel.proxy.path_type`          | `string`   | How the request was served based on its path and project configuration                 |
+| `vercel.proxy.path_type_variant`  | `string`   | Variant of the path type                                                               |
+| `vercel.proxy.referer`            | `string`   | Referer of the request                                                                 |
+| `vercel.proxy.region`             | `string`   | Region where the request is processed                                                  |
+| `vercel.proxy.response_byte_size` | `integer`  | Size of the response in bytes                                                          |
+| `vercel.proxy.scheme`             | `string`   | Protocol of the request                                                                |
+| `vercel.proxy.status_code`        | `integer`  | HTTP status code of the proxy request                                                  |
+| `vercel.proxy.timestamp`          | `integer`  | Unix timestamp when the proxy request was made                                         |
+| `vercel.proxy.user_agent`         | `string[]` | User agent strings of the request                                                      |
+| `vercel.proxy.vercel_cache`       | `string`   | Cache status sent to the browser                                                       |
+| `vercel.proxy.vercel_id`          | `string`   | Vercel-specific identifier                                                             |
+| `vercel.proxy.waf_action`         | `string`   | Action taken by firewall rules                                                         |
+| `vercel.proxy.waf_rule_id`        | `string`   | ID of the firewall rule that matched                                                   |
+| `vercel.request_id`               | `string`   | Identifier of the Vercel request                                                       |
+| `vercel.source`                   | `string`   | Origin of the Vercel log (build, edge, lambda, static, external, or firewall)          |
+| `vercel.status_code`              | `integer`  | HTTP status code of the request (-1 means no response returned and the lambda crashed) |

package/skills/sentry/references/setup-verification.md

@@ -0,0 +1,39 @@
+# Verify an emitted signal
+
+Use this guide when live verification is part of the task and access is available.
+A code-only instrumentation change can report local checks and the remaining live
+verification without provisioning or deploying an environment.
+
+## Exercise the emitting path
+
+Start the application through its normal repository command when needed and
+within scope. Exercise the SDK initialization and the actual changed code path:
+
+- Error capture: a safe existing development trigger or temporary local failure.
+- Tracing: the request or operation that creates the span.
+- Logging or metrics: the path that emits the relevant record.
+- Crons: the job invocation that produces its check-in.
+
+An isolated script that initializes a different SDK instance cannot prove the
+application's wiring. Use a distinctive synthetic marker, preserve useful evidence,
+and remove temporary trigger code when finished. Avoid disrupting live user traffic
+to produce a verification event.
+
+## Inspect the result
+
+Use the available event search or resource lookup to find the matching marker,
+project, environment, and time window. Confirm the signal fields requested, such
+as a span's parent relationship or a log's attributes. For an exception, inspect
+its frames; use [artifact triage](debug-artifacts/index.md) if unreadable frames
+prevent the requested verification. A newly uploaded source map needs a new event.
+
+Allow a bounded ingestion interval, then inspect DSN selection, initialization
+order, sampling, execution evidence, and network delivery. Correct an identified
+query error before retrying. If access is unavailable or the same unexplained
+failure persists, report the evidence and missing boundary rather than polling
+indefinitely or claiming success.
+
+Return the observed result and event link when available. Redact private payloads.
+Changing an issue's status or sending another notification must stay within the
+existing task authorization. Distinguish local wiring, observed ingestion, and
+verification of the released build.