Amazon Neptune

Overview

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.

Enable this integration to see all your Neptune metrics in Datadog.

Setup

Installation

If you haven’t already, set up the Amazon Web Services integration first.

Metric collection

  1. In the AWS integration page, ensure that Neptune is enabled under the Metric Collection tab.
  2. Install the Datadog - Amazon Neptune integration.

Log collection

Enable logging

Configure Amazon Neptune to send logs either to a S3 bucket or to CloudWatch.

Note: If you log to a S3 bucket, make sure that amazon_neptune is set as Target prefix.

Send logs to Datadog

  1. If you haven’t already, set up the Datadog Forwarder Lambda function.

  2. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your Amazon Neptune logs in the AWS console:

Data Collected

Metrics

aws.neptune.backup_retention_period_storage_used
(count)
The total amount of backup storage.
Shown as byte
aws.neptune.buffer_cache_hit_ratio
(count)
The percentage of requests that are served by the buffer cache.
aws.neptune.cluster_replica_lag
(count)
For a read replica the amount of lag when replicating updates from the primary instance in milliseconds.
Shown as millisecond
aws.neptune.cluster_replica_lag_maximum
(count)
The maximum amount of lag between the primary instance and each Neptune DB instance in the DB cluster in milliseconds.
Shown as millisecond
aws.neptune.cluster_replica_lag_minimum
(count)
The minimum amount of lag between the primary instance and each Neptune DB instance in the DB cluster in milliseconds.
Shown as millisecond
aws.neptune.cpuutilization
(count)
The percentage of CPU utilization.
aws.neptune.engine_uptime
(count)
The amount of time that the instance has been running in seconds.
Shown as second
aws.neptune.free_local_storage
(count)
The amount of storage available for temporary tables and logs in bytes.
Shown as byte
aws.neptune.freeable_memory
(count)
The amount of available random access memory in bytes.
Shown as byte
aws.neptune.global_db_data_transfer_bytes
(count)
The number of bytes of redo log data transferred from the primary AWS Region to a secondary AWS Region in a Neptune global database.
Shown as byte
aws.neptune.global_db_replicated_write_io
(count)
The number of write I/O operations replicated from the primary AWS Region in the global database to the cluster volume in a secondary AWS Region.
aws.neptune.global_db_progress_lag
(count)
The number of milliseconds that a secondary cluster is behind the primary cluster for both user transactions and system transactions.
Shown as millisecond
aws.neptune.gremlin_requests_per_sec
(count)
Number of requests to Gremlin engine per second.
aws.neptune.gremlin_web_socket_open_connections
(count)
The number of open WebSocket connections to Neptune.
aws.neptune.loader_requests_per_sec
(count)
Number of loader requests per second.
aws.neptune.main_request_queue_pending_requests
(count)
The number of requests waiting in the input queue pending execution.
aws.neptune.ncuutilization
(count)
Only applicable to a Neptune Serverless DB instance or DB cluster.
aws.neptune.netowrk_transmit_throughput
(count)
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.
aws.neptune.network_receieve_throughput
(count)
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.
aws.neptune.network_throughput
(count)
The amount of network throughput both received from and transmitted to clients by each instance in the Neptune DB cluster in bytes per second.
aws.neptune.num_tx_committed
(count)
The number of transactions successfully committed per second.
aws.neptune.num_tx_opened
(count)
The number of transactions opened on the server per second.
aws.neptune.num_tx_rolled_back
(count)
The number of transactions per second rolled back on the server because of errors.
aws.neptune.open_cypher_requests_per_sec
(count)
Number of requests per second (both HTTPS and Bolt) to the openCypher engine.
aws.neptune.open_cypher_bolt_open_connections
(count)
The number of open Bolt connections to Neptune.
aws.neptune.serverless_database_capacity
(count)
The current instance capacity of a given Neptune serverless instance.
aws.neptune.snapshot_storage_used
(count)
The total amount of backup storage consumed by all snapshots for a Neptune DB cluster outside its backup retention window.
Shown as byte
aws.neptune.sparql_requests_per_sec
(count)
Number of requests to the SPARQL engine per second.
aws.neptune.stats_num_statements_scanned
(count)
The total number of statements scanned for DFE statistics since the server started.
aws.neptune.total_backup_storage_billed
(count)
The total amount of backup storage for which you are billed for a given Neptune DB cluster.
Shown as byte
aws.neptune.total_client_errors_per_sec
(count)
The total number per second of requests that errored out because of client-side issues.
aws.neptune.total_requests_per_sec
(count)
The total number of requests per second to the server from all sources.
aws.neptune.total_server_errors_per_sec
(count)
The total number per second of requests that errored out on the server because of internal failures.
aws.neptune.undo_log_list_size
(count)
The count of undo logs in the undo log list.
Shown as byte
aws.neptune.volume_bytes_used
(count)
The amount of storage used by your Neptune DB instance in bytes.
Shown as byte
aws.neptune.volume_read_iops
(count)
The average number of billed read I/O operations from a cluster volume reported at 5-minute intervals.
aws.neptune.volume_write_iops
(count)
The average number of write disk I/O operations to the cluster volume reported at 5-minute intervals.

Events

The Amazon Neptune integration does not include any events.

Service Checks

The Amazon Neptune integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.