Jump to the search bar

Press / to jump to the search bar.

Jump to the query bar

Press ctrl + / to jump to the query bar.

Jump to a specific collection

Press ⌘ + J to open the collection selector.

By default, tools and GUIs such as Humongous cannot directly access a DocumentDB cluster from outside of its VPC. This is a security measure put in place by AWS to prevent DocumentDB customers from accidentally exposing their database.

In order to connect Humongous to your DocumentDB cluster, you need to create a proxy that will act as a bridge between your cluster and the outside world.

Don't get discouraged at the sight of the word proxy. The end-to-end process is very simple and will take us less than 15min.

This is what the end-to-end diagram looks like.

Identifying your cluster's VPC ID

Your DocumentDB cluster and the proxy need to be in the same VPC, so let's start by identifying your cluster's VPC ID.

Head to your cluster's home page and look at the Connectivity & security tab. Your VPC ID should be at the bottom of the screen, in the Security Groups section.

Create the EC2 proxy

Once you have identified your VPC ID, you need to create an EC2 instance within that VPC.

Go to the EC2 instances page, and click on Launch Instances to bring up the EC2 instance creation form.

Enter the name of your EC2 instance (e.g. Humongous Proxy) in the Name field, then select Amazon Linux as the OS image, and t2.micro for the instance type.

Next, you need to create a new Key pair to establish an SSH tunnel between Humongous and your cluster. Click on Create new key pair. Leave the Key pair type as RSA, the format as .pem, choose a name for your new key (e.g. humongous_keypair), and save. Your new key will be automatically downloaded. Make sure to keep it somewhere safe.

In the Network settings section, make sure that Allow SSH traffic is checked, and set the IP address to 52.5.26.69.

Click on Launch instance and wait for your instance to become available.

Connect your cluster to Humongous

At this point, we have everything we need to connect to Humongous. Let's go to the project creation page and click on Add new database.

Copy your Connection string from your cluster's home page, and paste it inside the Connection string field in Humongous. Don't forget to replace <insertYourPassword> with your cluster's password.

Next, click on Advanced and go to the TLS/SSL tab.

Download https://s3.amazonaws.com/rds-downloads/rds-combined-ca-bundle.pem and upload it to the Certificate Authority field on Humongous.

Finally, go to SSH tab and check Connect with SSH tunneling checkbox. Then, in the Hostname field, enter the public IP of the EC2 instance we created earlier, and enter ec2-user in the username field. Leave Auth Mode as Private Key and upload the Key pair we created earlier in the Private key field.

Click on Add database and that's it ✨!!

If you have more than a few projects with a dozen collections each, navigating to your most frequent collections can become quickly overwhelming. That's why we've created Favorites.

Favorites is a way to bookmark your favorite dashboards and collections for quick access.

Once you navigate to a collection or a dashboard, you should see a star icon at the right of the search bar. Click it to add it to your favorite collections.

Once this is done, access it through the Favorites section in the left menu.

If you want to remove a collection from your favorites, navigate to it. The star icon in the search bar should have a solid color. Click on it, and your collection will be removed from your Favorites.

You can update your basic information and preferences (Full name, notification preferences, dark mode...) by going to your profile settings.

Finding documents quickly and efficiently is core to every successful business, that's why we've invested a lot to create a great search experience on Humongous.io.

You can write search queries using the MongoDB Query Language or our Keyword Search Engine.

Keyword Search Engine

The Keyword Search Engine infers queries based on the keywords you enter in the search bar.

This means that for example you can search your users by just typing their email addresses in the Search bar. bart@simpson.com will return the user matching that email address. Searching @apple.com will return all users with an apple.com email address.

Similarly, typing a8641ae2e2181300d4790e3b will return any field that has this ObjectId as value.

MongoDB Query Language

You can directly use MongoDB Query Language in the search bar. The full documentation is available on the MongoDB website.

We've also added some useful helpers to help you work with dates. The following can be used in lieu of actual date values.

• $date_today
• $date_yesterday
• $date_tomorrow
• $date_10_minutes_ago
• $date_9_hours_from_now
• $date_8_days_ago
• $date_4_weeks_ago
• $date_3_months_from_now
• $date_1_year_ago

MongoDB Query Examples

Humongous offers the ability to seamlessly export your MongoDB collections into CSV or JSON files.

To get started, head to the collection you'd like to export. Click on the More button in the collection toolbar and then click on Export.

Once the export window pops up, pick a file format (CSV or JSON) and select the fields you'd like to include into the exported file.

Once you click on Export, you'll receive an email with a link pointing to your exported file right after it's been processed.

To get started with Humongous, you need to add at least one MongoDB database.

First, let's collect all the connection information necessary to connect to your database.

We will need:

• The hostname or IP address of your database
• The port number. The default port number on MongoDB is 27017.
• The database name.
• Most databases are protected against unwanted access by an authentication mechanism. Generally, it would be by providing a username and a password.

Most cloud providers will provide your connection information as a connection string, but depending on your provider, the steps to get it will be vary.

A connection string looks like this :

Given this test connection information :

Our connection string will look like the following:

Now that we know what a connection string looks like, let's head to your database's cloud provider to fetch your connection string.

Select from the list below your database provider.

• MongoDB Atlas
• Microsoft CosmosDB
• MongoDB DocumentDB

The first step is to head over to your Azure Cosmos DB portal and select your database.

In the left pane of the database page, click the Connection String button.

Your database connection information should be displayed now. Copy the content under PRIMARY CONNECTION STRING. It should look like this:

Now that we have everything we need to get started, let's head over to Humongous project creation page.

Paste the connection string you copied previously into the form field and click on the Create button.

That's it 👏! HumongouS.io will import your database and autmatically create your views, forms and dashboards. Relax 😌 and enjoy.

Every once in a while, you'll need to update your database's basic information because the default name doesn't suit you anymore or because your connection information has changed.

To update your database infomation go to the databases page hover over your project's name, and click on the edit icon to open the database update window.

While collection views allow you to see and interact with documents at the individual level, sometimes, it's beneficial to observe data in an aggregated way to see trends and to get useful insights.

Humongous Charts allows you to leverage the full potential of your database to create useful charts. It gives you the comfort of a nice UI to interactively build your charts as well as the flexibility to switch to a fully fledged editor to write custom queries.

There are currently five types of Charts. In this tutorial, we'll show you how to use each one of them using both the interactive Query Builder and the Raw Query Editor.

Humongous offers the ability to easily import data into your MongoDB collections from CSV and JSON files.

First, head over to the collection in which you would like to import your data.

Once you are on the collection page, click on the More button in the collection toolbar and click on Import.

Once the import window opens, choose the CSV or JSON file containing the data you would like to import.

JSON files must be in the JSON array format. Otherwise only one document will be imported.

If you want to replace existing data in your collection, toggle the Replace existing data switch, or the new data will be appended to your collection.

Finally, click on the Import button to import your data.

Finding documents quickly and efficiently is core to every successful business, that's why we've invested a lot to create a great search experience on Humongous.io.

You can write search queries using the MongoDB Query Language or our Keyword Search Engine.

Keyword Search Engine

The Keyword Search Engine infers queries based on the keywords you enter in the search bar.

This means that for example you can search your users by just typing their email addresses in the Search bar. bart@simpson.com will return the user matching that email address. Searching @apple.com will return all users with an apple.com email address.

Similarly, typing a8641ae2e2181300d4790e3b will return any field that has this ObjectId as value.

MongoDB Query Language

You can directly use MongoDB Query Language in the search bar. The full documentation is available on the MongoDB website.

We've also added some useful helpers to help you work with dates. The following can be used in lieu of actual date values.

• $date_today
• $date_yesterday
• $date_tomorrow
• $date_10_minutes_ago
• $date_9_hours_from_now
• $date_8_days_ago
• $date_4_weeks_ago
• $date_3_months_from_now
• $date_1_year_ago

MongoDB Query Examples

If you don't see the Billing option when following the steps below, you probably do not have the ability to view or modify your team's plan and billing information. Contact your administrator to grant you the privilege.

Update your Plan, Card or Billing Address

In order to update your Plan, Card or Billing Address, head over to your team's settings, and click on Billing. Once the window opens, you will be given the option to update all your billing information as well as your plan.

Get your subscriptions invoices

You can fetch your subscriptions invoices for accounting and tax purposes by going to the Billing section of your team's settings as described above and clicking on the month's invoice you're interested in downloading.

By default, tools and GUIs such as Humongous cannot directly access a DocumentDB cluster from outside of its VPC. This is a security measure put in place by AWS to prevent DocumentDB customers from accidentally exposing their database.

In order to connect Humongous to your DocumentDB cluster, you need to create a proxy that will act as a bridge between your cluster and the outside world.

Don't get discouraged at the sight of the word proxy. The end-to-end process is very simple and will take us less than 15min.

This is what the end-to-end diagram looks like.

Identifying your cluster's VPC ID

Your DocumentDB cluster and the proxy need to be in the same VPC, so let's start by identifying your cluster's VPC ID.

Head to your cluster's home page and look at the Connectivity & security tab. Your VPC ID should be at the bottom of the screen, in the Security Groups section.

Create the EC2 proxy

Once you have identified your VPC ID, you need to create an EC2 instance within that VPC.

Go to the EC2 instances page, and click on Launch Instances to bring up the EC2 instance creation form.

Enter the name of your EC2 instance (e.g. Humongous Proxy) in the Name field, then select Amazon Linux as the OS image, and t2.micro for the instance type.

Next, you need to create a new Key pair to establish an SSH tunnel between Humongous and your cluster. Click on Create new key pair. Leave the Key pair type as RSA, the format as .pem, choose a name for your new key (e.g. humongous_keypair), and save. Your new key will be automatically downloaded. Make sure to keep it somewhere safe.

In the Network settings section, make sure that Allow SSH traffic is checked, and set the IP address to 52.5.26.69.

Click on Launch instance and wait for your instance to become available.

Connect your cluster to Humongous

At this point, we have everything we need to connect to Humongous. Let's go to the project creation page and click on Add new database.

Copy your Connection string from your cluster's home page, and paste it inside the Connection string field in Humongous. Don't forget to replace <insertYourPassword> with your cluster's password.

Next, click on Advanced and go to the TLS/SSL tab.

Download https://s3.amazonaws.com/rds-downloads/rds-combined-ca-bundle.pem and upload it to the Certificate Authority field on Humongous.

Finally, go to SSH tab and check Connect with SSH tunneling checkbox. Then, in the Hostname field, enter the public IP of the EC2 instance we created earlier, and enter ec2-user in the username field. Leave Auth Mode as Private Key and upload the Key pair we created earlier in the Private key field.

Click on Add database and that's it ✨!!

This documentation is divided into multiple thematic sections outlined in the menu on your left. You can read it in any order you want, but I particularly encourage you to check out the following pages:

• If you don't have a project yet, the Project creation tutorial is a must. It will show you how to connect your databases to Humongous.io using platforms like MongoDB Atlas, Microsoft CosmosDB, or AWS DocumentDB.
• Regardless of your MongoDB query chops, the Search documentation will show you how to be more effective at finding what you need, using convenient date functions, keyword searches, or keyboard shortcuts.

Humongous is full of pleasant surprises, and I'm sure you'll be delighted 🥳, but if you want to talk to us, have feedback, or need a feature, shoot me (mkamagate@humongous.io) or Ari (axhelo@humongous.io) an email. We respond to all emails 👌.

The signed-in experience of this documentation is so much better! If you don't have an account yet, You can create one now.

Humongous offers the ability to easily import data into your MongoDB collections from CSV and JSON files.

First, head over to the collection in which you would like to import your data.

Once you are on the collection page, click on the More button in the collection toolbar and click on Import.

Once the import window opens, choose the CSV or JSON file containing the data you would like to import.

JSON files must be in the JSON array format. Otherwise only one document will be imported.

If you want to replace existing data in your collection, toggle the Replace existing data switch, or the new data will be appended to your collection.

Finally, click on the Import button to import your data.

Look for your database name on the main page of Atlas and click on the green CONNECT button. You should see a connection window pop up.

If this is your first time accessing the database, it will ask you to create a username and a password. Do so and keep that information handy. We'll need it at a later stage.

It will also ask you on the same page to "Add your current IP address". Click on the button and add 52.5.26.69 as our server's IP address.

Allowing 52.5.26.69 to talk to your database is necessary as HumongouS.io wouldn't be able to connect to your database otherwise.

Once that's done, click on "Choose a connection method" to go to the next page, and then click on "Connect your application".

Select "Short SRV connection string" and copy the SRV connection string.

Your connection string will look like the following:

Replace <PASSWORD> by the password you created earlier in the process, copy and paste your connection string into the project creation form in the app and click on Create project.

To get started with Humongous, you need to add at least one MongoDB database.

First, let's collect all the connection information necessary to connect to your database.

We will need:

• The hostname or IP address of your database
• The port number. The default port number on MongoDB is 27017.
• The database name.
• Most databases are protected against unwanted access by an authentication mechanism. Generally, it would be by providing a username and a password.

Most cloud providers will provide your connection information as a connection string, but depending on your provider, the steps to get it will be vary.

A connection string looks like this :

Given this test connection information :

Our connection string will look like the following:

Now that we know what a connection string looks like, let's head to your database's cloud provider to fetch your connection string.

Select from the list below your database provider.

• MongoDB Atlas
• Microsoft CosmosDB
• MongoDB DocumentDB

The first step is to head over to your Azure Cosmos DB portal and select your database.

In the left pane of the database page, click the Connection String button.

Your database connection information should be displayed now. Copy the content under PRIMARY CONNECTION STRING. It should look like this:

Now that we have everything we need to get started, let's head over to Humongous project creation page.

Paste the connection string you copied previously into the form field and click on the Create button.

That's it 👏! HumongouS.io will import your database and autmatically create your views, forms and dashboards. Relax 😌 and enjoy.

Deleting a collection in Humongous is a safe operation. We don't delete your actual collection. We only remove the view created in HumongouS.io, so you can re-add the collection later if you need to.

To delete a collection, click on the collection's name in the left menu, and click on the Settings button to open the collection settings.

If you are the owner or have the permission to delete the collection, you should see the Delete collection button at the bottom left corner of the pop-up.

Click on it to delete your collection.

Deleting a project in HumongouS.io is a safe operation with regard to your actual database. When you delete a project, we only remove the metadata (connection information, collection configurations...) we've saved on our end about your database.

To delete a project, click on the ellipsis icon at the right of the project name and then click on Update project.

A new window will pop up. If you are the owner or have the permission to delete the project, you should see the Remove database button at the bottom left corner.

Click on it to remove your database.

Every once in a while, you'll need to update your database's basic information because the default name doesn't suit you anymore or because your connection information has changed.

To update your database infomation go to the databases page hover over your project's name, and click on the edit icon to open the database update window.

Humongous offers the ability to seamlessly export your MongoDB collections into CSV or JSON files.

To get started, head to the collection you'd like to export. Click on the More button in the collection toolbar and then click on Export.

Once the export window pops up, pick a file format (CSV or JSON) and select the fields you'd like to include into the exported file.

Once you click on Export, you'll receive an email with a link pointing to your exported file right after it's been processed.

Every account comes with a default Dashboard. When you create your very first project, we run a machine learning model on your collections to auto-magically create a few useful charts for you, but for the sake of this tutorial we'll start from scratch and create a new dashboard.

In the left menu, Click on the "plus" icon that appear next to the dashboard label. It'll prompt you to create a new dashboard.

Fill up the name field and click on save.

That's it! We've created our first dashboard. It doesn't do anything yet so let's make it more interesting by adding some charts to it.

This documentation is divided into multiple thematic sections outlined in the menu on your left. You can read it in any order you want, but I particularly encourage you to check out the following pages:

• If you don't have a project yet, the Project creation tutorial is a must. It will show you how to connect your databases to Humongous.io using platforms like MongoDB Atlas, Microsoft CosmosDB, or AWS DocumentDB.
• Regardless of your MongoDB query chops, the Search documentation will show you how to be more effective at finding what you need, using convenient date functions, keyword searches, or keyboard shortcuts.

Humongous is full of pleasant surprises, and I'm sure you'll be delighted 🥳, but if you want to talk to us, have feedback, or need a feature, shoot me (mkamagate@humongous.io) or Ari (axhelo@humongous.io) an email. We respond to all emails 👌.

The signed-in experience of this documentation is so much better! If you don't have an account yet, You can create one now.

Look for your database name on the main page of Atlas and click on the green CONNECT button. You should see a connection window pop up.

If this is your first time accessing the database, it will ask you to create a username and a password. Do so and keep that information handy. We'll need it at a later stage.

It will also ask you on the same page to "Add your current IP address". Click on the button and add 52.5.26.69 as our server's IP address.

Allowing 52.5.26.69 to talk to your database is necessary as HumongouS.io wouldn't be able to connect to your database otherwise.

Once that's done, click on "Choose a connection method" to go to the next page, and then click on "Connect your application".

Select "Short SRV connection string" and copy the SRV connection string.

Your connection string will look like the following:

Replace <PASSWORD> by the password you created earlier in the process, copy and paste your connection string into the project creation form in the app and click on Create project.

Deleting a project in HumongouS.io is a safe operation with regard to your actual database. When you delete a project, we only remove the metadata (connection information, collection configurations...) we've saved on our end about your database.

To delete a project, click on the ellipsis icon at the right of the project name and then click on Update project.

A new window will pop up. If you are the owner or have the permission to delete the project, you should see the Remove database button at the bottom left corner.

Click on it to remove your database.

There are two ways to create Charts:

• Query Builder lets you create simple queries using an automated tool.
• Raw Query Editor on the other hand gives you total control over what queries you want to run.

In the following section of this documentation, we'll create a few charts based on the data below in using both the Query Builder and the Raw Query Editor.

If you have more than a few projects with a dozen collections each, navigating to your most frequent collections can become quickly overwhelming. That's why we've created Favorites.

Favorites is a way to bookmark your favorite dashboards and collections for quick access.

Once you navigate to a collection or a dashboard, you should see a star icon at the right of the search bar. Click it to add it to your favorite collections.

Once this is done, access it through the Favorites section in the left menu.

If you want to remove a collection from your favorites, navigate to it. The star icon in the search bar should have a solid color. Click on it, and your collection will be removed from your Favorites.