{
  "id": "timeseries",
  "title": "Timeseries configuration object",
  "url": "https://redis.io/docs/latest/operate/rs/references/rest-api/objects/bdb/timeseries/",
  "summary": "Configuration object timeseries.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-04-01T08:10:08-05:00",
  "page_type": "content",
  "content_hash": "8d71b89f0620af69857346c22653f7f7fbf9c541974acef8c2a0ad5082fb2596",
  "sections": [
    {
      "id": "content",
      "title": "Content",
      "role": "content",
      "text": "Configuration fields for timeseries.\n\n| Field | Type/Value | Description |\n|-------|------------|-------------|\n| ts-num-threads | integer (range: 1-16) | Number of threads for time series operations. Requires a database restart to take effect. |\n| ts-compaction-policy | string  | Default compaction rules. This default value is applied to each new time series upon its creation |\n| ts-retention-policy | integer (range: 0-9223372036854775807) (default: 0) | Default retention period, in milliseconds. This default value is applied to each new time series upon its creation, but if COMPACTION_POLICY is specified, it is overridden for created compactions as specified in COMPACTION_POLICY. |\n| ts-duplicate-policy | \"BLOCK\"<br />\"FIRST\"<br />\"LAST\"<br />\"MIN\"<br />\"MAX\"<br />\"SUM\"<br />(default: \"BLOCK\") | Default policy for handling insertion of multiple samples with identical timestamps. This default value is applied to each new time series upon its creation. |\n| ts-encoding | \"COMPRESSED\"<br />\"UNCOMPRESSED\"<br />(default: \"COMPRESSED\") | Default chunk encoding for automatically-created compacted time series. This default value is applied to each new compacted time series automatically created due to the creation of a new time series when COMPACTION_POLICY is specified. |\n| ts-chunk-size-bytes | integer (range: 48-1048576) (default: 4096) | Default initial allocation size, in bytes, for the data part of each new chunk. This default value is applied to each new time series upon its creation. |\n| ts-ignore-max-time-diff | integer (range: 0-9223372036854775807) (default: 0) | Default maximum time difference that can be expired to consider a new insertion to be a duplicate. This default value is applied to each new time series upon its creation. |\n| ts-ignore-max-val-diff | number (default: 0) | Default maximum value difference for a new insertion to be considered a duplicate. This default value is applied to each new time series upon its creation. |"
    }
  ],
  "examples": []
}