Amazon Neptune is a fast, reliable, fully managed graph database service that makes it easy to build and run applications that work with highly connected datasets. The core of Amazon Neptune is a purpose-built, high-performance graph database engine optimized for storing billions of relationships and querying the graph with milliseconds latency.
Amazon Neptune has the following capabilities:
- Supports popular graph models Property Graph and W3C RDF, and their respective query languages Apache TinkerPop Gremlin and SPARQL.
- Powers graph use cases such as recommendation engines, fraud detection, knowledge graphs, drug discovery, and network security.
Use the AWS public cloud integration to discover and collect metrics against the AWS service.
External reference
Monitoring Neptune Using Amazon CloudWatch
Setup
To set up the AWS integration and discover the AWS service, go to AWS Integration Discovery Profile and select Neptune DB Cluster or Neptune DB Instance.
Event support
CloudTrail event support
- Not Supported (Neptune DB Cluster and Neptune DB Instance)
CloudWatch alarm support
- Supported (Neptune DB Cluster and Neptune DB Instance)
- Configurable in OpsRamp AWS Integration Discovery Profile.
Supported metrics
| OpsRamp Metric | AWS Metric | Metric Display Name | Unit | Aggregation Type | Description |
|---|---|---|---|---|---|
| aws_neptune_BackupRetentionPeriodStorageUsed | BackupRetentionPeriodStorageUsed | Backup Retention Period Storage Used | Bytes | Average | Total amount of backup storage used to support the Neptune DB cluster backup retention window |
| aws_neptune_SnapshotStorageUsed | SnapshotStorageUsed | Snapshot Storage Used | Bytes | Average | Total amount of backup storage consumed by all snapshots outside the backup retention window |
| aws_neptune_TotalBackupStorageBilled | TotalBackupStorageBilled | Total Backup Storage Billed | Bytes | Average | Total amount of backup storage billed for a given cluster, includes BackupRetentionPeriodStorageUsed and SnapshotStorageUsed |
| aws_neptune_VolumeBytesUsed | VolumeBytesUsed | Volume Bytes Used | Bytes | Average | Total amount of storage allocated to the Neptune DB cluster |
| aws_neptune_VolumeReadIOPs | VolumeReadIOPs | Volume Read IO Ps | Count | Average | Total number of billed read I/O operations from a cluster volume, reported at 5-minute intervals |
| aws_neptune_VolumeWriteIOPs | VolumeWriteIOPs | Volume Write IO Ps | Count | Average | Total number of write disk I/O operations to the cluster volume, reported at 5-minute intervals |
| aws_neptune_CPUUtilization | CPUUtilization | CPU Utilization | Percent | Average | Percentage of CPU utilization |
| aws_neptune_CPUCreditBalance | CPUCreditBalance | CPU Credit Balance | Count | Average | Number of CPU credits an instance has accumulated, reported at 5-minute intervals |
| aws_neptune_CPUCreditUsage | CPUCreditUsage | CPU Credit Usage | Count | Average | Number of CPU credits consumed during the specified period, reported at 5-minute intervals |
| aws_neptune_CPUSurplusCreditBalance | CPUSurplusCreditBalance | CPU Surplus Credit Balance | Count | Average | Number of surplus credits spent by an unlimited instance when CPUCreditBalance is zero |
| aws_neptune_CPUSurplusCreditsCharged | CPUSurplusCreditsCharged | CPU Surplus Credits Charged | Count | Average | Number of spent surplus credits not paid down by earned CPU credits, incurring additional charge |
| aws_neptune_FreeableMemory | FreeableMemory | Freeable Memory | Bytes | Average | Amount of available RAM |
| aws_neptune_SwapUsage | SwapUsage | Swap Usage | Bytes | Average | Amount of swap space used |
| aws_neptune_BufferCacheHitRatio | BufferCacheHitRatio | Buffer Cache Hit Ratio | Percent | Average | Percentage of requests served by the buffer cache. Below 99.9% suggests upgrading instance type |
| aws_neptune_NumResultCacheHit | NumResultCacheHit | Num Result Cache Hit | Count | Average | Number of Gremlin result cache hits |
| aws_neptune_NumResultCacheMiss | NumResultCacheMiss | Num Result Cache Miss | Count | Average | Number of Gremlin result cache misses |
| aws_neptune_ResultCacheSizeInBytes | ResultCacheSizeInBytes | Result Cache Size In Bytes | Bytes | Average | Total estimated size of all cached items in the Gremlin result cache |
| aws_neptune_ResultCacheItemCount | ResultCacheItemCount | Result Cache Item Count | Count | Average | Number of items in the Gremlin result cache |
| aws_neptune_ResultCacheOldestItemTimestamp | ResultCacheOldestItemTimestamp | Result Cache Oldest Item Timestamp | None | Minimum | Timestamp of the oldest item in the Gremlin result cache |
| aws_neptune_ResultCacheNewestItemTimestamp | ResultCacheNewestItemTimestamp | Result Cache Newest Item Timestamp | None | Maximum | Timestamp of the newest item in the Gremlin result cache |
| aws_neptune_ClusterReplicaLag | ClusterReplicaLag | Cluster Replica Lag | Milliseconds | Average | Lag when replicating updates from the primary instance for read replicas |
| aws_neptune_ClusterReplicaLagMaximum | ClusterReplicaLagMaximum | Cluster Replica Lag Maximum | Milliseconds | Maximum | Maximum lag between the primary instance and each Neptune DB instance in the cluster |
| aws_neptune_ClusterReplicaLagMinimum | ClusterReplicaLagMinimum | Cluster Replica Lag Minimum | Milliseconds | Minimum | Minimum lag between the primary instance and each Neptune DB instance in the cluster |
| aws_neptune_GlobalDbDataTransferBytes | GlobalDbDataTransferBytes | Global Db Data Transfer Bytes | Bytes | Average | Bytes of redo log data transferred from primary to secondary AWS Region in a global database |
| aws_neptune_GlobalDbReplicatedWriteIO | GlobalDbReplicatedWriteIO | Global Db Replicated Write IO | Count | Average | Number of write I/O operations replicated from primary Region to secondary Region cluster volume |
| aws_neptune_GlobalDbProgressLag | GlobalDbProgressLag | Global Db Progress Lag | Milliseconds | Average | Milliseconds a secondary cluster is behind the primary cluster for user and system transactions |
| aws_neptune_NetworkThroughput | NetworkThroughput | Network Throughput | Bytes/Second | Average | Network throughput received from and transmitted to clients per instance |
| aws_neptune_NetworkTransmitThroughput | NetworkTransmitThroughput | Network Transmit Throughput | Bytes/Second | Average | Outgoing network throughput transmitted to clients per instance |
| aws_neptune_StorageNetworkReceiveThroughput | StorageNetworkReceiveThroughput | Storage Network Receive Throughput | Bytes/Second | Average | Network throughput received from the storage subsystem per instance |
| aws_neptune_StorageNetworkThroughput | StorageNetworkThroughput | Storage Network Throughput | Bytes/Second | Average | Network throughput received from and sent to the storage subsystem per instance |
| aws_neptune_StorageNetworkTransmitThroughput | StorageNetworkTransmitThroughput | Storage Network Transmit Throughput | Bytes/Second | Average | Network throughput sent to the storage subsystem per instance |
| aws_neptune_TempStorageIOPS | TempStorageIOPS | Temp Storage IOPS | Count/Second | Average | Number of IOPS for reads and writes on local storage attached to the instance |
| aws_neptune_TempStorageThroughput | TempStorageThroughput | Temp Storage Throughput | Bytes/Second | Average | Data transferred to and from local storage, measured once per second |
| aws_neptune_EngineUptime | EngineUptime | Engine Uptime | Seconds | Maximum | Amount of time the instance has been running |
| aws_neptune_NCUUtilization | NCUUtilization | NCU Utilization | Percent | Average | Percentage of current NCUs used vs maximum NCU capacity (Neptune Serverless only) |
| aws_neptune_ServerlessDatabaseCapacity | ServerlessDatabaseCapacity | Serverless Database Capacity | Count | Average | Current instance capacity in Neptune Capacity Units. 1 NCU = 2 GiB RAM + associated vCPU + networking |
| aws_neptune_TotalRequestsPerSec | TotalRequestsPerSec | Total Requests Per Sec | Count/Second | Average | Total requests per second to the server from all sources |
| aws_neptune_TotalClientErrorsPerSec | TotalClientErrorsPerSec | Total Client Errors Per Sec | Count/Second | Average | Total requests per second that errored out due to client-side issues |
| aws_neptune_TotalServerErrorsPerSec | TotalServerErrorsPerSec | Total Server Errors Per Sec | Count/Second | Average | Total requests per second that errored out on server due to internal failures |
| aws_neptune_MainRequestQueuePendingRequests | MainRequestQueuePendingRequests | Main Request Queue Pending Requests | Count | Average | Number of requests waiting in the input queue pending execution |
| aws_neptune_NumQueuedRequestsPerSec | NumQueuedRequestsPerSec | Num Queued Requests Per Sec | Count/Second | Average | Number of requests queued per second |
| aws_neptune_NumTxCommitted | NumTxCommitted | Num Tx Committed | Count/Second | Average | Number of transactions successfully committed per second |
| aws_neptune_NumTxOpened | NumTxOpened | Num Tx Opened | Count/Second | Average | Number of transactions opened on the server per second |
| aws_neptune_NumTxRolledBack | NumTxRolledBack | Num Tx Rolled Back | Count/Second | Average | Number of transactions rolled back per second due to errors, or completed read-only transactions per second |
| aws_neptune_NumIndexDeletesPerSec | NumIndexDeletesPerSec | Num Index Deletes Per Sec | Count/Second | Average | Number of deletes from individual indexes per second, includes rolled-back deletes |
| aws_neptune_NumIndexInsertsPerSec | NumIndexInsertsPerSec | Num Index Inserts Per Sec | Count/Second | Average | Number of inserts to individual indexes per second, includes rolled-back inserts |
| aws_neptune_NumIndexReadsPerSec | NumIndexReadsPerSec | Num Index Reads Per Sec | Count/Second | Average | Number of statements scanned from any index per second |
| aws_neptune_UndoLogListSize | UndoLogListSize | Undo Log List Size | Count | Average | Count of undo logs in the undo log list. High or growing values suggest upgrading writer instance |
| aws_neptune_NumUndoPagesPurged | NumUndoPagesPurged | Num Undo Pages Purged | Count | Average | Number of batches purged, indicates purging progress. Value is 0 for reader instances |
| aws_neptune_GremlinRequestsPerSec | GremlinRequestsPerSec | Gremlin Requests Per Sec | Count/Second | Average | Number of requests per second to the Gremlin engine |
| aws_neptune_GremlinClientErrorsPerSec | GremlinClientErrorsPerSec | Gremlin Client Errors Per Sec | Count/Second | Average | Number of client-side errors per second in Gremlin traversals |
| aws_neptune_GremlinServerErrorsPerSec | GremlinServerErrorsPerSec | Gremlin Server Errors Per Sec | Count/Second | Average | Number of server-side errors per second in Gremlin traversals |
| aws_neptune_GremlinWebSocketOpenConnections | GremlinWebSocketOpenConnections | Gremlin Web Socket Open Connections | Count | Average | Number of open WebSocket connections to Neptune |
| aws_neptune_SparqlRequestsPerSec | SparqlRequestsPerSec | Sparql Requests Per Sec | Count/Second | Average | Number of requests per second to the SPARQL engine |
| aws_neptune_SparqlClientErrorsPerSec | SparqlClientErrorsPerSec | Sparql Client Errors Per Sec | Count/Second | Average | Number of client-side errors per second in SPARQL queries |
| aws_neptune_SparqlServerErrorsPerSec | SparqlServerErrorsPerSec | Sparql Server Errors Per Sec | Count/Second | Average | Number of SPARQL server errors per second |
| aws_neptune_OpenCypherRequestsPerSec | OpenCypherRequestsPerSec | Open Cypher Requests Per Sec | Count/Second | Average | Number of requests per second (both HTTPS and Bolt) to the openCypher engine |
| aws_neptune_NumOpenCypherRequestsPerSec | NumOpenCypherRequestsPerSec | Num Open Cypher Requests Per Sec | Count/Second | Average | Number of OpenCypher requests per second |
| aws_neptune_NumOpenCypherClientErrorsPerSec | NumOpenCypherClientErrorsPerSec | Num Open Cypher Client Errors Per Sec | Count/Second | Average | Number of OpenCypher client errors per second |
| aws_neptune_NumOpenCypherServerErrorsPerSec | NumOpenCypherServerErrorsPerSec | Num Open Cypher Server Errors Per Sec | Count/Second | Average | Number of OpenCypher server errors per second |
| aws_neptune_OpenCypherBoltOpenConnections | OpenCypherBoltOpenConnections | Open Cypher Bolt Open Connections | Count | Average | Number of open Bolt connections to Neptune |
| aws_neptune_LoaderRequestsPerSec | LoaderRequestsPerSec | Loader Requests Per Sec | Count/Second | Average | Number of loader requests per second |
| aws_neptune_LoaderClientErrorsPerSec | LoaderClientErrorsPerSec | Loader Client Errors Per Sec | Count/Second | Average | Number of client-side errors per second from loader requests |
| aws_neptune_LoaderServerErrorsPerSec | LoaderServerErrorsPerSec | Loader Server Errors Per Sec | Count/Second | Average | Number of loader server-side errors per second |
| aws_neptune_StatsNumStatementsScanned | StatsNumStatementsScanned | Stats Num Statements Scanned | Count | Average | Total number of statements scanned for DFE statistics since server started |