# LogConfig

Logging configuration for AppSync.

- Source: [`aws-appsync/lib/graphqlapi.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-appsync/lib/graphqlapi.ts#L221)
- Type last changed: v2.224.0 · 13 Nov 2025

## Example

TypeScript:

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

new appsync.GraphqlApi(this, 'api', {
  authorizationConfig: {},
  name: 'myApi',
  definition: appsync.Definition.fromFile(path.join(__dirname, 'myApi.graphql')),
  logConfig: {
    fieldLogLevel: appsync.FieldLogLevel.INFO,
    retention: logs.RetentionDays.ONE_WEEK,
  },
});
```

Python:

```python
import aws_cdk.aws_logs as logs

appsync.GraphqlApi(self, "api",
    authorization_config=appsync.AuthorizationConfig(),
    name="myApi",
    definition=appsync.Definition.from_file(path.join(__dirname, "myApi.graphql")),
    log_config=appsync.LogConfig(
        field_log_level=appsync.FieldLogLevel.INFO,
        retention=logs.RetentionDays.ONE_WEEK
    )
)
```

Java:

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

GraphqlApi.Builder.create(this, "api")
        .authorizationConfig(AuthorizationConfig.builder().build())
        .name("myApi")
        .definition(Definition.fromFile(join(__dirname, "myApi.graphql")))
        .logConfig(LogConfig.builder()
                .fieldLogLevel(FieldLogLevel.INFO)
                .retention(RetentionDays.ONE_WEEK)
                .build())
        .build();
```

C# / .NET:

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

new GraphqlApi(this, "api", new GraphqlApiProps {
    AuthorizationConfig = new AuthorizationConfig { },
    Name = "myApi",
    Definition = Definition.FromFile(Join(__dirname, "myApi.graphql")),
    LogConfig = new LogConfig {
        FieldLogLevel = FieldLogLevel.INFO,
        Retention = RetentionDays.ONE_WEEK
    }
});
```

Golang:

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

appsync.NewGraphqlApi(this, jsii.String("api"), &GraphqlApiProps{
	AuthorizationConfig: &AuthorizationConfig{
	},
	Name: jsii.String("myApi"),
	Definition: appsync.Definition_FromFile(path.join(__dirname, jsii.String("myApi.graphql"))),
	LogConfig: &LogConfig{
		FieldLogLevel: appsync.FieldLogLevel_INFO,
		Retention: logs.RetentionDays_ONE_WEEK,
	},
})
```

## Properties

- `excludeVerboseContent`: boolean | [IResolvable](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) = false — exclude verbose content.

- `fieldLogLevel`: [FieldLogLevel](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_appsync.FieldLogLevel.html) — log level for fields.

  **Default:** Use AppSync default

- `retention`: [RetentionDays](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_logs.RetentionDays.html) = RetentionDays.INFINITE — The number of days log events are kept in CloudWatch Logs.

  By default AppSync keeps the logs infinitely. When updating this property,
  unsetting it doesn't remove the log retention policy.
  To remove the retention policy, set the value to `INFINITE`

- `role`: [IRoleRef](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_iam.IRoleRef.html) = None — The role for CloudWatch Logs.
