Faas Attributes

21 attributes in this category.19 stable·2 deprecated

Scrubbing Visibility OTel

21 attributes

Stable Attributes

`faas.coldstart`

booleanScrub: ManualVisibility: PublicOTel: True

A boolean that is true if the serverless function is executed for the first time (aka cold-start).

Exampletrue

Changelog

v0.0.0

Raw JSON

{
  "key": "faas.coldstart",
  "brief": "A boolean that is true if the serverless function is executed for the first time (aka cold-start).",
  "type": "boolean",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": true,
  "changelog": [
    {
      "version": "0.0.0"
    }
  ]
}

`faas.cron`

stringScrub: ManualVisibility: PublicOTel: True

A string containing the schedule period as Cron Expression.

Example0/5 * * * ? *

Changelog

v0.1.0#127

v0.0.0

Raw JSON

{
  "key": "faas.cron",
  "brief": "A string containing the schedule period as Cron Expression.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "0/5 * * * ? *",
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        127
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`faas.document.collection`

stringScrub: ManualVisibility: PublicOTel: True

The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name.

ExamplesmyBucketNamemyDbName

Changelog

v0.31.0#747Added faas.document.collection attribute

Raw JSON

{
  "key": "faas.document.collection",
  "brief": "The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "examples": [
    "myBucketName",
    "myDbName"
  ],
  "changelog": [
    {
      "version": "0.31.0",
      "prs": [
        747
      ],
      "description": "Added faas.document.collection attribute"
    }
  ]
}

`faas.document.name`

stringScrub: AutoVisibility: PublicOTel: True

The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name.

ExamplesmyFile.txtmyTableName

Changelog

v0.31.0#747Added faas.document.name attribute

Raw JSON

{
  "key": "faas.document.name",
  "brief": "The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name.",
  "type": "string",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": true,
  "visibility": "public",
  "examples": [
    "myFile.txt",
    "myTableName"
  ],
  "changelog": [
    {
      "version": "0.31.0",
      "prs": [
        747
      ],
      "description": "Added faas.document.name attribute"
    }
  ]
}

`faas.document.operation`

stringScrub: ManualVisibility: PublicOTel: True

Describes the type of the operation that was performed on the data.

Examplesinserteditdelete

Additional Context

Has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
delete: When an object is deleted.
edit: When an object is modified.
insert: When a new object is created.

Changelog

v0.31.0#747Added faas.document.operation attribute

Raw JSON

{
  "key": "faas.document.operation",
  "brief": "Describes the type of the operation that was performed on the data.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "examples": [
    "insert",
    "edit",
    "delete"
  ],
  "additional_context": [
    "Has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.",
    "`delete`: When an object is deleted.",
    "`edit`: When an object is modified.",
    "`insert`: When a new object is created."
  ],
  "changelog": [
    {
      "version": "0.31.0",
      "prs": [
        747
      ],
      "description": "Added faas.document.operation attribute"
    }
  ]
}

`faas.document.time`

stringScrub: ManualVisibility: PublicOTel: True

A string containing the time when the data was accessed in the ISO 8601 format expressed in UTC.

Examples2020-01-23T13:47:06Z

Changelog

v0.31.0#747Added faas.document.time attribute

Raw JSON

{
  "key": "faas.document.time",
  "brief": "A string containing the time when the data was accessed in the ISO 8601 format expressed in UTC.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "examples": [
    "2020-01-23T13:47:06Z"
  ],
  "changelog": [
    {
      "version": "0.31.0",
      "prs": [
        747
      ],
      "description": "Added faas.document.time attribute"
    }
  ]
}

`faas.duration_in_ms`

integerScrub: ManualVisibility: PublicOTel: False

The duration a function took to run, in milliseconds.

Example120

Changelog

v0.11.0#403

Raw JSON

{
  "key": "faas.duration_in_ms",
  "brief": "The duration a function took to run, in milliseconds.",
  "type": "integer",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 120,
  "changelog": [
    {
      "version": "0.11.0",
      "prs": [
        403
      ]
    }
  ]
}

`faas.entry_point`

stringScrub: ManualVisibility: PublicOTel: False

The code that's run when the cloud provider invokes your function.

Examplemy_main_function

Changelog

v0.11.0#403 #415

Raw JSON

{
  "key": "faas.entry_point",
  "brief": "The code that's run when the cloud provider invokes your function.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "my_main_function",
  "changelog": [
    {
      "version": "0.11.0",
      "prs": [
        403,
        415
      ]
    }
  ]
}

`faas.identity`

stringScrub: ManualVisibility: PublicOTel: False

The Service Account (GCP), IAM Execution Role (AWS), or Managed Identity (Azure) used by the serverless function when interacting with other cloud services

Example

name@project.iam.gserviceaccount.com (GCP), arn:aws:iam::123456789012:role/role-name (AWS), 00000000-0000-0000-0000-000000000000 (Azure)

Changelog

v0.11.0#403

Raw JSON

{
  "key": "faas.identity",
  "brief": "The Service Account (GCP), IAM Execution Role (AWS), or Managed Identity (Azure) used by the serverless function when interacting with other cloud services",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "name@project.iam.gserviceaccount.com (GCP), arn:aws:iam::123456789012:role/role-name (AWS), 00000000-0000-0000-0000-000000000000 (Azure)",
  "changelog": [
    {
      "version": "0.11.0",
      "prs": [
        403
      ]
    }
  ]
}

`faas.instance`

stringScrub: ManualVisibility: PublicOTel: True

The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version.

Examples2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de

Additional Context

For AWS Lambda, use the (full) log stream name.

Changelog

v0.31.0#748Added faas.instance attribute

Raw JSON

{
  "key": "faas.instance",
  "brief": "The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "examples": [
    "2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de"
  ],
  "additional_context": [
    "For AWS Lambda, use the (full) log stream name."
  ],
  "changelog": [
    {
      "version": "0.31.0",
      "prs": [
        748
      ],
      "description": "Added faas.instance attribute"
    }
  ]
}

`faas.invocation_id`

stringScrub: ManualVisibility: PublicOTel: True

The invocation ID of the current function invocation.

Exampleaf9d5aa4-a685-4c5f-a22b-444f80b3cc28

Aliasesaws.lambda.aws_request_idfaas.execution

Changelog

v0.16.0#473Added faas.execution as an alias

v0.11.1#414 #424

Raw JSON

{
  "key": "faas.invocation_id",
  "brief": "The invocation ID of the current function invocation.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "af9d5aa4-a685-4c5f-a22b-444f80b3cc28",
  "alias": [
    "aws.lambda.aws_request_id",
    "faas.execution"
  ],
  "changelog": [
    {
      "version": "0.16.0",
      "prs": [
        473
      ],
      "description": "Added faas.execution as an alias"
    },
    {
      "version": "0.11.1",
      "prs": [
        414,
        424
      ]
    }
  ]
}

`faas.invoked_name`

stringScrub: ManualVisibility: PublicOTel: True

The name of the invoked function.

Examplemy-function

Changelog

v0.16.0#481Added faas.invoked_name attribute

Raw JSON

{
  "key": "faas.invoked_name",
  "brief": "The name of the invoked function.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "my-function",
  "changelog": [
    {
      "version": "0.16.0",
      "prs": [
        481
      ],
      "description": "Added faas.invoked_name attribute"
    }
  ]
}

`faas.invoked_provider`

stringScrub: ManualVisibility: PublicOTel: True

The cloud provider of the invoked function.

Exampleaws

Changelog

v0.16.0#481Added faas.invoked_provider attribute

Raw JSON

{
  "key": "faas.invoked_provider",
  "brief": "The cloud provider of the invoked function.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "aws",
  "changelog": [
    {
      "version": "0.16.0",
      "prs": [
        481
      ],
      "description": "Added faas.invoked_provider attribute"
    }
  ]
}

`faas.invoked_region`

stringScrub: ManualVisibility: PublicOTel: True

The cloud region of the invoked function.

Exampleeu-central-1

Changelog

v0.16.0#481Added faas.invoked_region attribute

Raw JSON

{
  "key": "faas.invoked_region",
  "brief": "The cloud region of the invoked function.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "eu-central-1",
  "changelog": [
    {
      "version": "0.16.0",
      "prs": [
        481
      ],
      "description": "Added faas.invoked_region attribute"
    }
  ]
}

`faas.max_memory`

integerScrub: ManualVisibility: PublicOTel: True

The amount of memory available to the serverless function, in bytes.

Examples1342177281073741824

Additional Context

On AWS Lambda, multiply AWS_LAMBDA_FUNCTION_MEMORY_SIZE by 1,048,576 to convert the configured memory from MiB to bytes.

Changelog

v0.30.0#715Added faas.max_memory attribute

Raw JSON

{
  "key": "faas.max_memory",
  "brief": "The amount of memory available to the serverless function, in bytes.",
  "type": "integer",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "examples": [
    134217728,
    1073741824
  ],
  "additional_context": [
    "On AWS Lambda, multiply AWS_LAMBDA_FUNCTION_MEMORY_SIZE by 1,048,576 to convert the configured memory from MiB to bytes."
  ],
  "changelog": [
    {
      "version": "0.30.0",
      "prs": [
        715
      ],
      "description": "Added faas.max_memory attribute"
    }
  ]
}

`faas.name`

stringScrub: ManualVisibility: PublicOTel: True

The name of the serverless function

Examplemy_function

Aliasesaws.lambda.function_name

Changelog

v0.11.0#403 #415

Raw JSON

{
  "key": "faas.name",
  "brief": "The name of the serverless function",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "my_function",
  "alias": [
    "aws.lambda.function_name"
  ],
  "changelog": [
    {
      "version": "0.11.0",
      "prs": [
        403,
        415
      ]
    }
  ]
}

`faas.time`

stringScrub: ManualVisibility: PublicOTel: True

A string containing the function invocation time in the ISO 8601 format expressed in UTC.

Example2020-01-23T13:47:06Z

Changelog

v0.1.0#127

v0.0.0

Raw JSON

{
  "key": "faas.time",
  "brief": "A string containing the function invocation time in the ISO 8601 format expressed in UTC.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "2020-01-23T13:47:06Z",
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        127
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`faas.trigger`

stringScrub: ManualVisibility: PublicOTel: True

Type of the trigger which caused this function invocation.

Exampletimer

Changelog

v0.1.0#127

v0.0.0

Raw JSON

{
  "key": "faas.trigger",
  "brief": "Type of the trigger which caused this function invocation.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "timer",
  "changelog": [
    {
      "version": "0.1.0",
      "prs": [
        127
      ]
    },
    {
      "version": "0.0.0"
    }
  ]
}

`faas.version`

stringScrub: ManualVisibility: PublicOTel: True

The version of the function that was invoked

Example$LATEST

Aliasesaws.lambda.function_version

Changelog

v0.11.1#414 #424

Raw JSON

{
  "key": "faas.version",
  "brief": "The version of the function that was invoked",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": true,
  "visibility": "public",
  "example": "$LATEST",
  "alias": [
    "aws.lambda.function_version"
  ],
  "changelog": [
    {
      "version": "0.11.1",
      "prs": [
        414,
        424
      ]
    }
  ]
}

Deprecated Attributes

These attributes are deprecated and should not be used in new code. See each attribute for migration guidance.

`faas.execution`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The execution ID of the current function execution.

Exampleaf9d5aa4-a685-4c5f-a22b-444f80b3cc28

Aliasesfaas.invocation_idaws.lambda.aws_request_id

Use faas.invocation_id instead.

This attribute is being deprecated in favor of faas.invocation_id, which is the OTel-aligned replacement.

Status: backfill

Changelog

v0.16.0#473Added faas.execution attribute, deprecated in favor of faas.invocation_id

Raw JSON

{
  "key": "faas.execution",
  "brief": "The execution ID of the current function execution.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "af9d5aa4-a685-4c5f-a22b-444f80b3cc28",
  "deprecation": {
    "replacement": "faas.invocation_id",
    "reason": "This attribute is being deprecated in favor of faas.invocation_id, which is the OTel-aligned replacement.",
    "_status": "backfill"
  },
  "alias": [
    "faas.invocation_id",
    "aws.lambda.aws_request_id"
  ],
  "changelog": [
    {
      "version": "0.16.0",
      "prs": [
        473
      ],
      "description": "Added faas.execution attribute, deprecated in favor of faas.invocation_id"
    }
  ]
}

`faas.id`Deprecated

stringScrub: ManualVisibility: PublicOTel: False

The unique ID of the single function that this runtime instance executes.

Examplearn:aws:lambda:REGION:ACCOUNT_ID:function:my-function

Aliasescloud.resource_id

Use cloud.resource_id instead.

This attribute is being deprecated in favor of cloud.resource_id, which is the OTel-aligned replacement (renamed in OTel semantic conventions v1.19.0).

Status: backfill

Changelog

v0.16.0#475Added faas.id attribute, deprecated in favor of cloud.resource_id

Raw JSON

{
  "key": "faas.id",
  "brief": "The unique ID of the single function that this runtime instance executes.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function",
  "deprecation": {
    "replacement": "cloud.resource_id",
    "reason": "This attribute is being deprecated in favor of cloud.resource_id, which is the OTel-aligned replacement (renamed in OTel semantic conventions v1.19.0).",
    "_status": "backfill"
  },
  "alias": [
    "cloud.resource_id"
  ],
  "changelog": [
    {
      "version": "0.16.0",
      "prs": [
        475
      ],
      "description": "Added faas.id attribute, deprecated in favor of cloud.resource_id"
    }
  ]
}

Faas Attributes

Stable Attributes

Deprecated Attributes

faas.executionDeprecated

faas.idDeprecated

`faas.execution`Deprecated

`faas.id`Deprecated