# LogQueryLanguage

Logs Query Language.

- Source: [`aws-cloudwatch/lib/log-query.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-cloudwatch/lib/log-query.ts#L33)
- Type last changed: v2.205.0 · 15 Jul 2025

## Example

TypeScript:

```ts
declare const dashboard: cloudwatch.Dashboard;

dashboard.addWidgets(new cloudwatch.LogQueryWidget({
  logGroupNames: ['my-log-group'],
  view: cloudwatch.LogQueryVisualizationType.TABLE,
  queryString: "SELECT count(*) as count FROM 'my-log-group'",
  queryLanguage: cloudwatch.LogQueryLanguage.SQL,
}));
```

Python:

```python
# dashboard: cloudwatch.Dashboard

dashboard.add_widgets(cloudwatch.LogQueryWidget(
    log_group_names=["my-log-group"],
    view=cloudwatch.LogQueryVisualizationType.TABLE,
    query_string="SELECT count(*) as count FROM 'my-log-group'",
    query_language=cloudwatch.LogQueryLanguage.SQL
))
```

Java:

```java
Dashboard dashboard;

dashboard.addWidgets(LogQueryWidget.Builder.create()
        .logGroupNames(List.of("my-log-group"))
        .view(LogQueryVisualizationType.TABLE)
        .queryString("SELECT count(*) as count FROM 'my-log-group'")
        .queryLanguage(LogQueryLanguage.SQL)
        .build());
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
Dashboard dashboard;

dashboard.AddWidgets(new LogQueryWidget(new LogQueryWidgetProps {
    LogGroupNames = new [] { "my-log-group" },
    View = LogQueryVisualizationType.TABLE,
    QueryString = "SELECT count(*) as count FROM 'my-log-group'",
    QueryLanguage = LogQueryLanguage.SQL
}));
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var dashboard Dashboard

dashboard.AddWidgets(cloudwatch.NewLogQueryWidget(&LogQueryWidgetProps{
	LogGroupNames: []*string{
		jsii.String("my-log-group"),
	},
	View: cloudwatch.LogQueryVisualizationType_TABLE,
	QueryString: jsii.String("SELECT count(*) as count FROM 'my-log-group'"),
	QueryLanguage: cloudwatch.LogQueryLanguage_SQL,
}))
```

## Members

| Member | Description |
| --- | --- |
| `LOGS_INSIGHTS` | Logs Insights QL. |
| `SQL` | OpenSearch SQL. |
| `PPL` | OpenSearch PPL. |

## Referenced by

- [`LogQueryWidgetProps`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_cloudwatch.LogQueryWidgetProps.html).queryLanguage
