# LogOptions

Log Options for the state machine.

- Source: [`custom-resources/lib/provider-framework/waiter-state-machine.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/custom-resources/lib/provider-framework/waiter-state-machine.ts#L15)
- Type last changed: v2.235.0 · 15 Jan 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_stepfunctions as stepfunctions } from 'aws-cdk-lib';
import { custom_resources } from 'aws-cdk-lib';
import { aws_logs as interfaces_logs } from 'aws-cdk-lib/interfaces';

declare const logGroupRef: interfaces_logs.ILogGroupRef;
const logOptions: custom_resources.LogOptions = {
  destination: logGroupRef,
  includeExecutionData: false,
  level: stepfunctions.LogLevel.OFF,
};
```

## Properties

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

  **Default:** a new log group will be created

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

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