# AWS Lambda Events

<!-- llms-txt-link: /llms.txt -->

> OpenTelemetry Java agent instrumentation

This library instrumentation provides FaaS spans and messaging spans for AWS Lambda functions handling event types.

- **Name**: `aws-lambda-events-3.11`
- **Scope**: `io.opentelemetry.aws-lambda-events-3.11`
- **Library**: https://docs.aws.amazon.com/lambda/latest/dg/java-handler.html

## Telemetry

### When `default`

**Spans**

| Span kind | Attributes |
| --- | --- |
| CONSUMER | `messaging.destination.name` (STRING), `messaging.message.id` (STRING), `messaging.operation` (STRING), `messaging.system` (STRING) |
| SERVER | `cloud.account.id` (STRING), `cloud.resource_id` (STRING), `faas.invocation_id` (STRING), `faas.trigger` (STRING), `http.request.method` (STRING), `http.response.status_code` (LONG), `url.full` (STRING), `user_agent.original` (STRING) |

### When `otel.instrumentation.common.v3-preview=true`

**Metrics**

| Metric | Instrument | Type | Unit | Description |
| --- | --- | --- | --- | --- |
| `messaging.client.consumed.messages` | counter | LONG_SUM | {message} | Number of messages that were delivered to the application. |
| `messaging.process.duration` | histogram | HISTOGRAM | s | Duration of processing operation. |

| Metric | Attributes |
| --- | --- |
| `messaging.client.consumed.messages` | `messaging.destination.name` (STRING), `messaging.operation.name` (STRING), `messaging.system` (STRING) |
| `messaging.process.duration` | `messaging.destination.name` (STRING), `messaging.operation.name` (STRING), `messaging.system` (STRING) |

**Spans**

| Span kind | Attributes |
| --- | --- |
| CONSUMER | `messaging.batch.message_count` (LONG), `messaging.destination.name` (STRING), `messaging.message.id` (STRING), `messaging.operation.name` (STRING), `messaging.operation.type` (STRING), `messaging.system` (STRING) |
| SERVER | `cloud.account.id` (STRING), `cloud.resource_id` (STRING), `faas.invocation_id` (STRING), `faas.trigger` (STRING), `http.request.method` (STRING), `http.response.status_code` (LONG), `url.full` (STRING), `user_agent.original` (STRING) |

### When `otel.semconv-stability.preview=messaging`

**Metrics**

| Metric | Instrument | Type | Unit | Description |
| --- | --- | --- | --- | --- |
| `messaging.client.consumed.messages` | counter | LONG_SUM | {message} | Number of messages that were delivered to the application. |
| `messaging.process.duration` | histogram | HISTOGRAM | s | Duration of processing operation. |

| Metric | Attributes |
| --- | --- |
| `messaging.client.consumed.messages` | `messaging.destination.name` (STRING), `messaging.operation.name` (STRING), `messaging.system` (STRING) |
| `messaging.process.duration` | `messaging.destination.name` (STRING), `messaging.operation.name` (STRING), `messaging.system` (STRING) |

**Spans**

| Span kind | Attributes |
| --- | --- |
| CONSUMER | `messaging.batch.message_count` (LONG), `messaging.destination.name` (STRING), `messaging.message.id` (STRING), `messaging.operation.name` (STRING), `messaging.operation.type` (STRING), `messaging.system` (STRING) |
| SERVER | `cloud.account.id` (STRING), `cloud.resource_id` (STRING), `faas.invocation_id` (STRING), `faas.trigger` (STRING), `http.request.method` (STRING), `http.response.status_code` (LONG), `url.full` (STRING), `user_agent.original` (STRING) |

### When `otel.semconv-stability.preview=messaging/dup`

**Metrics**

| Metric | Instrument | Type | Unit | Description |
| --- | --- | --- | --- | --- |
| `messaging.client.consumed.messages` | counter | LONG_SUM | {message} | Number of messages that were delivered to the application. |
| `messaging.process.duration` | histogram | HISTOGRAM | s | Duration of processing operation. |

| Metric | Attributes |
| --- | --- |
| `messaging.client.consumed.messages` | `messaging.destination.name` (STRING), `messaging.operation.name` (STRING), `messaging.system` (STRING) |
| `messaging.process.duration` | `messaging.destination.name` (STRING), `messaging.operation.name` (STRING), `messaging.system` (STRING) |

**Spans**

| Span kind | Attributes |
| --- | --- |
| CONSUMER | `messaging.batch.message_count` (LONG), `messaging.destination.name` (STRING), `messaging.message.id` (STRING), `messaging.operation` (STRING), `messaging.operation.name` (STRING), `messaging.operation.type` (STRING), `messaging.system` (STRING) |
| SERVER | `cloud.account.id` (STRING), `cloud.resource_id` (STRING), `faas.invocation_id` (STRING), `faas.trigger` (STRING), `http.request.method` (STRING), `http.response.status_code` (LONG), `url.full` (STRING), `user_agent.original` (STRING) |

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.aws-lambda.flush-timeout` | int | 10000 | Flush timeout in milliseconds. |

## Data

- **JSON (latest)**: [/data/javaagent/instrumentations/aws-lambda-events-3.11/latest.json](/data/javaagent/instrumentations/aws-lambda-events-3.11/latest.json)
- **JSON (pinned)**: [/data/javaagent/instrumentations/aws-lambda-events-3.11/aws-lambda-events-3.11-f545eff904b9.json](/data/javaagent/instrumentations/aws-lambda-events-3.11/aws-lambda-events-3.11-f545eff904b9.json)
- **Explore**: [/java-agent/instrumentation/aws-lambda-events-3.11](/java-agent/instrumentation/aws-lambda-events-3.11)