# Amazon Ground Station events
<a name="events-ref-groundstation"></a>

Amazon Ground Station sends service events directly to EventBridge, as well as via Amazon CloudTrail.

## Amazon Ground Station service events
<a name="events-ref-groundstation-events"></a>

Amazon Ground Station sends the following events directly to EventBridge: 
+ Ground Station Contact State Change
+ Ground Station Dataflow Endpoint Group State Change
+ Ground Station Ephemeris Status Change
+ Ground Station S3 Upload Complete
+ Ground Station Dataflow Endpoint Group Health Status Change

*Delivery type*: [ Best effort ](event-delivery-level.md) 

To match against all events from this service, create an event pattern that matches against the following event attribute:
+ `source`: aws.groundstation

```
{
  "source": ["aws.groundstation"]
}
```

To match against specific events, include a `detail-type` attribute specifying an array of event names to match. For example:

```
{
  "source": ["aws.groundstation"],
  "detail-type": ["Ground Station Contact State Change"]
}
```

For more information, see [Creating event patterns](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-event-patterns.html#eb-create-pattern) in the *Amazon EventBridge User Guide*.

## Amazon Ground Station events delivered via Amazon CloudTrail
<a name="event-ref-groundstation-events-via-CT"></a>

Amazon CloudTrail sends events originating from Amazon Ground Station to EventBridge. Amazon services deliver events to CloudTrail on a [best effort](event-delivery-level.md) basis. For more information, see [Amazon service events delivered via Amazon CloudTrail](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-service-event-cloudtrail.html) in the *Amazon EventBridge User Guide*.

To match events from this service delivered by Amazon CloudTrail, create an event pattern that matches against the following event attributes:
+ `source`: aws.groundstation
+ `eventSource`: groundstation.amazonaws.com

```
{
  "source": ["aws.groundstation"],
  "detail-type": ["Amazon API Call via CloudTrail"],
  "detail": {
    "eventSource": ["groundstation.amazonaws.com"]
  }
}
```

To match against a specific API calls from this service, include an `eventName` attribute specifying an array of API calls to match:

```
{
  "source": ["aws.groundstation"],
  "detail-type": ["Amazon API Call via CloudTrail"],
  "detail": {
    "eventSource": ["groundstation.amazonaws.com"],
    "eventName": ["api-action-name"]
  }
}
```