Monitoring Neptune Using Amazon CloudWatch - Amazon Neptune
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Monitoring Neptune Using Amazon CloudWatch

Amazon Neptune and Amazon CloudWatch are integrated so that you can gather and analyze performance metrics. You can monitor these metrics using the CloudWatch console, the Amazon Command Line Interface (Amazon CLI), or the CloudWatch API.

CloudWatch also lets you set alarms so that you can be notified if a metric value breaches a threshold that you specify. You can even set up CloudWatch Events to take corrective action if a breach occurs. For more information about using CloudWatch and alarms, see the CloudWatch Documentation.

Viewing CloudWatch Data (Console)

To view CloudWatch data for a Neptune cluster (console)
  1. Sign in to the Amazon Web Services Management Console and open the CloudWatch console at

  2. In the navigation pane, choose Metrics.

  3. In the All Metrics pane, choose Neptune, and then choose DBClusterIdentifier.

  4. In the upper pane, scroll down to view the full list of metrics for your cluster. The available Neptune metric options appear in the Viewing list.

To select or deselect an individual metric, in the results pane, select the check box next to the resource name and metric. Graphs showing the metrics for the selected items appear at the bottom of the console. To learn more about CloudWatch graphs, see Graph Metrics in the Amazon CloudWatch User Guide.

Viewing CloudWatch Data (Amazon CLI)

To view CloudWatch data for a Neptune cluster (Amazon CLI)
  1. Install the Amazon CLI. For instructions, see the Amazon Command Line Interface User Guide.

  2. Use the Amazon CLI to fetch information. The relevant CloudWatch parameters for Neptune are listed in Neptune CloudWatch Metrics.

    The following example retrieves CloudWatch metrics for the number of Gremlin requests per second for the gremlin-cluster cluster.

    aws cloudwatch get-metric-statistics \ --namespace AWS/Neptune --metric-name GremlinRequestsPerSec \ --dimensions Name=DBClusterIdentifier,Value=gremlin-cluster \ --start-time 2018-03-03T00:00:00Z --end-time 2018-03-04T00:00:00Z \ --period 60 --statistics=Average

Viewing CloudWatch Data (API)

CloudWatch also supports a Query action so that you can request information programmatically. For more information, see the CloudWatch Query API documentation and Amazon CloudWatch API Reference.

When a CloudWatch action requires a parameter that is specific to Neptune monitoring, such as MetricName, use the values listed in Neptune CloudWatch Metrics.

The following example shows a low-level CloudWatch request, using the following parameters:

  • Statistics.member.1 = Average

  • Dimensions.member.1 = DBClusterIdentifier=gremlin-cluster

  • Namespace = AWS/Neptune

  • StartTime = 2013-11-14T00:00:00Z

  • EndTime = 2013-11-16T00:00:00Z

  • Period = 60

  • MetricName = GremlinRequestsPerSec

Here is what the CloudWatch request looks like. However, this is just to show the form of the request; you must construct your own request based on your metrics and timeframe. ?SignatureVersion=2 &Action=GremlinRequestsPerSec &Version=2010-08-01 &StartTime=2018-03-03T00:00:00 &EndTime=2018-03-04T00:00:00 &Period=60 &Statistics.member.1=Average &Dimensions.member.1=DBClusterIdentifier=gremlin-cluster &Namespace=AWS/Neptune &MetricName=GremlinRequests &Timestamp=2018-03-04T17%3A48%3A21.746Z &AWSAccessKeyId=Amazon Access Key ID; &Signature=signature