Skip to content
AWS for Query.Farm

aws.devops_guru.list_events

Example SQL Queries

SELECT * FROM
aws.devops_guru.list_events
WHERE
"filters" = 'VALUE';

Description

Returns a list of the events emitted by the resources that are evaluated by DevOps Guru. You can use filters to specify which events are returned.

Table Definition

Column NameColumn Data Type
filters Required Input Column

A ListEventsFilters object used to specify which events to return. 

STRUCT(
    "insight_id" VARCHAR,
    "event_time_range" STRUCT(
        "from_time" TIMESTAMP_S,
        "to_time" TIMESTAMP_S
    ),
    "event_class" VARCHAR,
    "event_source" VARCHAR,
    "data_source" VARCHAR,
    "resource_collection" STRUCT(
        "cloud_formation" STRUCT(
            "stack_names" VARCHAR[]
        ),
        "tags" STRUCT(
            "app_boundary_key" VARCHAR,
            "tag_values" VARCHAR[]
        )[]
    )
)
Show child fields
filters.data_source

The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, of the events you want returned.

filters.event_class

The class of the events you want to filter for, such as an infrastructure change, a deployment, or a schema change.

filters.event_source

The Amazon Web Services source that emitted the events you want to filter for.

filters.event_time_range

A time range during which you want the filtered events to have occurred.

Show child fields
filters.event_time_range.from_time

The time when the event started.

filters.event_time_range.to_time

The time when the event ended.

filters.insight_id

An ID of an insight that is related to the events you want to filter for.

filters.resource_collection

A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.

Show child fields
filters.resource_collection.cloud_formation

An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.

Show child fields
filters.resource_collection.cloud_formation.stack_names[]
filters.resource_collection.tags[]
Show child fields
filters.resource_collection.tags[].app_boundary_key

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

filters.resource_collection.tags[].tag_values[]
account_id Input Column

The ID of the Amazon Web Services account. 

VARCHAR
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "account_id" VARCHAR,
    "via_profile_name" VARCHAR,
    "assumed_role_arn" VARCHAR,
    "organization" STRUCT(
        "account_name" VARCHAR,
        "id" VARCHAR,
        "tags" STRUCT(
            "key" VARCHAR,
            "value" VARCHAR
        )[],
        "master_account" STRUCT(
            "id" VARCHAR,
            "email" VARCHAR
        ),
        "parents" STRUCT(
            "type" VARCHAR,
            "id" VARCHAR,
            "name" VARCHAR,
            "tags" STRUCT(
                "key" VARCHAR,
                "value" VARCHAR
            )[]
        )[]
    )
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

_aws_region Input Column

The AWS region to use.

VARCHAR
data_source

The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, where DevOps Guru analysis found the event. 

VARCHAR
event_class

The class of the event. The class specifies what the event is related to, such as an infrastructure change, a deployment, or a schema change. 

VARCHAR
event_source

The Amazon Web Services source that emitted the event. 

VARCHAR
id

The ID of the event. 

VARCHAR
name

The name of the event. 

VARCHAR
resource_collection

A collection of Amazon Web Services resources supported by DevOps Guru. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks. 

STRUCT(
    "cloud_formation" STRUCT(
        "stack_names" VARCHAR[]
    ),
    "tags" STRUCT(
        "app_boundary_key" VARCHAR,
        "tag_values" VARCHAR[]
    )[]
)
Show child fields
resource_collection.cloud_formation

An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.

Show child fields
resource_collection.cloud_formation.stack_names[]
resource_collection.tags[]
Show child fields
resource_collection.tags[].app_boundary_key

An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.

The string used for a key in a tag that you use to define your resource coverage must begin with the prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or devops-guru-rds-application. When you create a key, the case of characters in the key can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and these act as two different keys. Possible key/value pairs in your application might be Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers.

resource_collection.tags[].tag_values[]
resources

An EventResource object that contains information about the resource that emitted the event. 

STRUCT(
    "type" VARCHAR,
    "name" VARCHAR,
    "arn" VARCHAR
)[]
Show child fields
resources[]
Show child fields
resources[].arn

The Amazon Resource Name (ARN) of the resource that emitted an event.

resources[].name

The name of the resource that emitted an event.

resources[].type

The type of resource that emitted an event.

time

A Timestamp that specifies the time the event occurred. 

TIMESTAMP_S