Docs Home / Compass / Interact with Your Data / Manage Collections

Create a Time Series Collection

Time series collections efficiently store sequences of measurements over a period of time.

Limitations

The following restrictions and limitations apply when creating a time series collection:

  • Custom collation is the only Advanced Collection Option that you can use with your time series collection.
  • See Time Series Collection Limitations for all time series collection limitations.

Procedure

1

Click the Create Collection button.

From the Collections screen, click the Create Collection button.

2

Enter the collection name.

3

Check the Time Series Collection option.

4

Specify a timeField.

Specify which field should be used as the timeField for the time-series collection. This field must have a BSON type date.

5

Optional. Specify a metaField.

Specify the name of the field that contains metadata in each time series document. The metadata in the specified field should be data that is used to label a unique series of documents.

6

Optional. Select a granularity from the dropdown.

Specify a coarser granularity so measurements over a longer time span can be more efficiently stored and queried. The default value is "seconds".

If you set the granularity parameter, you can't set the bucketMaxSpanSeconds and bucketRoundingSeconds parameters.

7

Optional. Specify a numeric value for the following fields.

FieldTypeDescription
bucketMaxSpanSecondsnumber

Specifies the maximum time span between measurements in a bucket.

The value of bucketMaxSpanSeconds must be the same as bucketRoundingSeconds. If you set the bucketMaxSpanSeconds, parameter, you can't set the granularity parameter.

bucketRoundingSecondsnumber

Specifies the time interval that determines the starting timestamp for a new bucket.

The value of bucketRoundingSeconds must be the same as bucketMaxSpanSeconds. If you set the bucketRoundingSeconds, parameter, you can't set the granularity parameter.

expireAfterSecondsnumberEnables the automatic deletion of documents that are older than the specified number of seconds.
8

Click Create Collection to create the collection.

Your collection will be marked by a time series badge.

For more information on time series fields, see Time Series Object Fields.