Faas Attributes

15 attributes in this category. 13 stable · 2 deprecated

Scrubbing Visibility OTel

15 attributes

Stable Attributes

`faas.coldstart`

boolean Scrub: Manual Visibility: Public OTel: True

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

Example true

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`

string Scrub: Manual Visibility: Public OTel: True

A string containing the schedule period as Cron Expression.

Example 0/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.duration_in_ms`

integer Scrub: Manual Visibility: Public OTel: False

The duration a function took to run, in milliseconds.

Example 120

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`

string Scrub: Manual Visibility: Public OTel: False

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

Example my_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`

string Scrub: Manual Visibility: Public OTel: 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.invocation_id`

string Scrub: Manual Visibility: Public OTel: True

The invocation ID of the current function invocation.

Example af9d5aa4-a685-4c5f-a22b-444f80b3cc28

Aliases aws.lambda.aws_request_idfaas.execution

Changelog

v0.16.0 #473 Added 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`

string Scrub: Manual Visibility: Public OTel: True

The name of the invoked function.

Example my-function

Changelog

v0.16.0 #481 Added 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`

string Scrub: Manual Visibility: Public OTel: True

The cloud provider of the invoked function.

Example aws

Changelog

v0.16.0 #481 Added 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`

string Scrub: Manual Visibility: Public OTel: True

The cloud region of the invoked function.

Example eu-central-1

Changelog

v0.16.0 #481 Added 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.name`

string Scrub: Manual Visibility: Public OTel: True

The name of the serverless function

Example my_function

Aliases aws.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`

string Scrub: Manual Visibility: Public OTel: True

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

Example 2020-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`

string Scrub: Manual Visibility: Public OTel: True

Type of the trigger which caused this function invocation.

Example timer

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`

string Scrub: Manual Visibility: Public OTel: True

The version of the function that was invoked

Example $LATEST

Aliases aws.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

string Scrub: Manual Visibility: Public OTel: False

The execution ID of the current function execution.

Example af9d5aa4-a685-4c5f-a22b-444f80b3cc28

Aliases faas.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 #473 Added 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

string Scrub: Manual Visibility: Public OTel: False

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

Example arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function

Aliases cloud.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 #475 Added 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.execution Deprecated

faas.id Deprecated

`faas.execution` Deprecated

`faas.id` Deprecated