@salesforce/cli 2.159.1 → 2.159.2

package/node_modules/@opentelemetry/semantic-conventions/dist/stable_attributes.cjs

@@ -119,7 +119,7 @@ const ATTR_ASPNETCORE_USER_IS_AUTHENTICATED = "aspnetcore.user.is_authenticated"
 * @example 10.1.2.80
 * @example /tmp/my.sock
 *
-* @note 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.
+* @note 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.
 */
 const ATTR_CLIENT_ADDRESS = "client.address";
 /**
@@ -127,7 +127,7 @@ const ATTR_CLIENT_ADDRESS = "client.address";
 *
 * @example 65123
 *
-* @note 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.
+* @note 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.
 */
 const ATTR_CLIENT_PORT = "client.port";
 /**
@@ -217,8 +217,9 @@ const ATTR_CONTAINER_IMAGE_TAGS = "container.image.tags";
 * when the database system supports query text with multiple collections
 * in non-batch operations.
 *
-* For batch operations, if the individual operations are known to have the same
-* collection name then that collection name **SHOULD** be used.
+* For batch operations, if the individual operations would all have the same
+* `db.collection.name` when executed as non-batch operations,
+* then that collection name **SHOULD** be used.
 */
 const ATTR_DB_COLLECTION_NAME = "db.collection.name";
 /**
@@ -280,9 +281,10 @@ const ATTR_DB_OPERATION_BATCH_SIZE = "db.operation.batch.size";
 * If spaces can occur in the operation name, multiple consecutive spaces
 * **SHOULD** be normalized to a single space.
 *
-* For batch operations, if the individual operations are known to have the same operation name
-* then that operation name **SHOULD** be used prepended by `BATCH `,
-* otherwise `db.operation.name` **SHOULD** be `BATCH` or some other database
+* For batch operations, if the individual operations would all have the same
+* `db.operation.name` when executed as non-batch operations,
+* then that operation name **SHOULD** be used prepended by `BATCH `.
+* Otherwise, `db.operation.name` **SHOULD** be `BATCH` or some other database
 * system specific term if more applicable.
 */
 const ATTR_DB_OPERATION_NAME = "db.operation.name";
@@ -303,9 +305,10 @@ const ATTR_DB_OPERATION_NAME = "db.operation.name";
 * [Generating query summary](/docs/db/database-spans.md#generating-a-summary-of-the-query)
 * section.
 *
-* For batch operations, if the individual operations are known to have the same query summary
-* then that query summary **SHOULD** be used prepended by `BATCH `,
-* otherwise `db.query.summary` **SHOULD** be `BATCH` or some other database
+* For batch operations, if the individual operations would all have the same
+* `db.query.summary` when executed as non-batch operations,
+* then that query summary **SHOULD** be used prepended by `BATCH `.
+* Otherwise, `db.query.summary` **SHOULD** be `BATCH` or some other database
 * system specific term if more applicable.
 */
 const ATTR_DB_QUERY_SUMMARY = "db.query.summary";
@@ -316,7 +319,7 @@ const ATTR_DB_QUERY_SUMMARY = "db.query.summary";
 * @example SET mykey ?
 *
 * @note For sanitization see [Sanitization of `db.query.text`](/docs/db/database-spans.md#sanitization-of-dbquerytext).
-* For batch operations, if the individual operations are known to have the same query text then that query text **SHOULD** be used, otherwise all of the individual query texts **SHOULD** be concatenated with separator `; ` or some other database system specific separator if more applicable.
+* For batch operations, if the individual operations would all have the same `db.query.text` when executed as non-batch operations, then that query text **SHOULD** be used. Otherwise, all of the individual query texts **SHOULD** be concatenated with separator `; ` or some other database system specific separator if more applicable.
 * Parameterized query text **SHOULD NOT** be sanitized. Even though parameterized query text can potentially have sensitive data, by using a parameterized query the user is giving a strong signal that any sensitive data will be passed as parameter values, and the benefit to observability of capturing the static part of the query text by default outweighs the risk.
 */
 const ATTR_DB_QUERY_TEXT = "db.query.text";
@@ -329,6 +332,7 @@ const ATTR_DB_QUERY_TEXT = "db.query.text";
 * @example 404
 *
 * @note The status code returned by the database. Usually it represents an error code, but may also represent partial success, warning, or differentiate between various types of successful outcomes.
+* The value **MAY** use a standardized string representation of a numeric status code, if one exists, instead of the numeric code. The value **MAY** be a synthetic status provided by the client library rather than returned by the remote service.
 * Semantic conventions for individual database systems **SHOULD** document what `db.response.status_code` means in the context of that system.
 */
 const ATTR_DB_RESPONSE_STATUS_CODE = "db.response.status_code";
@@ -340,8 +344,9 @@ const ATTR_DB_RESPONSE_STATUS_CODE = "db.response.status_code";
 * @note It is **RECOMMENDED** to capture the value as provided by the application
 * without attempting to do any case normalization.
 *
-* For batch operations, if the individual operations are known to have the same
-* stored procedure name then that stored procedure name **SHOULD** be used.
+* For batch operations, if the individual operations would all have the same
+* `db.stored_procedure.name` when executed as non-batch operations,
+* then that stored procedure name **SHOULD** be used.
 */
 const ATTR_DB_STORED_PROCEDURE_NAME = "db.stored_procedure.name";
 /**
@@ -1405,6 +1410,74 @@ const OTEL_STATUS_CODE_VALUE_OK = "OK";
 */
 const ATTR_OTEL_STATUS_DESCRIPTION = "otel.status_description";
 /**
+* The fully-qualified logical name of the method from the RPC interface perspective.
+*
+* @example com.example.ExampleService/exampleMethod
+* @example EchoService/Echo
+* @example _OTHER
+*
+* @note The method name **MAY** have unbounded cardinality in edge or error cases.
+*
+* Some RPC frameworks or libraries provide a fixed set of recognized methods
+* for client stubs and server implementations. Instrumentations for such
+* frameworks **MUST** set this attribute to the original method name only
+* when the method is recognized by the framework or library.
+*
+* When the method is not recognized, for example, when the server receives
+* a request for a method that is not predefined on the server, or when
+* instrumentation is not able to reliably detect if the method is predefined,
+* the attribute **MUST** be set to `_OTHER`.
+*
+* If the RPC instrumentation could end up converting valid RPC methods to
+* `_OTHER`, then it **SHOULD** provide a way to configure the list of recognized
+* RPC methods.
+*
+* The `rpc.method` can be different from the name of any implementing
+* method/function.
+* The `code.function.name` attribute may be used to record the fully-qualified
+* method actually executing the call on the server side, or the
+* RPC client stub method on the client side.
+*/
+const ATTR_RPC_METHOD = "rpc.method";
+/**
+* The original name of the method used by the client.
+*
+* @example com.myservice.EchoService/catchAll
+* @example com.myservice.EchoService/unknownMethod
+* @example InvalidMethod
+*/
+const ATTR_RPC_METHOD_ORIGINAL = "rpc.method_original";
+/**
+* Status code of the RPC returned by the RPC server or generated by the client
+*
+* @example OK
+* @example DEADLINE_EXCEEDED
+* @example -32602
+*
+* @note Usually it represents an error code, but may also represent partial success, warning, or differentiate between various types of successful outcomes.
+* The value **MAY** use a standardized string representation of a numeric status code, if one exists, instead of the numeric code. The value **MAY** be a synthetic status provided by the client library rather than returned by the remote service.
+* Semantic conventions for individual RPC frameworks **SHOULD** document what `rpc.status_code` means in the context of that system and which values are considered to represent errors.
+*/
+const ATTR_RPC_STATUS_CODE = "rpc.status_code";
+/**
+* The Remote Procedure Call (RPC) system.
+*
+* @note The client and server RPC systems may differ for the same RPC interaction. For example, a client may use Apache Dubbo or Connect RPC to communicate with a server that uses gRPC since both protocols provide compatibility with gRPC.
+*/
+const ATTR_RPC_SYSTEM_NAME = "rpc.system.name";
+/**
+* Enum value "dubbo" for attribute {@link ATTR_RPC_SYSTEM_NAME}.
+*
+* [Apache Dubbo](https://dubbo.apache.org/)
+*/
+const RPC_SYSTEM_NAME_VALUE_DUBBO = "dubbo";
+/**
+* Enum value "grpc" for attribute {@link ATTR_RPC_SYSTEM_NAME}.
+*
+* [gRPC](https://grpc.io/)
+*/
+const RPC_SYSTEM_NAME_VALUE_GRPC = "grpc";
+/**
 * Server domain name if available without reverse DNS lookup; otherwise, IP address or UNIX domain socket name.
 *
 * @example example.com
@@ -1676,9 +1749,15 @@ const ATTR_URL_FRAGMENT = "url.fragment";
 *   - [`X-Amz-Signature`](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)
 *   - [`X-Amz-Credential`](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)
 *   - [`X-Amz-Security-Token`](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)
+*   - [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/developerguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+*   - [`Signature`](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-creating-signed-url-canned-policy.html)
 *   - [`sig`](https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token)
 *   - [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
 *
+* Several of these keys are used by more than one service or signing scheme. Each link
+* points to one representative usage rather than an exhaustive list, and does not narrow
+* the scope of the key to the linked service or signing scheme.
+*
 * This list is subject to change over time.
 *
 * Matching of query parameter keys against the sensitive list **SHOULD** be case-sensitive.
@@ -1716,9 +1795,15 @@ const ATTR_URL_PATH = "url.path";
 *   - [`X-Amz-Signature`](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)
 *   - [`X-Amz-Credential`](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)
 *   - [`X-Amz-Security-Token`](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv-authentication-methods.html)
+*   - [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/developerguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+*   - [`Signature`](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/private-content-creating-signed-url-canned-policy.html)
 *   - [`sig`](https://learn.microsoft.com/azure/storage/common/storage-sas-overview#sas-token)
 *   - [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
 *
+* Several of these keys are used by more than one service or signing scheme. Each link
+* points to one representative usage rather than an exhaustive list, and does not narrow
+* the scope of the key to the linked service or signing scheme.
+*
 * This list is subject to change over time.
 *
 * Matching of query parameter keys against the sensitive list **SHOULD** be case-sensitive.
@@ -1864,6 +1949,10 @@ exports.ATTR_OTEL_SCOPE_NAME = ATTR_OTEL_SCOPE_NAME;
 exports.ATTR_OTEL_SCOPE_VERSION = ATTR_OTEL_SCOPE_VERSION;
 exports.ATTR_OTEL_STATUS_CODE = ATTR_OTEL_STATUS_CODE;
 exports.ATTR_OTEL_STATUS_DESCRIPTION = ATTR_OTEL_STATUS_DESCRIPTION;
+exports.ATTR_RPC_METHOD = ATTR_RPC_METHOD;
+exports.ATTR_RPC_METHOD_ORIGINAL = ATTR_RPC_METHOD_ORIGINAL;
+exports.ATTR_RPC_STATUS_CODE = ATTR_RPC_STATUS_CODE;
+exports.ATTR_RPC_SYSTEM_NAME = ATTR_RPC_SYSTEM_NAME;
 exports.ATTR_SERVER_ADDRESS = ATTR_SERVER_ADDRESS;
 exports.ATTR_SERVER_PORT = ATTR_SERVER_PORT;
 exports.ATTR_SERVICE_INSTANCE_ID = ATTR_SERVICE_INSTANCE_ID;
@@ -1924,6 +2013,8 @@ exports.NETWORK_TYPE_VALUE_IPV4 = NETWORK_TYPE_VALUE_IPV4;
 exports.NETWORK_TYPE_VALUE_IPV6 = NETWORK_TYPE_VALUE_IPV6;
 exports.OTEL_STATUS_CODE_VALUE_ERROR = OTEL_STATUS_CODE_VALUE_ERROR;
 exports.OTEL_STATUS_CODE_VALUE_OK = OTEL_STATUS_CODE_VALUE_OK;
+exports.RPC_SYSTEM_NAME_VALUE_DUBBO = RPC_SYSTEM_NAME_VALUE_DUBBO;
+exports.RPC_SYSTEM_NAME_VALUE_GRPC = RPC_SYSTEM_NAME_VALUE_GRPC;
 exports.SIGNALR_CONNECTION_STATUS_VALUE_APP_SHUTDOWN = SIGNALR_CONNECTION_STATUS_VALUE_APP_SHUTDOWN;
 exports.SIGNALR_CONNECTION_STATUS_VALUE_NORMAL_CLOSURE = SIGNALR_CONNECTION_STATUS_VALUE_NORMAL_CLOSURE;
 exports.SIGNALR_CONNECTION_STATUS_VALUE_TIMEOUT = SIGNALR_CONNECTION_STATUS_VALUE_TIMEOUT;