Using the Honeycomb Atlas Agent | Honeycomb

We use cookies or similar technologies to personalize your online experience & tailor marketing to you. Many of our product features require cookies to function properly.

Read our privacy policy I accept cookies from this site

Using the Honeycomb Atlas Agent

If you are using MongoDB’s Atlas service to host your MongoDB instance(s), you can use the Honeycomb Atlas Agent to poll the Atlas Logs API for log events and submit them to Honeycomb.

To do this, you will need:

  • Go 1.10 or later (to build the binary)
  • The Honeycomb Atlas Agent
  • An Atlas username and API key with ownership permissions on your cluster
  • Your Honeycomb API key


go get

Preparing MongoDB Logging 

Atlas does not currently allow you to set the log verbosity level. To enable logging, you will need to configure profiling on each DB that you are interested in collecting from. To do this, run the following in your Mongo shell:

dbnames = db.getMongo().getDBNames()
for (var k in dbnames) 
      adb = db.getMongo().getDB(dbnames[k]);
      adb.setProfilingLevel(2, -1); 

Atlas Permissions 

Your user will need ownership permissions on the cluster to pull the logs. See Atlas Logs API for more information.

Running the Atlas Integration 

# Your Atlas API Key, configured at:
# Your Atlas Username
# This is the Atlas Group ID/Project ID
# You can find this in your Atlas "Project Settings" page
# Your Honeycomb API Key
# Target Honeycomb Dataset
atlas \
  --api_key=${API_KEY} \
  --username=${USERNAME} \
  --group_id=${GROUP_ID} \
  --cluster=Cluster0 \
  --writekey=${API_KEY} \

You can specify more clusters by providing the --cluster parameter multiple times.


Atlas runs well inside Kubernetes. You can modify our example spec file with the required arguments (USERNAME, API_KEY, WRITE_KEY) and install with kubectl apply:

kubectl apply -f kubernetes/atlas.example.yml


If you have a problem or question, or would just like to leave feedback, please open a Github issue on our Atlas repository.

Did you find what you were looking for?