

# Using Neptune Event Notification
Event Notifications

**Topics**
+ [

# Amazon Neptune event categories and event messages
](event-lists.md)
+ [

# Subscribing to Neptune event notification
](events-subscribing.md)
+ [

# Managing Neptune event notification subscriptions
](events-manage.md)

Amazon Neptune uses Amazon Simple Notification Service (Amazon SNS) to provide notifications when a Neptune event occurs. These notifications can be in any form that is supported by Amazon SNS for an AWS Region, such as an email, a text message, or a call to an HTTP endpoint.

Neptune groups these events into categories that you can subscribe to so that you can be notified when an event in that category occurs. You can subscribe to an event category for a DB instance, DB cluster, DB snapshot, DB cluster snapshot, or for a DB parameter group. For example, if you subscribe to the Backup category for a given DB instance, you are notified whenever a backup-related event occurs that affects the DB instance. You also receive notification when an event notification subscription changes.

Events occur at both the DB cluster and the DB instance level, so you can receive events if you subscribe to a DB cluster or a DB instance.

Event notifications are sent to the addresses you provide when you create the subscription. You might want to create several different subscriptions, such as a subscription that receives all event notifications and another subscription that includes only critical events for your production DB instances. You can easily turn off notification without deleting a subscription. To do so, set the **Enabled** radio button to **No** in the Neptune console.

**Important**  
Amazon Neptune doesn't guarantee the order of events sent in an event stream. The event order is subject to change.

Neptune uses the Amazon Resource Name (ARN) of an Amazon SNS topic to identify each subscription. The Neptune console creates the ARN for you when you create the subscription. 

Billing for Neptune event notification is through Amazon SNS. Amazon SNS fees apply when using event notification. For more information, see [ Amazon Simple Notification Service Pricing](https://aws.amazon.com/sns/#pricing).

# Amazon Neptune event categories and event messages
Categories and messages

Neptune generates a significant number of events in categories that you can subscribe to using the Neptune console. Each category applies to a source type, which can be a DB instance, DB snapshot, or DB parameter group.

**Note**  
Neptune uses existing Amazon RDS event definitions and IDs.

## Neptune events originating from DB instances
DB instance events

The following table shows a list of events by event category when a DB instance is the source type.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/neptune/latest/userguide/event-lists.html)

## Neptune events originating from a DB cluster
DB cluster events

The following table shows a list of events by event category when a DB cluster is the source type.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/neptune/latest/userguide/event-lists.html)

## Neptune events originating from DB cluster snapshot
DB cluster snapshot events

The following table shows the event category and a list of events when a Neptune DB cluster snapshot is the source type.


| Category | RDS event ID | Description | 
| --- | --- | --- | 
| backup | RDS-EVENT-0074 | Creation of a manual DB cluster snapshot has started. | 
| backup | RDS-EVENT-0075 | A manual DB cluster snapshot has been created. | 
| notification | RDS-EVENT-0162 | DB cluster snapshot export task failed. | 
| notification | RDS-EVENT-0163 | DB cluster snapshot export task canceled. | 
| notification | RDS-EVENT-0164 | DB cluster snapshot export task completed. | 
| backup | RDS-EVENT-0168 | Creating automated cluster snapshot. | 
| backup | RDS-EVENT-0169 | Automated cluster snapshot created. | 
| creation | RDS-EVENT-0170 | DB cluster created. | 
| deletion | RDS-EVENT-0171 | DB cluster deleted. | 
| notification | RDS-EVENT-0172 | Renamed DB cluster from [old DB cluster name] to [new DB cluster name]. | 

## Neptune events originating from DB cluster parameter group
Parameter group events

The following table shows the event category and a list of events when a DB cluster parameter group is the source type.


| Category | RDS event ID | Description | 
| --- | --- | --- | 
| configuration change | RDS-EVENT-0037 | The parameter group was modified. | 

## Neptune events originating from a security group
Security group events

The following table shows the event category and a list of events when a security group is the source type.


| Category | RDS event ID | Description | 
| --- | --- | --- | 
| configuration change | RDS-EVENT-0038 | The security group has been modified. | 
| failure | RDS-EVENT-0039 | The security group owned by [user] does not exist; authorization for the security group has been revoked. | 

# Subscribing to Neptune event notification
Subscribing to events

You can use the Neptune console to subscribe to event notifications, as follows:

**To subscribe to Neptune event notification**

1. Sign in to the AWS Management Console, and open the Amazon Neptune console at [https://console.aws.amazon.com/neptune/home](https://console.aws.amazon.com/neptune/home).

1. In the navigation pane, choose **Event subscriptions**. 

1. In the **Event subscriptions** pane, choose **Create event subscription**. 

1. In the **Create event subscription** dialog box, do the following:

   1. For **Name**, enter a name for the event notification subscription.

   1. For **Send notifications to**, choose an existing Amazon SNS ARN for an Amazon SNS topic, or choose **create topic** to enter the name of a topic and a list of recipients.

   1. For **Source type**, choose a source type.

   1. Choose **Yes** to enable the subscription. If you want to create the subscription but to not have notifications sent yet, choose **No**.

   1. Depending on the source type you selected, choose the event categories and the sources that you want to receive event notifications from.

   1. Choose **Create**.

# Managing Neptune event notification subscriptions
Manage subscriptions

If you choose **Event subscriptions** in the navigation pane of the Neptune console, you can view subscription categories and a list of your current subscriptions.

 You can also modify or delete a specific subscription.

## Modifying Neptune event notification subscriptions
Modify a subscriptions

**To modify your current Neptune event notification subscriptions**

1. Sign in to the AWS Management Console, and open the Amazon Neptune console at [https://console.aws.amazon.com/neptune/home](https://console.aws.amazon.com/neptune/home).

1. In the navigation pane, choose **Event subscriptions**. The **Event subscriptions** pane shows all your event notification subscriptions.

1. In the **Event subscriptions** pane, choose the subscription that you want to modify and choose **Edit**.

1. Make your changes to the subscription in either the **Target** or **Source** section. You can add or remove source identifiers by selecting or deselecting them in the **Source** section.

1. Choose **Edit**. The Neptune console indicates that the subscription is being modified.

## Deleting a Neptune event notification subscription
Delete a subscription

You can delete a subscription when you no longer need it. All subscribers to the topic will no longer receive event notifications specified by the subscription.

**To delete an Neptune event notification subscription**

1. Sign in to the AWS Management Console, and open the Amazon Neptune console at [https://console.aws.amazon.com/neptune/home](https://console.aws.amazon.com/neptune/home).

1. In the navigation pane, choose **Event subscriptions**.

1. In the **Event subscriptions** pane, choose the subscription that you want to delete.

1. Choose **Delete**.

1. The Neptune console indicates that the subscription is being deleted.