---
title: Amazon Neptune
description: >-
  A managed graph database service that simplifies building and running apps
  with highly connected datasets.
breadcrumbs: Docs > Integrations > Amazon Neptune
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Amazon Neptune
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #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{% #setup %}

### Installation{% #installation %}

If you haven't already, set up the [Amazon Web Services integration](https://docs.datadoghq.com/integrations/amazon_web_services.md) first.

### Metric collection{% #metric-collection %}

1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `Neptune` is enabled under the `Metric Collection` tab.
1. Install the [Datadog - Amazon Neptune integration](https://app.datadoghq.com/integrations/amazon-neptune).

### Log collection{% #log-collection %}

#### Enable logging{% #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{% #send-logs-to-datadog %}

1. If you haven't already, set up the [Datadog Forwarder Lambda function](https://docs.datadoghq.com/logs/guide/forwarder.md).

1. 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:

   - [Add a manual trigger on the S3 bucket](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-s3-buckets)
   - [Add a manual trigger on the CloudWatch Log Group](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-cloudwatch-log-group)

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **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.gremlin\_errors**(count)                              | Number of errors in Gremlin traversals.                                                                                                                                      |
| **aws.neptune.gremlin\_requests**(count)                            | Number of requests to Gremlin engine.                                                                                                                                        |
| **aws.neptune.gremlin\_requests\_per\_sec**(count)                  | Number of requests to Gremlin engine per second.                                                                                                                             |
| **aws.neptune.gremlin\_web\_socket\_available\_connections**(count) | Number of potential WebSocket connections currently available.                                                                                                               |
| **aws.neptune.gremlin\_web\_socket\_client\_errors**(count)         | Number of WebSocket client errors on the Gremlin endpoint per second.                                                                                                        |
| **aws.neptune.gremlin\_web\_socket\_server\_errors**(count)         | Number of WebSocket server errors on the Gremlin endpoint per second.                                                                                                        |
| **aws.neptune.gremlin\_web\_socket\_success**(count)                | Number of successful WebSocket connections to the Gremlin endpoint per second.                                                                                               |
| **aws.neptune.loader\_errors**(count)                               | Number of errors from Loader requests.                                                                                                                                       |
| **aws.neptune.loader\_requests**(count)                             | Number of Loader Requests.                                                                                                                                                   |
| **aws.neptune.network\_receive\_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.network\_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.sparql\_errors**(count)                               | Number of errors in the SPARQL queries.                                                                                                                                      |
| **aws.neptune.sparql\_requests**(count)                             | Number of requests to the SPARQL engine.                                                                                                                                     |
| **aws.neptune.sparql\_requests\_per\_sec**(count)                   | Number of requests to the SPARQL engine per second.                                                                                                                          |
| **aws.neptune.status\_errors**(count)                               | Number of errors from the status endpoint.                                                                                                                                   |
| **aws.neptune.status\_requests**(count)                             | Number of requests to the status endpoint.                                                                                                                                   |
| **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{% #events %}

The Amazon Neptune integration does not include any events.

### Service Checks{% #service-checks %}

The Amazon Neptune integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).
