SemanticAttributes

This attribute represents the state the application has transitioned into at the occurrence of the event.

Notes: - The Android lifecycle states are defined in <a href="https://developer.android.com/guide/components/activities/activity-lifecycle#lc">Activity lifecycle callbacks, and from which the `OS identifiers` are derived.

The full invoked ARN as provided on the Context passed to the function (Lambda-Runtime-Invoked-Function-Arn header on the /runtime/invocation/next applicable).

Notes: - This may be different from cloud.resource_id if an alias is involved.

The source object (in the form bucket/key) for the copy operation.

Notes: - The copy_source attribute applies to S3 copy operations and corresponds to the --copy-source parameter of the <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/copy-object.html">copy-object operation within the S3 API. This applies in particular to the following operations: - copy-object

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/upload-part-copy.html">upload-part-copy

The delete request container that specifies the objects to be deleted.

Notes: - The delete attribute is only applicable to the <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-object.html">delete-object operation. The `delete` attribute corresponds to the `--delete` parameter of the delete-objects operation within the S3 API.

The S3 object key the request refers to. Corresponds to the --key parameter of the <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html">S3 API operations. Notes: - The `key` attribute is applicable to all object-related S3 operations, i.e. that require the object key as a mandatory parameter. This applies in particular to the following operations: - copy-object

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-object.html">delete-object - get-object

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/head-object.html">head-object - put-object

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/restore-object.html">restore-object - select-object-content

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/abort-multipart-upload.html">abort-multipart-upload - complete-multipart-upload

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/create-multipart-upload.html">create-multipart-upload - list-parts

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/upload-part.html">upload-part - upload-part-copy

The part number of the part being uploaded in a multipart-upload operation. This is a positive integer between 1 and 10,000.

Notes: - The part_number attribute is only applicable to the <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/upload-part.html">upload-part and upload-part-copy operations. The part_number attribute corresponds to the --part-number parameter of the <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/upload-part.html">upload-part operation within the S3 API.

Upload ID that identifies the multipart upload.

Notes: - The upload_id attribute applies to S3 multipart-upload operations and corresponds to the --upload-id parameter of the <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html">S3 API multipart operations. This applies in particular to the following operations: - abort-multipart-upload

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/complete-multipart-upload.html">complete-multipart-upload - list-parts

- <a href="https://docs.aws.amazon.com/cli/latest/reference/s3api/upload-part.html">upload-part - upload-part-copy

Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.

Notes: - When observed from the server side, and when communicating through an intermediary, client.address SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.

Client port number.

Notes: - When observed from the server side, and when communicating through an intermediary, client.port SHOULD represent the client port behind any intermediaries, for example proxies, if it's available.

The name of the primary table that the operation is acting upon, including the keyspace name (if applicable).

Notes: - This mirrors the db.sql.table attribute but references cassandra rather than sql. It is not recommended to attempt any client-side parsing of db.statement just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.

This attribute is used to report 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).

Notes: - In some SQL databases, the database name to be used is called "schema name". In case there are multiple layers that could be considered for database name (e.g. Oracle instance name and schema name), the database name to be used is the more specific layer (e.g. Oracle schema name).

The name of the primary table that the operation is acting upon, including the database name (if applicable).

Notes: - It is not recommended to attempt any client-side parsing of db.statement just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.

Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.

Notes: - When observed from the source side, and when communicating through an intermediary, destination.address SHOULD represent the destination address behind any intermediaries, for example proxies, if it's available.

Describes a class of error the operation ended with.

Notes: - The error.type SHOULD be predictable and SHOULD have low cardinality. Instrumentations SHOULD document the list of errors they report. - The cardinality of error.type within one instrumentation library SHOULD be low. Telemetry consumers that aggregate data from multiple instrumentation libraries and applications should be prepared for error.type to have high cardinality at query time when no additional filters are applied. - If the operation has completed successfully, instrumentations SHOULD NOT set error.type. - If a specific domain defines its own set of error identifiers (such as HTTP or gRPC status codes), it's RECOMMENDED to: - Use a domain-specific attribute

- Set error.type to capture all errors, regardless of whether they are defined within the domain-specific set or not.

The domain identifies the business context for the events.

Notes: - Events across different domains may have same event.name, yet be unrelated events.

SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span.

Notes: - An exception is considered to have escaped (or left) the scope of a span, if that span is ended while the exception is still logically "in flight". This may be actually "in flight" in some languages (e.g. if the exception is passed to a Context manager's exit method in Python) but will usually be caught at the point of recording the exception in most languages. - It is usually not possible to determine at the point where an exception is thrown whether it will escape the scope of a span. However, it is trivial to know that an exception will escape, if one checks for an active exception just before ending the span, as done in the <a href="#recording-an-exception">example above. - It follows that an exception may still escape the scope of the span even if the `exception.escaped` attribute was not set or set to false, since the event might have been recorded at a time where it was not clear whether the exception will escape.

The name of an event describing an exception.

Typically an event with that name should not be manually created. Instead org.typelevel.otel4s.trace.Span#recordException(Throwable) should be used.

The name of the invoked function.

Notes: - SHOULD be equal to the faas.name resource attribute of the invoked function.

The cloud provider of the invoked function.

Notes: - SHOULD be equal to the cloud.provider resource attribute of the invoked function.

The cloud region of the invoked function.

Notes: - SHOULD be equal to the cloud.region resource attribute of the invoked function.

SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used.

Notes: - A semantic identifier, commonly referred to as a variant, provides a means for referring to a value without including the value itself. This can provide additional context for understanding the meaning behind a value. For example, the variant red maybe be used for the value #c05543. - A stringified version of the value can be used in situations where a semantic identifier is unavailable. String representation of the value should be determined by the implementer.