entity_events
Creates, updates, deletes, gets or lists an entity_events resource.
Overview
| Name | entity_events |
| Type | Resource |
| Id | aws.application_signals.entity_events |
Fields
The following fields are returned by SELECT queries:
- list_entity_events
| Name | Datatype | Description |
|---|---|---|
account_id | string | The Amazon Web Services account ID where this change event occurred. (pattern: <code>[0-9]{12}</code>) |
change_event_type | string | The type of change event that occurred, such as DEPLOYMENT. (DEPLOYMENT, CONFIGURATION) |
entity | object | The entity (service or resource) that was affected by this change event, including its key attributes. This is a string-to-string map. It can include the following fields. Type designates the type of object this is. ResourceType specifies the type of the resource. This field is used only when the value of the Type field is Resource or AWS::Resource. Name specifies the name of the object. This is used only if the value of the Type field is Service, RemoteService, or AWS::Service. Identifier identifies the resource objects of this resource. This is used only if the value of the Type field is Resource or AWS::Resource. Environment specifies the location where this object is hosted, or what it belongs to. AwsAccountId specifies the account where this object is in. Below is an example of a service. { "Type": "Service", "Name": "visits-service", "Environment": "petclinic-test" } Below is an example of a resource. { "Type": "AWS::Resource", "ResourceType": "AWS::DynamoDB::Table", "Identifier": "Customers" } |
event_id | string | A unique identifier for this change event. For CloudTrail-based events, this is the CloudTrail event id. For other events, this will be Unknown. |
event_name | string | The name or description of this change event. |
region | string | The Amazon Web Services region where this change event occurred. |
timestamp | string (date-time) | The timestamp when this change event occurred. When used in a raw HTTP Query API, it is formatted as epoch time in seconds. |
user_name | string | The name of the user who initiated this change event, if available. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_entity_events | select | region | MaxResults, NextToken | Returns a list of change events for a specific entity, such as deployments, configuration changes, or other state-changing activities. This operation helps track the history of changes that may have affected service performance. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
MaxResults | integer | The maximum number of change events to return in one operation. If you omit this parameter, the default of 50 is used. |
NextToken | string | Include this value, if it was returned by the previous operation, to get the next set of change events. |
SELECT examples
- list_entity_events
Returns a list of change events for a specific entity, such as deployments, configuration changes, or other state-changing activities. This operation helps track the history of changes that may have affected service performance.
SELECT
account_id,
change_event_type,
entity,
event_id,
event_name,
region,
timestamp,
user_name
FROM aws.application_signals.entity_events
WHERE region = '{{ region }}' -- required
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;