AWS CDK Reference

Appearance

v2.274.0

QueryDefinitionProps Struct ​

Properties for a QueryDefinition.

Source
aws-logs/lib/query-definition.ts
Type last changed
v2.235.0 · 15 Jan 2026

Example ​

ts
new logs.QueryDefinition(this, 'QueryDefinition', {
  queryDefinitionName: 'MyQuery',
  queryString: new logs.QueryString({
    fields: ['@timestamp', '@message'],
    parseStatements: [
      '@message "[*] *" as loggingType, loggingMessage',
      '@message "<*>: *" as differentLoggingType, differentLoggingMessage',
    ],
    filterStatements: [
      'loggingType = "ERROR"',
      'loggingMessage = "A very strange error occurred!"',
    ],
    statsStatements: [
      'count(loggingMessage) as loggingErrors',
      'count(differentLoggingMessage) as differentLoggingErrors',
    ],
    sort: '@timestamp desc',
    limit: 20,
  }),
});

Properties ​

logGroupsILogGroupRef[]log_groupstyping.List[ILogGroupRef]logGroupsList<ILogGroupRef>LogGroupsILogGroupRef[]LogGroups*[]ILogGroupRef= no specified log groups#
Specify certain log groups for the query definition.
queryDefinitionNamestringquery_definition_namestrqueryDefinitionNameStringQueryDefinitionNamestringQueryDefinitionName*stringrequired#
Name of the query definition.
queryStringQueryStringquery_stringQueryStringqueryStringQueryStringQueryStringQueryStringQueryStringQueryStringrequired#
The query string to use for this query definition.