summaryrefslogtreecommitdiffstats
path: root/exporting/mongodb/README.md
blob: b10d547164b54f4a1b8d5c8138d3454b26d8ccfa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<!--
title: "Export metrics to MongoDB"
description: "Archive your Agent's metrics to a MongoDB database for long-term storage, further analysis, or correlation with data from other sources."
custom_edit_url: https://github.com/netdata/netdata/edit/master/exporting/mongodb/README.md
sidebar_label: MongoDB
-->

# Export metrics to MongoDB

You can use the MongoDB connector for the [exporting engine](/exporting/README.md) to archive your agent's metrics to a
MongoDB database for long-term storage, further analysis, or correlation with data from other sources.

## Prerequisites

To use MongoDB as an external storage for long-term archiving, you should first
[install](http://mongoc.org/libmongoc/current/installing.html) `libmongoc` 1.7.0 or higher. Next, re-install Netdata
from the source, which detects that the required library is now available.

## Configuration

To enable data exporting to a MongoDB database, run `./edit-config exporting.conf` in the Netdata configuration
directory and set the following options:

```conf
[mongodb:my_instance]
    enabled = yes
    destination = mongodb://<hostname>
    database = your_database_name
    collection = your_collection_name
```

You can find more information about the `destination` string URI format in the MongoDB
[documentation](https://docs.mongodb.com/manual/reference/connection-string/)

The default socket timeout depends on the exporting connector update interval. The timeout is 500 ms shorter than the
interval (but not less than 1000 ms). You can alter the timeout using the `sockettimeoutms` MongoDB URI option.