GrapheneDB Blog

Updates from the GrapheneDB team

Come Meet Us at AWS re:Invent 2016!

Meet GrapheneDB at AWS re:Invent 2016

Are you ready for AWS re:Invent? We are!

We are very excited to descend upon Las Vegas for what is now the largest cloud computing event in the world, and this year’s lineup is sure to not disappoint. We are looking forward to all of the sessions, workshops, and announcements of new features.

But most importantly, we’re looking forward to meeting you, our users!

Where can you find GrapheneDB?

GrapheneDB is a sponsor this year, so you will be able to find us at the exhibit hall. We will have plenty of swag items to give away, so come get your GrapheneDB sticker and t-shirts.

Find us at booth #541, in the Expo Hall, next to the Developer Lounge.

Want to get in touch beforehand?

The best way to get in touch with us during the event is to simply come by the booth. However, if you’d like to reach out to us beforehand to set-up a time to chat, feel free to email us at We’re happy to set aside some time to talk to you and address any specific needs or questions you may have about the product.

Or if you just want to talk to us about how you’re using GrapheneDB, we’d love to hear about it. We specifically welcome feedback about some of our recently released features, such as our new Management API or Insights.

Announcement: New GrapheneDB Management API

The team at GrapheneDB has always been huge fan of how AWS and Heroku use APIs to enable developers to create new processes and tools. The API revolution is transforming the way in which software is written and deployed,creating opportunities for new business models.

Our customers frequently asked for an API to perform database management and operational tasks automatically. We have been working closely with certain customers to fine tune an API that, in the same manner as AWS and Heroku, would give developers the ability to automate tasks. After much work and testing, we are now proud to announce our upcoming Public API.

GraphneDB Management API

So far, we have seen our API help with some interesting use cases, including:

  • Syncing different environments periodically, such as restoring the QA database with a fresh copy of production every day.
  • Deploying databases, stored procedures, or extensions from automated tests or code branches.
  • Automatically downloading all production database backups onto infrastructure for business continuity.
  • Developing SaaS products that require one individual database per account.

Please take a look at our documentation to find out more about our API.

We’re eager to hear what you build with our public API! It’s currently in closed beta, so please contact us at and we’ll provide you access.

Introducing Insights: Server Metrics and Slow Queries Analyzer

A couple of months ago we announced that our Metrics feature was out of beta and available for all of our customers on the Performance tier.

Today we’re excited to present Insights, a toolset that bundles Metrics together with a brand new slow query analyzer.

Insights is a great tool to help you troubleshoot issues when things go wrong or changes are introduced into your environment. The information you get from Insights should enable you to pinpoint if issues are due to external factors or caused by queries. This will greatly simplify the process of improving Neo4j’s performance.

Streaming of insights on GrapheneDB

Our new slow query analyzer registers all queries that hit the database, and aggregates the response times during a given time window. This allows us to offer you data like the slowest queries (highest median and 95th percentile response times), as well as the most time consuming queries (think highest median multiplied by the number of executions).

We strongly believe in providing tools for our customers that will empower them to make data-driven decisions to improve their business. While those tools were previously only available to our Performance tier customers, we’re proud to announce Insights as part of our Standard offering. We want to ensure all customers running production-ready databases on GrapheneDB can benefit from the power of this great toolset.

We’re determined to continue to offer you more tools to be successful with Neo4j. We’ve got many great announcements to make along the way, so stay tuned!

To learn more about Insights please take a look at our documentation.

How to Manage Neo4j Stored Procedures in GrapheneDB

Procedures are the preferred means for extending Neo4j. It allows Neo4j to be extended by writing custom code which can be invoked directly from Cypher.

At GrapheneDB, we provide a self-serviced and automated way to manage stored procedures. In a matter of seconds, you’ll be able to upload your own procedure and enable it on your database.

To add an extension, the database has to be restarted. Our admin interface facilitates this process by asking you to Enable/Disable extensions before applying changes. This allows you to configure your extensions before restarting your database.

In the example below, we’re adding APOC stored procedures, a great library that covers different aspects that are currently not available on Cypher. Extending your Neo4j database is just three click away!

Streaming of stored procedures on GrapheneDB

Extensions management is only available for Developer plans and higher. You can create a Developer database in a matter of seconds here:

Create a Developer database now

If you want to read further instructions on how to manage stored procedures please take a look at our documentation.

Neo4j 3.0 on GrapheneDB

Neo Technology recently released Neo4j 3.0. In addition to some optimizations to Cypher and other features, perhaps the most exciting new highlight of the latest release is Bolt, which is “a new network protocol designed for high-performance access to graph databases” (read the release notes here).

Bolt will seek to introduce a completely new way of working with Neo4j, one which seeks to “consolidate and refine” how you may already work with Neo4j. The spirit of Bolt is not only to improve performance, but also to improve the developer experience.

The goal of Bolt is to consolidate and refine all the ways of doing work with Neo4j, providing more consistent access with a pleasant separation of responsibility. If you want to learn more about Bolt, read this excellent interview with Neo4j’s Nigel Small.


We are excited to announce that Neo4j 3.0 is available on all our plans. We’ve been working very hard these last weeks to enable support for it on every tier; self-service and automated, as you are used to from our service. If you want to give it a go for free, follow this link and you’ll be trying out Bolt in a matter of seconds.

GrapheneDB Now Offers Wider Support of AWS Regions

At GrapheneDB, we are committed to giving the best possible service through all of our deployment options.

We are happy to announce today support for 5 additional AWS regions on our Standard plans, and 3 additional regions on our Performances plans. Below, you can find our expanded list of supported AWS regions:

  • US East (N. Virginia)
  • US West (Oregon) - NEW ON STANDARD TIER -
  • Europe (Ireland)
  • Asia Pacific (Sydney) - NEW ON STANDARD TIER -

New AWS regions

If you want to change your existing database to one of these new regions, you can use our self-service clone feature and select the new AWS region of your choice when cloning.

Announcing Metrics General Availability

A select number of our Performance customers have been testing the beta of our new metrics dashboard for the last couple of months. We are very grateful for their valuable help in testing out this feature before officially rolling it out. We are excited to announce today that the new Metrics feature is out of beta and is now available for all of our customers on the Performance tier.

Our metrics dashboard will allow you to track server errors and see when errors are happening. You will also be able to track median and 95th percentile response times, as well as see incoming query and request throughput.

Metrics Dashboard

With our new Metrics dashboard, not only will you be able to see what is happening now, but you will be able to get historical information for the last few days by changing the time window of your reports.

No one operates more Neo4j database instances in the cloud than GrapehenDB. This gives our team great insight into how to best equip our customers for success. We understand that giving our customers knowledge about how their servers are performing in real time can help them diagnose key performance issues, keeping them on track for success.

We highly recommend you give our new Metrics dashboard a try and see how powerful it is for yourself. We have big plans for performance diagnoses in 2016, so you’ll want to stay tuned to this blog or our our Twitter page page for updates.

New: Introducing Flexible, On-demand Server Maintenance

GrapheneDB needs to perform maintenance on its servers from time to time. Maintenance procedures will vary depending on your database plan.

On Hobby databases, which are designed for development and testing, we might perform maintenance with downtime without prior notice.

On Standard databases, our entry-level production tier, we will usually send a notification a few days in advance with a specified time window during which we will perform maintenance and an estimated duration for the actual downtime.

Because of the multi-tenant architecture of the Standard tier, our schedule cannot accommodate preferences for maintenance windows.

Existing Performance and Enterprise customers might already know we offer 3 time windows to choose from for maintenance procedures. In order to accommodate customers who want to perform maintenance on specific periods of low traffic, we have been setting up custom time windows on special request.

In order to make this process even easier and more flexible, we’ve added a new on-demand maintenance feature. This feature allows customers on the Performance tier to trigger scheduled maintenance procedures on their database with the click of a button, when it’s more convenient to them. This provides customers with the flexibility to set downtimes when they are less damaging for their business.

When a database instance has a maintenance operation scheduled, a warning with some details will be displayed in the UI:


You will also see the a warning in the database overview with details about the maintenance, like a description, estimated downtime and a deadline.

Scheduled maintenance

Customers on the Performance tier can trigger the maintenance procedure by clicking on the Launch maintenance button.

While the operation is in progress, a dialogue will inform you of the state of the procedure.

Maintenance in progress

When the operation is complete, the pop-up will be dismissed, and any warning messages will no longer be displayed. At this point, no other changes will be necessary, but you may have to wait a few minutes for the DNS to propagate.

Please note: Unless a maintenance procedure is initiated by a user before the deadline, the maintenance will run automatically at the time specified in the maintenance warning.

New Feature: Cloning GrapheneDB Instances Without Downtime

GrapheneDB has been offering a database cloning feature for a long time. This feature is useful when scaling vertically (i.e. cloning into a higher or lower plan) or when testing Neo4j compatibility before performing an upgrade.

Up until now, the clone feature shuts down the databases to export the entire dataset, then creates a new database where the dataset is restored. We’re excited to announce a new feature that enables cloning a database without any downtime.

This new feature is very useful in cases when you want to avoid downtime, or when the dataset is static and the database is not taking any writes.

From the list of backups of database, click on the “Create DB from backup” option on the right-hand side. This will lead you to the “Clone an existing database” page where you will be able to select further options and complete the cloning process.

Clone from backup

Alternatively, you can use the “Upgrade/Clone” button accessible from the database overview or the “Clone database” button from the databases index. This will take you to the “Clone existing database” page, where you can select the “Clone from backup” option.

Clone existing database

Please keep in mind that the new database will have a different connection endpoint, and the origin database will not be deleted. You will need to update your application’s connection settings to your new cloned database and ensure you have deleted the origin database to avoid being charged for a database you no longer need.


As always, we welcome any feedback you might have on this new feature via Twitter @graphenedb, or via contacting us through

Heroku Add-on With Shareable Multiple Installs

In the past, provisioning Neo4j instances with the GrapheneDB Heroku add-on has been limited to one database per application.

Our customers often provided feedback that they wanted to spin up additional database instances to perform tests, do database sharding, or to have different databases for different purposes connected to the same app.

To provision additional databases, customers relied on workarounds such as creating dummy apps, adding environment variables manually to share the GrapheneDB connection URIs across apps. Needless to say this can be an error-prone hassle.

We have heard your feedback, and we are excited to announce that we’ve improved our Heroku add-on by adding support for multiple installs per app, and making them shareable across apps.

Heroku add-on

Below, you can find an example of how to provision a database by specifying the name of the database as well as the app.

$ heroku addons:create graphenedb:chalk --name my-other-graphenedb-db -a my-graphenedb-app
Creating my-other-graphenedb-db... done, (free)
Adding my-other-graphenedb-db to my-graphenedb-app... done
Setting GRAPHENEDB_MAUVE_URL and restarting my-graphenedb-app... done, v4
Your Neo4j database is being deployed. It can take some minutes before it's ready for use.
Use `heroku addons:docs graphenedb` to view documentation.

Please note that to avoid collision of environment variable names, the following logic is applied if a name is not specified:

  • If there is no GrapheneDB database for the specified app, the database will be named graphenedb and the environment variable will be GRAPHENEDB_URL.

  • If there are already other GrapheneDB databases and the graphenedb name is taken, a random color will be appended to the graphenedb name. An example of the resulting environment variable would be GRAPHENEDB_COBALT_URL

An existing GrapheneDB add-on database can be attached to an app using the attach command:

$ heroku addons:attach my-other-graphenedb-db -a other-graphenedb- Attaching my-other-graphenedb-db to other-graphenedb-app... done
Setting GRAPHENEDB_COBALT vars and restarting other-graphenedb-app... done, v6

If the GRAPHENEDB_URL environment variable is not taken, GRAPHENEDB_URL will point to the most recently attached database. Otherwise, a random name will be assigned (as in the example above GRAPHENEDB_COBALT_URL).

You can also specify the desired name when attaching an add-on with the –as parameter:

$ heroku addons:attach my-other-graphenedb-db --app other-graphenedb-app --as GRAPHENEDB_FOO
Attaching my-other-graphenedb-db as GRAPHENEDB_FOO to other-graphenedb-app... done
Setting GRAPHENEDB_FOO vars and restarting other-graphenedb-app... done, v8

We look forward to hearing how you use the new and improved Heroku add-on! Feel free to tweet us about your experiences at @graphenedb on Twitter, or email us at if you have any questions.