# LogOptions

Defines what execution history events are logged and where they are logged.

- Source: [`aws-stepfunctions/lib/state-machine.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/aws-cdk-lib/aws-stepfunctions/lib/state-machine.ts#L70)
- Type last changed: v2.235.0 · 15 Jan 2026

## Example

TypeScript:

```ts
import * as logs from 'aws-cdk-lib/aws-logs';

const logGroup = new logs.LogGroup(this, 'MyLogGroup');

const definition = sfn.Chain.start(new sfn.Pass(this, 'Pass'));

new sfn.StateMachine(this, 'MyStateMachine', {
  definitionBody: sfn.DefinitionBody.fromChainable(definition),
  logs: {
    destination: logGroup,
    level: sfn.LogLevel.ALL,
  },
});
```

Python:

```python
import aws_cdk.aws_logs as logs

log_group = logs.LogGroup(self, "MyLogGroup")

definition = sfn.Chain.start(sfn.Pass(self, "Pass"))

sfn.StateMachine(self, "MyStateMachine",
    definition_body=sfn.DefinitionBody.from_chainable(definition),
    logs=sfn.LogOptions(
        destination=log_group,
        level=sfn.LogLevel.ALL
    )
)
```

Java:

```java
import software.amazon.awscdk.services.logs.*;

LogGroup logGroup = new LogGroup(this, "MyLogGroup");

Chain definition = Chain.start(new Pass(this, "Pass"));

StateMachine.Builder.create(this, "MyStateMachine")
        .definitionBody(DefinitionBody.fromChainable(definition))
        .logs(LogOptions.builder()
                .destination(logGroup)
                .level(LogLevel.ALL)
                .build())
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
using Amazon.CDK.AWS.Logs;

var logGroup = new LogGroup(this, "MyLogGroup");

var definition = Chain.Start(new Pass(this, "Pass"));

new StateMachine(this, "MyStateMachine", new StateMachineProps {
    DefinitionBody = DefinitionBody.FromChainable(definition),
    Logs = new LogOptions {
        Destination = logGroup,
        Level = LogLevel.ALL
    }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
import logs "github.com/aws/aws-cdk-go/awscdk"

logGroup := logs.NewLogGroup(this, jsii.String("MyLogGroup"))

definition := sfn.Chain_Start(sfn.NewPass(this, jsii.String("Pass")))

sfn.NewStateMachine(this, jsii.String("MyStateMachine"), &StateMachineProps{
	DefinitionBody: sfn.DefinitionBody_FromChainable(definition),
	Logs: &LogOptions{
		Destination: logGroup,
		Level: sfn.LogLevel_ALL,
	},
})
```

## Properties

- `destination`: [ILogGroupRef](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_logs.ILogGroupRef.html) — The log group where the execution history events will be logged.

  **Default:** No log group. Required if your log level is not set to OFF.

- `includeExecutionData`: boolean = false — Determines whether execution data is included in your log.

- `level`: [LogLevel](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_stepfunctions.LogLevel.html) = ERROR — Defines which category of execution history events are logged.
