Amazon Neptune monitoring integration

Access to this feature depends on your subscription level. Requires Infrastructure Pro.

New Relic Infrastructure's integrations include an integration for reporting your Amazon Neptune data to New Relic products. This document explains how to activate this integration and describes the data that can be reported.

Activate integration

To enable this integration, follow standard procedures to connect AWS services to Infrastructure.

Configuration and polling

You can change the polling frequency and filter data using configuration options.

Default polling information for the Amazon Neptune integration:

  • New Relic polling interval: 5 minutes
  • Amazon CloudWatch data interval: 1 minute

View and use data

To view and use your integration data in Infrastructure, go to infrastructure.newrelic.com > AWS and select an integration.

In New Relic Insights, data is attached to the following event type:

Entity Event type Provider
Instance AwsNeptuneInstanceSample AwsNeptuneInstance
Cluster AwsNeptuneClusterSample AwsNeptuneCluster
ClusterByRole AwsNeptuneClusterByRoleSample AwsNeptuneClusterByRole
DatabaseClass AwsNeptuneDatabaseClassSample AwsNeptuneDatabaseClass

Metric data

This integration collects Amazon Neptune data for Instance, Cluster, ClusterByRole and DatabaseClass.

Neptune Instance data

Metric Unit Description

backupRetentionPeriodStorageUsed

Bytes The total amount of backup storage, in bytes, used to support from the Neptune DB cluster's backup retention window. Included in the total reported by the TotalBackupStorageBilled metric.

clusterReplicaLag

Milliseconds For a read replica, the amount of lag when replicating updates from the primary instance, in milliseconds.

clusterReplicaLagMaximum

Milliseconds The maximum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

clusterReplicaLagMinimum

Milliseconds The minimum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

cpuUtilization

Percent The percentage of CPU utilization.

engineUptime

Seconds The amount of time that the instance has been running, in seconds.

freeableMemory

Bytes The amount of available random access memory, in bytes.

gremlinRequestsPerSec

Count Number of requests per second to the Gremlin engine.

gremlinWebSocketOpenConnections

Count The number of open WebSocket connections to Neptune.

loaderRequestsPerSec

Count Number of loader requests per second.

mainRequestQueuePendingRequests

Count The number of requests waiting in the input queue pending execution. Neptune starts throttling requests when they exceed the maximum queue capacity.

networkReceiveThroughput

BytesPerSecond The incoming (Receive) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

networkThroughput

BytesPerSecond The amount of network throughput both received from and transmitted to clients by each instance in the Neptune DB cluster, in bytes per second. This throughput doesn't include network traffic between instances in the DB cluster and the cluster volume.

networkTransmitThroughput

BytesPerSecond The outgoing (Transmit) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

numTxCommitted

Count The number of transactions successfully committed per second.

numTxOpened

Count The number of transactions opened on the server per second.

numTxRolledBack

Count The number of transactions per second rolled back on the server because of errors.

snapshotStorageUsed

Bytes The total amount of backup storage consumed by all snapshots for a Neptune DB cluster outside its backup retention window, in bytes. Included in the total reported by the TotalBackupStorageBilled metric.

sparqlRequestsPerSec

Count The number of requests per second to the SPARQL engine.

totalBackupStorageBilled

Bytes The total amount of backup storage for which you are billed for a given Neptune DB cluster, in bytes. Includes the backup storage measured by the BackupRetentionPeriodStorageUsed and SnapshotStorageUsed metrics.

totalRequestsPerSec

Count The total number of requests per second to the server from all sources.

totalClientErrorsPerSec

Count The total number per second of requests that errored out because of client-side issues.

totalServerErrorsPerSec

Count The total number per second of requests that errored out on the server because of internal failures.

volumeBytesUsed

Bytes The amount of storage used by your Neptune DB instance, in bytes. This value affects the cost of the Neptune DB cluster.

volumeReadIOPs

Count The average number of billed read I/O operations from a cluster volume, reported at 5-minute intervals. Billed read operations are calculated at the cluster volume level, aggregated from all instances in the Neptune DB cluster, and then reported at 5-minute intervals.

volumeWriteIOPs

Count The average number of write disk I/O operations to the cluster volume, reported at 5-minute intervals.

Neptune Cluster data

Metric Unit Description

backupRetentionPeriodStorageUsed

Bytes The total amount of backup storage, in bytes, used to support from the Neptune DB cluster's backup retention window. Included in the total reported by the TotalBackupStorageBilled metric.

clusterReplicaLag

Milliseconds For a read replica, the amount of lag when replicating updates from the primary instance, in milliseconds.

clusterReplicaLagMaximum

Milliseconds The maximum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

clusterReplicaLagMinimum

Milliseconds The minimum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

cpuUtilization

Percent The percentage of CPU utilization.

engineUptime

Seconds The amount of time that the instance has been running, in seconds.

freeableMemory

Bytes The amount of available random access memory, in bytes.

gremlinRequestsPerSec

Count Number of requests per second to the Gremlin engine.

gremlinWebSocketOpenConnections

Count The number of open WebSocket connections to Neptune.

loaderRequestsPerSec

Count Number of loader requests per second.

mainRequestQueuePendingRequests

Count The number of requests waiting in the input queue pending execution. Neptune starts throttling requests when they exceed the maximum queue capacity.

networkReceiveThroughput

BytesPerSecond The incoming (Receive) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

networkThroughput

BytesPerSecond The amount of network throughput both received from and transmitted to clients by each instance in the Neptune DB cluster, in bytes per second. This throughput doesn't include network traffic between instances in the DB cluster and the cluster volume.

networkTransmitThroughput

BytesPerSecond The outgoing (Transmit) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

numTxCommitted

Count The number of transactions successfully committed per second.

numTxOpened

Count The number of transactions opened on the server per second.

numTxRolledBack

Count The number of transactions per second rolled back on the server because of errors.

snapshotStorageUsed

Bytes The total amount of backup storage consumed by all snapshots for a Neptune DB cluster outside its backup retention window, in bytes. Included in the total reported by the TotalBackupStorageBilled metric.

sparqlRequestsPerSec

Count The number of requests per second to the SPARQL engine.

totalBackupStorageBilled

Bytes The total amount of backup storage for which you are billed for a given Neptune DB cluster, in bytes. Includes the backup storage measured by the BackupRetentionPeriodStorageUsed and SnapshotStorageUsed metrics.

totalRequestsPerSec

Count The total number of requests per second to the server from all sources.

totalClientErrorsPerSec

Count The total number per second of requests that errored out because of client-side issues.

totalServerErrorsPerSec

Count The total number per second of requests that errored out on the server because of internal failures.

volumeBytesUsed

Bytes The amount of storage used by your Neptune DB instance, in bytes. This value affects the cost of the Neptune DB cluster.

volumeReadIOPs

Count The average number of billed read I/O operations from a cluster volume, reported at 5-minute intervals. Billed read operations are calculated at the cluster volume level, aggregated from all instances in the Neptune DB cluster, and then reported at 5-minute intervals.

volumeWriteIOPs

Count The average number of write disk I/O operations to the cluster volume, reported at 5-minute intervals.

Neptune ClusterByRole data

Metric Unit Description

backupRetentionPeriodStorageUsed

Bytes The total amount of backup storage, in bytes, used to support from the Neptune DB cluster's backup retention window. Included in the total reported by the TotalBackupStorageBilled metric.

clusterReplicaLag

Milliseconds For a read replica, the amount of lag when replicating updates from the primary instance, in milliseconds.

clusterReplicaLagMaximum

Milliseconds The maximum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

clusterReplicaLagMinimum

Milliseconds The minimum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

cpuUtilization

Percent The percentage of CPU utilization.

engineUptime

Seconds The amount of time that the instance has been running, in seconds.

freeableMemory

Bytes The amount of available random access memory, in bytes.

gremlinRequestsPerSec

Count Number of requests per second to the Gremlin engine.

gremlinWebSocketOpenConnections

Count The number of open WebSocket connections to Neptune.

loaderRequestsPerSec

Count Number of loader requests per second.

mainRequestQueuePendingRequests

Count The number of requests waiting in the input queue pending execution. Neptune starts throttling requests when they exceed the maximum queue capacity.

networkReceiveThroughput

BytesPerSecond The incoming (Receive) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

networkThroughput

BytesPerSecond The amount of network throughput both received from and transmitted to clients by each instance in the Neptune DB cluster, in bytes per second. This throughput doesn't include network traffic between instances in the DB cluster and the cluster volume.

networkTransmitThroughput

BytesPerSecond The outgoing (Transmit) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

numTxCommitted

Count The number of transactions successfully committed per second.

numTxOpened

Count The number of transactions opened on the server per second.

numTxRolledBack

Count The number of transactions per second rolled back on the server because of errors.

snapshotStorageUsed

Bytes The total amount of backup storage consumed by all snapshots for a Neptune DB cluster outside its backup retention window, in bytes. Included in the total reported by the TotalBackupStorageBilled metric.

sparqlRequestsPerSec

Count The number of requests per second to the SPARQL engine.

totalBackupStorageBilled

Bytes The total amount of backup storage for which you are billed for a given Neptune DB cluster, in bytes. Includes the backup storage measured by the BackupRetentionPeriodStorageUsed and SnapshotStorageUsed metrics.

totalRequestsPerSec

Count The total number of requests per second to the server from all sources.

totalClientErrorsPerSec

Count The total number per second of requests that errored out because of client-side issues.

totalServerErrorsPerSec

Count The total number per second of requests that errored out on the server because of internal failures.

volumeBytesUsed

Bytes The amount of storage used by your Neptune DB instance, in bytes. This value affects the cost of the Neptune DB cluster.

volumeReadIOPs

Count The average number of billed read I/O operations from a cluster volume, reported at 5-minute intervals. Billed read operations are calculated at the cluster volume level, aggregated from all instances in the Neptune DB cluster, and then reported at 5-minute intervals.

volumeWriteIOPs

Count The average number of write disk I/O operations to the cluster volume, reported at 5-minute intervals.

Neptune DatabaseClass data

Metric Unit Description

backupRetentionPeriodStorageUsed

Bytes The total amount of backup storage, in bytes, used to support from the Neptune DB cluster's backup retention window. Included in the total reported by the TotalBackupStorageBilled metric.

clusterReplicaLag

Milliseconds For a read replica, the amount of lag when replicating updates from the primary instance, in milliseconds.

clusterReplicaLagMaximum

Milliseconds The maximum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

clusterReplicaLagMinimum

Milliseconds The minimum amount of lag between the primary instance and each Neptune DB instance in the DB cluster, in milliseconds.

cpuUtilization

Percent The percentage of CPU utilization.

engineUptime

Seconds The amount of time that the instance has been running, in seconds.

freeableMemory

Bytes The amount of available random access memory, in bytes.

gremlinRequestsPerSec

Count Number of requests per second to the Gremlin engine.

gremlinWebSocketOpenConnections

Count The number of open WebSocket connections to Neptune.

loaderRequestsPerSec

Count Number of loader requests per second.

mainRequestQueuePendingRequests

Count The number of requests waiting in the input queue pending execution. Neptune starts throttling requests when they exceed the maximum queue capacity.

networkReceiveThroughput

BytesPerSecond The incoming (Receive) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

networkThroughput

BytesPerSecond The amount of network throughput both received from and transmitted to clients by each instance in the Neptune DB cluster, in bytes per second. This throughput doesn't include network traffic between instances in the DB cluster and the cluster volume.

networkTransmitThroughput

BytesPerSecond The outgoing (Transmit) network traffic on the DB instance, including both customer database traffic and Neptune traffic used for monitoring and replication, in bytes/second.

numTxCommitted

Count The number of transactions successfully committed per second.

numTxOpened

Count The number of transactions opened on the server per second.

numTxRolledBack

Count The number of transactions per second rolled back on the server because of errors.

snapshotStorageUsed

Bytes The total amount of backup storage consumed by all snapshots for a Neptune DB cluster outside its backup retention window, in bytes. Included in the total reported by the TotalBackupStorageBilled metric.

sparqlRequestsPerSec

Count The number of requests per second to the SPARQL engine.

totalBackupStorageBilled

Bytes The total amount of backup storage for which you are billed for a given Neptune DB cluster, in bytes. Includes the backup storage measured by the BackupRetentionPeriodStorageUsed and SnapshotStorageUsed metrics.

totalRequestsPerSec

Count The total number of requests per second to the server from all sources.

totalClientErrorsPerSec

Count The total number per second of requests that errored out because of client-side issues.

totalServerErrorsPerSec

Count The total number per second of requests that errored out on the server because of internal failures.

volumeBytesUsed

Bytes The amount of storage used by your Neptune DB instance, in bytes. This value affects the cost of the Neptune DB cluster.

volumeReadIOPs

Count The average number of billed read I/O operations from a cluster volume, reported at 5-minute intervals. Billed read operations are calculated at the cluster volume level, aggregated from all instances in the Neptune DB cluster, and then reported at 5-minute intervals.

volumeWriteIOPs

Count The average number of write disk I/O operations to the cluster volume, reported at 5-minute intervals.

For more help

Recommendations for learning more: